必须完成平台凭证绑定、模型服务启用与配置文件修改三步闭环操作，缺一不可，否则Agent启动后将默认回退至豆包基础模型；需开通Agent Plan并勾选对应权限获取API密钥，在Coze或HiAgent中启用模型服务，并在Hermes Agent的llm_config.yaml中准确填写volcengine配置项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎AI Agent中接入大模型，必须完成平台凭证绑定、模型服务启用与配置文件修改三步闭环操作，缺一不可，否则Agent启动后将默认回退至豆包基础模型且无法调用指定大模型。
开通火山引擎Agent Plan并获取API密钥
登录火山引擎控制台→进入「AI与大模型」→点击「Agent Plan」→选择「立即开通」并完成实名认证与支付；开通成功后，在「API密钥管理」页面创建新密钥，【务必勾选“Agent Plan”权限范围】，生成后立即复制保存api_key和api_secret——该密钥仅显示一次，丢失需重新生成。
若跳过权限勾选，后续配置会通过验证但调用时返回403错误，且控制台无明确提示。
在Coze或HiAgent中启用对应模型服务
方法一：Coze平台（推荐低代码场景）
进入Bot编辑页→左侧菜单点「模型设置」→下拉选择「火山引擎」→输入上一步获取的api_key与api_secret→点击「测试连接」→成功后从「可用模型列表」中勾选目标模型（如doubao-1.6、doubao-video-1.0等）→保存。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
方法二：HiAgent平台（适合企业级编排）
进入「工作流配置」→点击右上角「模型中心」→新增「火山引擎模型节点」→填写密钥→手动输入模型名称（注意大小写与连字符，例如doubao-visual-sota）→启用「自动重试」与「超时设为30s」→提交。
修改Hermes Agent本地配置文件（命令行方式）
第一步：SSH登录已部署Hermes Agent的轻量应用服务器终端
第二步：执行cd /opt/hermes/config进入配置目录
第三步：用nano编辑器打开llm_config.yaml：nano llm_config.yaml
第四步：定位到providers:区块，在其下新增火山引擎配置段：
volcengine:<br> enabled: true<br> api_key: "your_api_key_here"<br> api_secret: "your_api_secret_here"<br> region: "cn-beijing"<br> default_model: "doubao-1.6"
【default_model值必须与火山引擎控制台实际发布的模型名称完全一致，大小写敏感，不可添加空格或引号外的任何字符】。填错会导致Agent启动时报错Model not found in provider且不提示具体缺失项。
第五步：保存退出（Ctrl+O → Enter → Ctrl+X），执行sudo systemctl restart hermes-agent重启服务。
