AgentKit 模型网关上手指南｜告别多模型管理混乱

企业在使用 Agent 时，大模型管理是最为关键的环节之一。从 "能调通模型" 到 "能稳定、可控地用好模型"，中间隔着接入入口、访问凭证、权限控制和成本管理几道坎。

火山引擎 AgentKit 是面向企业的 AI Agent 基础设施平台，提供 Agent 所需的运行时、身份权限、工具、记忆、知识和观测等能力。其中 AgentKit 模型网关把模型接入、密钥托管、故障兜底和用量观测收到一个入口，业务侧只要指向网关、换掉密钥即可接入。

本文以 DeepSeek Harness 为例，完成从配置到验证的全流程实战。

01前期准备

（1）开通 AgentKit 服务 若未开通，请登录 AgentKit 控制台：console.volcengine.com/AgentKit，根据...

（2）模型准备 本期内容以火山方舟模型广场为例，需在平台获取 Base URL、API Key、模型 ID，详细步骤见：ark.volcengine.com/region:cn-b...

（3）私有网络

创建私有网络，为保持高可用性，至少创建 2 个子网，详细步骤见：docs.volcengine.com/docs/6401/6...

至少创建 2 个子网

（4）日志服务

创建日志项目，这里以"agentkitgateway"为例，详细步骤见：docs.volcengine.com/docs/6470/1...

以"agentkitgateway"为例

02创建网关实例

在【AgentKit - 网关 - 网关实例】页面（直达链接：console.volcengine.com/agentkit/re...

选择【模型网关】，在【网络设置】中选择此前准备好的【私有网络】和【子网】，在【日志项目】中选择前期准备好的 agentkitgateway 日志项目，点击【立即购买】即可完成实例创建。

03创建模型网关

在【AgentKit - 网关 - 模型服务】中点击【创建模型服务】，选择对应的网关实例。

点击【创建模型服务】

选择【网关实例】

配置模型资源

以【火山方舟 - 模型广场】为例，填写以下信息：

点击【模型配置】-【添加】

针对不同模型 Token 限额

点击确认，完成模型网关配置。

04创建 Proxy API Key

在【AgentKit - 模型服务 - 供应商与模型管理】中获取网关地址，作为后续调用的 Base URL。

在【AgentKit - 模型服务 - Proxy API Key 管理】中创建 Proxy API Key，作为业务侧实际使用的 API Key，保障原始 API Key 不泄露。

填写【输入名称】：这里以 Gatewaymodeltest 为例。
设置【自定义范围】：可针对模型配置速率限制及每日 / 每周 / 每月额度，控制模型使用量与成本。
点击【确认】：Proxy API Key 完成创建，查看 Proxy Key。

在【模型服务 - 调用示例】中可查看 AgentKit Runtime、OpenAI SDK（Python）、cURL 等多种调用方式示例。

AgentKit Runtime 调用示例

OpenAI SDK（Python）调用示例

cURL 调用示例

05调用示例

（1）以 cURL 为例

复制以下代码到终端，替换网关地址和 Proxy Key 后即可成功调用：

lua 复制代码

curl "你的网关地址url" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer 你的Proxykey" \
  --data '{
  "model": "doubao-seed-2-1-pro-260915",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下自己。"
    }
  ]
}'