文档中心

AgentKit

模型接入

在 Agent 中集成模型信息

本文以 VeADK 构建的 Agent 为例，为您介绍如何在 Agent 代码中集成模型服务中接入的模型。

前提条件

操作步骤

步骤一：在模型服务控制台获取调用示例

选择目标模型供应商、Proxy API Key 和模型后，在“AgentKit Runtime”页签下复制系统生成的代码，包含模型供应商 Base URL、API Key 和模型名称。

说明

系统会自动生成示例代码，本文以在 AgentKit 运行环境中调用模型为例介绍，所以使用 AgentKit Runtime 示例；如果您需要在自有应用中快速接入，可选择 OpenAI SDK (Python) 或 cURL 示例。

AgentKit Runtime：适用于在 AgentKit 框架内直接调用模型，代码中包含 MODEL_AGENT_API_BASE（模型服务的 Base URL）、MODEL_AGENT_API_KEY（Proxy API Key 对应的密钥值）和 MODEL_AGENT_NAME（模型标识符），将这三个环境变量配置到 Agent 运行环境后即可完成接入。

在火山引擎访问控制控制台“API 访问密钥”下，单击“创建 Access Key”按钮创建 Access Key，创建成功后复制 Access Key ID（AK）和 Secret Access Key（SK）信息。

步骤二：将环境变量写入本地项目

说明

MODEL_AGENT_API_KEY属于鉴权凭据，不建议写入.env静态文件，本文会配置在环境变量中。

# 平台的 AK 和 SK。
export VOLCENGINE_ACCESS_KEY=<your_access_key>
export VOLCENGINE_SECRET_KEY=<your_secret_key>

执行vim .env打开项目根目录下的 .env 文件，在键盘上按i键进入编辑模式，添加如下变量（变量来源于模型服务示例代码），按esc键退出编辑模式，输入:wq保存并退出文件。

# 模型服务配置
MODEL_AGENT_API_BASE=<base_url>
MODEL_AGENT_NAME=<model_name>
MODEL_AGENT_API_KEY=<model_api_key>

参数	来源
<base_url>	模型服务示例代码中的获取的模型供应商 Base URL，不包含/chat/completions，请勿使用 MODEL_ENDPOINT。
<model_name>	模型服务示例代码中的获取的模型名称，本文演示配置的模型名称为：deepseek-v4-pro-ga-260813。
<model_api_key>	模型服务示例代码中的获取的 API Key。说明此 API Key 是网关实例代理的 Key，不是您配置的真实上游模型供应商 API Key，真实上游模型供应商 API Key 仅在模型网关中托管，不会展示给 Agent。

步骤三：本地调试验证

说明

本文操作前提条件已明确在 VeADK 构建了 Agent，因此可以直接执行veadk web命令启动 VeADK Web 界面，若您还未完成 Agent 构建，直接执行此命令无法启动，请先参考使用 VeADK 开发并部署智能体。

验证二：执行vim .env打开项目根目录下的 .env 文件，在键盘上按i键进入编辑模式，在MODEL_AGENT_API_KEY=<model_api_key>配置前添加# 注释掉此部分信息。

步骤四：发布智能体运行时

在运行 VeADK 终端窗口，按键盘 Ctrl + C，终止进程，然后执行命令agentkit launch将本地配置推送到 AgentKit 平台智能体运行时中。

最近更新时间：2026.08.21 18:33:17

这个页面对您有帮助吗？

有用

无用