连接 Hermes:使用 Runs 协议完成平台接入
区分 Hermes 平台服务与本机 CLI,按固定 Runs 协议验证任务处理。
This article is currently available in Chinese.
Hermes 可以出现在本机扫描结果,也可以作为平台服务接入。本篇面向已经运行的 Hermes 平台 API。只有电脑里装了 Hermes CLI,并不说明它同时提供了平台接口;只有某个聊天兼容接口,也不说明它符合 Hermes Runs 协议。
开始前,请管理者确认服务支持提交运行、查询运行状态及相关停止能力,并提供服务地址、API Token和实际使用的标识。AIRumo 通过这些接口追踪一次处理,因此只证明网页能打开还不够。
视频演示
通过 Desktop 中继配置 Hermes 平台服务,使用 Hermes Runs,检查能力与真实任务回复。这不是扫描本机 Hermes CLI 的教程。
Open original video在正确入口选择 Hermes
进入“AI → 接入 AI → 连接 AI 平台”,先选择 Hermes。Web 使用后端直连;具备中继能力的 Desktop 可按网络条件选择 Desktop 中继。连接从哪里发出,会决定哪些地址能够访问,详情见平台接入方式选择。
如果你的服务只能由当前电脑访问,先在 Desktop 选择相应方式并完成中继配置。不要在 Web 填入仅对自己电脑有意义的入口,再期待后端自动找到它。
填写字段,保持协议含义一致
| 表单内容 | 本篇的填写原则 |
|---|---|
| 服务名称 | 使用可辨认的名字,方便在AI列表找到 |
| 服务地址 | 填管理者提供的主机和端口,不补 /v1/runs |
| API Token | 使用该 Hermes 服务发给你的凭据 |
| 模型或 Agent ID | 核对服务实际提供的标识,初始默认值为 hermes-agent |
| 协议 | Hermes Runs(固定) |
| 请求超时 | 默认300秒,按需要在300至3600秒内调整 |
Hermes 的界面协议显示为“Hermes Runs(固定)”,实际使用 /v1/runs。它不是让你在 Responses 和 Chat Completions 之间试着切换。内部设置与其它服务可能有相似字段,也应按 Hermes 的协议解释,不能照搬另一套配置。
模型或 Agent ID 与服务名称职责不同。即使把服务叫作“活动助手”,实际标识仍应按服务管理者提供的值填写;默认值只是起点,不是对每台服务的保证。
测试连接并理解失败位置
填写后点击“测试连接”。如果缺少字段,先补齐页面提示;如果出现协议或能力错误,请管理者核对服务是否确实开放 Runs 接口及所需能力。仅有一个能接收文本的自定义接口,不能直接当作完整 Hermes 平台。
建议按地址可达、认证、接口能力、标识、超时的顺序排查。先保留错误原文和时间,再只改一项配置复查。不要把 Token 放进错误截图或反馈消息;可以说明“已确认凭据属于该服务”,由管理者在私密渠道核对。
从连接成功走到真实任务
测试通过后点击“完成接入”,返回AI列表检查名称和平台来源,再开始会话。先发送一个不带文件的短请求,例如:
请把“确认时间、预订场地、准备主持提纲、整理通知”排成一份准备清单。 输出:需要先确认的信息、可以并行准备的材料。只整理已知文字,不补充日期,不执行工具操作。
你应看到与材料相关的最终回复,而不是始终停在已接收。Runs 包含运行过程,若响应需要等待,应查看原请求或任务状态,不要因稍慢就重复发相同目标。检查结果是否把时间和场地的确认放在前面,并保留缺失信息。
继续发出一项修改:“把主持提纲准备放到材料部分,其它结构保持不变。”核对它是否在同一会话继续工作。这个小例子通过后,再尝试更复杂的任务。
把首次验证拆成“接收、处理、最终回写”也有助于交接。只看见请求已接收时,不应向同事宣布任务完成;等待过程中若页面有具体失败提示,保留错误与时间交给管理者。原会话出现最终文本后,再检查它是否真的处理了材料和后续修改,而不是固定回复成功。向同事说明该服务的使用方式和限制,比只提供一个名称更有用;敏感凭据仍留在连接管理范围内。
附件、会话与故障恢复分别检查
不要把平台接入当作任意文件解析保证。服务能处理什么图片、文件和工具,还取决于它的实现和你的权限。文件不可读时,先换为必要文字摘要,保留真实限制,不让它猜测未读取的内容。
发生超时或断线时,原运行可能已经开始。先核对原执行状态再决定下一步,结果未知时不自动重复执行。中继接入还应检查 Desktop 在线情况;凭据轮换后重新核对连接。更多排查见Agent 不在线或不回复。
AIRumo