AgentKit
AgentKit
AgentKit
文档指南
请输入
AgentKit
产品动态
产品计费
快速入门
用户指南
智能体运行时
沙箱模板
沙箱模板管理
在 Agent 中集成沙箱模板
Skills Sandbox 沙箱模板
技能
A2A 中心
会话与记忆管理
知识库
网关
MCP 接入
身份与权限
快速入门
观测
开发者指南
API 参考
Runtime
Tool
Skill
A2A
SessionStore
Memory
Knowledge
MCP
ChatKit 参考
DeliveryAI
产品动态
产品计费
开始使用
步骤一：企业管理员-开通并配置服务
- 文档首页
AgentKitAgentKit用户指南网关模型接入调用模型服务
复制全文
下载 pdf调用模型服务
文档反馈
问问助手模型服务为供应商模型和模型组提供统一的调用示例。您可以在模型服务详情页选择调用目标和已获授权的 Proxy API Key，并复制 AgentKit Runtime、OpenAI SDK（Python）或 cURL 示例，以便快速接入应用。
前提条件
- 已创建模型服务，并完成供应商模型或模型组的配置。操作详见 创建模型服务。
- 已创建 Proxy API Key，并将调用目标授权给该 Key。操作详见 管理 Proxy API Key。
- 如需调用模型组，请先完成模型组创建和授权。操作详见 创建和管理模型组。
操作步骤
- 登录 AgentKit 控制台。
- 在左侧导航树中选择“网关 > 模型接入”，进入目标模型服务。
- 单击“基本信息”页签，在“调用示例”区域选择调用方式。
- 供应商模型：选择模型供应商、已获授权的 Proxy API Key 和具体模型。
- 模型组：选择已获授权的 Proxy API Key 和模型组调用名称。应用请求中的 model 字段填写模型组调用名称，网关将按模型组配置选择组内上游模型。
-
- 按需选择代码示例类型，并单击“复制代码”。
- 示例类型适用场景示例类型适用场景AgentKit Runtime在 AgentKit Runtime 中调用模型。示例包含模型服务地址、Proxy API Key 和模型名称对应的环境变量。OpenAI SDK（Python）使用 OpenAI 兼容 SDK 的 Python 应用。cURL快速验证连通性，或在不使用 SDK 的场景中调用模型。
-
调用示例
以下为调用模型服务的通用示例，仅供参考，实际调用时建议直接从控制台获取调用示例。
AgentKit Runtime
OpenAI SDK（Python）
cURL
适用于 AgentKit Runtime 的调用示例如下：
export MODEL_AGENT_API_BASE=<模型服务_BASE_URL>
export MODEL_AGENT_API_KEY=<Proxy_API_Key>
export MODEL_AGENT_NAME=<模型_ID_或模型组调用名称>
适用于 OpenAI SDK（Python） 的调用示例如下：
from openai import OpenAI
client = OpenAI(
base_url="<模型服务_BASE_URL>/v1",
api_key="<Proxy_API_Key>",
)
response = client.chat.completions.create(
model="<模型_ID_或模型组调用名称>",
messages=[{"role": "user", "content": "你好，请介绍一下自己。"}],
)
print(response.choices[0].message.content)
适用于 cURL 的调用示例如下：
curl "<模型服务_BASE_URL>/v1/chat/completions" -H "Authorization: Bearer <Proxy_API_Key>" -H "Content-Type: application/json" -d '{
"model": "<模型_ID_或模型组调用名称>",
"messages": [
{"role": "user", "content": "你好，请介绍一下自己。"}
]
}'
参数说明
参数 | 说明 |
参数 | 说明 |
MODEL_AGENT_API_BASE | 模型服务的统一 Base URL，调用时不需要拼接供应商的访问路径。 |
MODEL_AGENT_API_KEY | Proxy API Key 的密钥值，用于调用模型服务。请注意，该密钥不是供应商 API Key。 |
MODEL_AGENT_NAME | 调用目标的名称。
|
model | 使用 OpenAI SDK 或 cURL 调用时传入的模型名称，与MODEL_AGENT_NAME的填写规则一致。 |
注意
- Proxy API Key 属于敏感凭据。请通过环境变量、密钥管理服务或安全的配置中心注入，避免将其写入代码仓库、日志、工单或公开文档。若怀疑 Key 已泄露，请立即在“Proxy API Key 管理”页签停用或删除该 Key。
- 调用时使用模型服务的统一地址和 Proxy API Key。请求地址不携带供应商路径，model 填写模型组的调用名称，网关据此完成授权校验，并按权重选择上游模型。
最近更新时间：2026.10.29 11:43:28
这个页面对您有帮助吗？
有用
有用
无用
无用