本文以 [VeADK](https://volcengine.github.io/veadk-python/cn/docs/framework/) 构建的 Agent 为例，为您介绍如何在 Agent 代码中集成模型服务中接入的模型。 ## 前提条件 * 已安装 Python，且版本不低于3.10。 * 已创建模型服务并接入模型，操作详情参见[创建模型服务](https://docs.volcengine.com/docs/86681/2650648)。 * 已在 [VeADK](https://volcengine.github.io/veadk-python/cn/docs/framework/) 构建了 Agent，详细操作请参见[使用 VeADK 开发并部署智能体](https://docs.volcengine.com/docs/86681/2155817?lang=zh)。 ## 操作步骤 ### **步骤一：在模型服务控制台获取调用示例** 1. 登录[AgentKit控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中选择“网关 \> 模型服务”，单击“基本信息”页签。 3. 选择目标模型供应商、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 运行环境后即可完成接入。 * **OpenAI SDK (Python)** ：适用于使用 OpenAI 兼容协议接入的场景，直接复制代码示例即可使用。 * **cURL**：适用于快速测试或非 SDK 场景，通过命令行直接发起调用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7c97cba8a44db8037f6947b7daf740c3.png) 4. 在火山引擎[访问控制控制台](https://console.volcengine.com/iam/keymanage)“API 访问密钥”下，单击“创建 Access Key”按钮创建 Access Key，创建成功后复制 Access Key ID（AK）和 Secret Access Key（SK）信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eabeff4e69d3971609b0009217308b55.png) ### **步骤二：将环境变量写入本地项目** 1. 本地打开终端窗口，执行如下命令重新激活虚拟环境。 ```Bash source .venv/bin/activate ``` 2. 执行如下命令进入您的 Agent 项目根目录。 ```Bash cd <项目根目录> ``` 3. 分别执行如下命令，配置环境变量。

说明

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

```Bash # 平台的 AK 和 SK。 export VOLCENGINE_ACCESS_KEY= export VOLCENGINE_SECRET_KEY= ``` |参数 |来源 | |---|---| | |平台的 Access Key ID（AK）的信息。 | | |平台的 Secret Access Key（SK）的信息。 | 4. 执行`vim .env`打开项目根目录下的 .env 文件，在键盘上按`i`键进入编辑模式，添加如下变量（变量来源于模型服务示例代码），按`esc`键退出编辑模式，输入`:wq`保存并退出文件。 ```Bash # 模型服务配置 MODEL_AGENT_API_BASE= MODEL_AGENT_NAME= MODEL_AGENT_API_KEY= ``` |参数 |来源 | |---|---| | |模型服务示例代码中的获取的模型供应商 Base URL，不包含`/chat/completions`，请勿使用 MODEL_ENDPOINT。 | | |模型服务示例代码中的获取的模型名称，本文演示配置的模型名称为：deepseek\-v4\-pro\-ga\-260813。 | | |模型服务示例代码中的获取的 API Key。

说明

此 API Key 是网关实例代理的 Key，不是您配置的真实上游模型供应商 API Key，真实上游模型供应商 API Key 仅在模型网关中托管，不会展示给 Agent。

| ### **步骤三：本地调试验证** 1. 继续在终端窗口执行`veadk web`命令，启动 VeADK Web 界面。

说明

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

2. 验证模型生效情况。 * **验证一**：在您的项目所在终端的本地浏览器中输入 VeADK Web 链接，选择目标 Agent 后输入提示词“你好”，能正常返回信息，表示模型已被启用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4158ce98f02b6d716a79d17ecdbb8ba3.png) * **验证二**：执行`vim .env`打开项目根目录下的 .env 文件，在键盘上按`i`键进入编辑模式，在`MODEL_AGENT_API_KEY=`配置前添加`# `注释掉此部分信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9b2ebe832e8ac4bd2107e69ced67e995.png) 在 VeADK 界面重新向目标 Agent 后输入提示词“你好”，无法正常返回信息，表示模型无法使用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8da8d2bde46210707e8bf7b6597f67ba.png) * **验证三**：登录[AgentKit控制台](https://console.volcengine.com/agentkit)，在“网关 \> 模型服务”的“监控”页签下，查看模型调用请求次数。请求次数不为 0 表示模型已被正常调用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_06a98f123358e8b1d3bf7313272ccae3.png) ### **步骤四：发布智能体运行时** 在运行 VeADK 终端窗口，按键盘 Ctrl + C，终止进程，然后执行命令`agentkit launch`将本地配置推送到 AgentKit 平台智能体运行时中。