Skip to content

Hermes Agent 使用教程

Hermes Agent 是 Nous Research 生态中的开源 autonomous agent。官方 FAQ 表示 Hermes 支持 OpenAI-compatible endpoint,因此可以尝试通过 SilkAPI 接入。

准备工作

请先准备:

  • SilkAPI API Key
  • SilkAPI Base URL
  • 可用模型名称

示例 Base URL:

text
https://api.silkapi.com/v1

配置方式

Hermes Agent 的具体配置入口可能随版本变化。请在 Hermes 的模型或 provider 设置中选择 OpenAI-compatible、自定义 OpenAI、Custom endpoint 或类似选项,然后填写:

text
Provider: OpenAI Compatible
Base URL: https://api.silkapi.com/v1
API Key: 你的 SilkAPI API Key
Model: 你要使用的模型名称

如果你使用 Docker 或服务器部署版本,建议把 API Key 放在环境变量中:

bash
export OPENAI_API_BASE="https://api.silkapi.com/v1"
export OPENAI_API_KEY="你的 SilkAPI API Key"
export OPENAI_MODEL="你要使用的模型名称"

然后按你的部署方式重启 Hermes Agent。

验证

启动 Hermes Agent 后,先发送低风险任务:

text
请介绍你当前可用的工具和运行环境。

确认模型能正常回复后,再执行涉及文件、网络或自动化的任务。

注意事项

Hermes Agent 是 autonomous agent,可能会调用工具、读写文件或长时间执行任务。建议:

  • 使用低权限 API Key
  • 为测试环境设置单独目录
  • 不要把生产密钥放进 Agent 可读取的项目文件
  • 首次接入时避免给它执行高风险命令

常见问题

OpenAI-compatible 选项找不到

请升级 Hermes Agent 到最新版本,或检查当前版本是否需要在配置文件中手动声明 provider。

工具调用失败

部分模型或中转接口只兼容聊天补全,不一定完整支持所有工具调用能力。建议换用 SilkAPI 中工具调用兼容性更好的模型。

参考:Hermes Agent FAQ