AGENTIC 是部署在 EdgeOne Cloud Functions 上的统一代理网关。以下是支持的规范接口、鉴权规则与代码示例。
发往网关的所有 HTTP 请求必须携带网关密钥（环境变量 AGENTIC_GATEWAY_SECRET）。 网关支持以下两种 Header 格式：
Authorization: Bearer $AGENTIC_GATEWAY_SECRETx-api-key: $AGENTIC_GATEWAY_SECRET规范路径位于 /v1/*，同时保留 /api/v1/* 别名，两者同等高效且无重定向。
最新 Responses API 规范，拥有独立状态机出站逻辑（response.created → output_item.added → *.delta → response.completed）。支持文本、自定义工具（Custom Tools）与思维链呈现。
经典 Chat Completions 协议兼容。严格控制输出 Schema 白名单，自动提取上游 reasoning 标记并聚拢到 usage.completion_tokens_details.reasoning_tokens。
面向 Claude CLI / SDK 的 Anthropic 原生透传接口。保持字节级流式保活转发，上游认证基于 AGENTIC_BUDDY_MESSAGES_TOKEN。
请求参数中的 model 支持带前缀的完全限定 ID 或简化别名：
| 前缀规则 | 使用示例 (model) | 目标 Provider | 特性说明 |
|---|---|---|---|
| @google/* | @google/gemini-3.6-flash | Google Cloud Code (v1internal) | 使用 Google OAuth2 的私有通道，原汁原味透传 Gemini 3.6 Flash / 3 Flash 等顶级模型，支持 thoughtSignature 智能打标。 |
| @codebuddy/* | @codebuddy/hy3 | CodeBuddy /v2/chat/completions | 支持 hy3、deepseek-v4-pro、glm-5.2 等模型，具备自动 Tool Choice 降级与轮次调度机制。裸 'gpt-*' 或 'hy3' 别名会自动关联该 Provider。 |
| @xai/* | @xai/grok-4.5 | xAI /v1/responses | 透传上游官方 Responses 接口，包含 grok-4.5 与 composer-2.5 模型，原生保留 reasoning_effort 参数。 |
| @deepseek/* | @deepseek/deepseek-chat | DeepSeek Chat API | 标准 OpenAI Chat 协议转发，支持极低延迟的高并发长文本输出。 |
客户端可通过传递 reasoning_effort 精准干预模型的思维链深度：
关闭思维链思考，获得极速响应与最低 Token 开销。
限制思考步数，适合轻量级文本摘要与快速问答。
平衡推理深度与吞吐速度 (Gemini 3 Flash 默认档位)。
开启深度推导与算法演算，适合复杂 Bug 修复、数学推导与架构设计。
由上游模型根据提示词难度自主决定 Thinking Budget。
from openai import OpenAI
client = OpenAI(
base_url="https://your-agentic-gateway.com/v1",
api_key="your-gateway-secret"
)
response = client.responses.create(
model="@google/gemini-3.6-flash",
input="用三句话总结量子计算的基础原理。",
reasoning_effort="high"
)
print(response.output_text)import OpenAI from 'openai';
const openai = new OpenAI({
baseURL: 'https://your-agentic-gateway.com/v1',
apiKey: 'your-gateway-secret',
});
async function main() {
const completion = await openai.chat.completions.create({
model: '@codebuddy/hy3',
messages: [{ role: 'user', content: '你好，AGENTIC 网关！' }],
stream: true,
});
for await (const chunk of completion) {
process.stdout.write(chunk.choices[0]?.delta?.content || '');
}
}
main();