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 配置中心