Hermes Agent 交互式配置指南
本路线使用 Hermes Agent 自带的 hermes model 向导配置 Ace Data Cloud。它与手动 YAML 配置是两个独立 profile,不能共享配置或验证证据。
当前状态:配置合同已确认,最终客户端版本、渲染配置、工具调用、用量与扣费证据仍待 Wave 1 验证。完成前,Coding 选择器只展示本指南和待验证状态。
¶ 前提
- 安装 Hermes Agent,并记录
hermes --version。 - 在 Coding Application 中创建临时最小权限 API Token。
- 从实时模型目录选择选择器明确允许的 exact model ID。
¶ 使用向导
运行:
hermes model
选择 Custom endpoint,按当前客户端提示填写:
| 字段 | 值 |
|---|---|
| API base URL | https://api.acedata.cloud/v1 |
| API key | Coding Application API Token |
| Model | 选择器给出的 exact model ID |
| Transport / API mode | chat_completions |
向导会生成 Hermes 配置和凭据文件。不要把 Token 粘贴到仓库、Issue、日志或截图。
¶ 验证
先检查配置与版本,再执行最小客户端请求:
hermes --version
hermes chat -Q --max-turns 1 -q "Reply exactly HERMES_OK"
发布 evidence 时还必须完成一次真实工具调用,并核对 trace、ApiUsage、扣减金额和 Coding Application 余额。直接 curl 成功不能替代 Hermes 客户端证据。
¶ 常见问题
- 请求路径错误:确认 transport 是
chat_completions,不要按模型名称猜协议。 - 401:重新检查向导保存的 Token,避免混用其它账号凭据。
- 配置修改无效:完全退出并重启 Hermes。
返回 Coding Plan 配置中心。
