想要在火山引擎AgentKit中顺利搭建一个能够稳定调用豆包大模型的智能体，必须让模型接入路径、工具注册方式和运行时上下文三者保持完全一致。否则，系统很容易出现工具不可见、回答被截断、Token溢出等常见问题。

如果你希望在火山引擎AgentKit中创建一个可稳定接入豆包大模型的智能体，那么模型调用链路、工具配置逻辑以及上下文运行规则必须严格对齐。只要其中任意一项配置不匹配，就可能导致工具无法识别、输出内容中断，或者出现token超限等异常情况。

确认豆包大模型服务已开通并获取Endpoint

登录火山引擎控制台→进入「AI开发」→「模型服务」→在「已部署模型」列表中找到「豆包大模型2.1 Pro」或「豆包大模型1.8」→点击右侧「详情」→复制「调用地址（Endpoint）」和「API Key」。

这一步非常关键，不能省略，【如果账号尚未开通豆包大模型服务，在AgentKit中将无法选择豆包模型作为推理后端】。如果列表中没有对应模型，请先前往「模型市场」完成订阅并部署，且部署状态必须显示为「运行中」后才可继续。

在AgentKit中创建智能体并绑定豆包模型

进入「Agent开发」→「智能体管理」→点击「新建智能体」→填写名称（如“客服助手-豆包2.1Pro”）、描述→在「基础配置」中，将「模型类型」选择为「大模型推理」→在「模型服务」下拉框中选择已部署的「豆包大模型2.1 Pro」→「版本」选择「latest」或指定v20260623。

需要注意的是：如果下拉框为空，请返回上一步检查模型是否部署成功，以及部署地域是否与AgentKit所在地域保持一致（例如都为「华东2（上海）」）。目前不支持跨地域调用，这是火山引擎AgentKit接入豆包大模型时经常被忽略的一点。

配置工具（Tools）并启用函数调用

方法一：使用内置HTTP工具对接企业API

进入智能体编辑页面后，找到「工具管理」，点击「添加工具」，选择「HTTP请求」。随后填写工具名称（如“查订单”）、功能描述、请求URL以及Method（GET/POST）。接下来，在「参数定义」中按照OpenAPI 3.0规范完整声明字段，其中type、required、description三个字段缺一不可。确认无误后保存即可。

方法二：上传自定义Python工具脚本

点击「添加工具」→选择「Python函数」→上传.py文件（文件中需包含唯一的def main(input_dict: dict) → dict函数）→AgentKit会自动解析函数签名并生成tool spec→上传后会立即进行语法校验，若校验失败则该工具无法启用。

【工具spec中的name字段必须全部使用小写，并且只能包含字母和下划线，否则豆包2.1 Pro在任务规划阶段可能直接忽略该工具】

设置系统提示词与多步任务约束

第一步：进入「提示词工程」→「系统提示词」栏粘贴以下内容（关键指令不可删减）：

你是运行于火山引擎AgentKit平台的专业客服智能体，后端模型为豆包大模型2.1 Pro。你必须严格遵守以下规则：①所有外部操作均需通过调用tools来完成，严禁自行编造结果；②每次响应最多调用3个工具，且不得连续两次调用同一工具；③当用户问题涉及订单号、手机号等敏感字段时，务必先调用“校验身份”工具，待获得success:true后，方可执行后续动作。

第二步：在「高级设置」中开启「强制工具调用模式」→关闭「自由回复兜底」→将「最大工具调用轮数」设置为5。

第三步：点击「发布」→等待状态变为「已上线」。