配置 Hermes Agent 使用 Taotoken 作为自定义模型提供方

配置 Hermes Agent 使用 Taotoken 作为自定义模型提供方

1. 准备工作

在开始配置前，请确保已安装 Hermes Agent 并完成基础环境搭建。您需要准备以下信息：从 Taotoken 控制台获取有效的 API Key，以及在模型广场查看目标模型的 ID。建议在配置前阅读 Hermes Agent 官方文档中关于自定义提供方的说明。

2. 配置 Hermes Agent 连接 Taotoken

Hermes Agent 支持通过环境变量或配置文件指定自定义模型提供方。以下是两种方式的配置方法：

2.1 通过环境变量配置

在项目根目录下的.env文件中添加以下变量：

OPENAI_API_KEY=your_taotoken_api_key OPENAI_BASE_URL=https://taotoken.net/api/v1

关键注意事项：

• OPENAI_BASE_URL必须包含/v1路径
• 密钥变量名遵循 Hermes Agent 对 OpenAI 兼容接口的约定
• 修改后需要重启 Hermes Agent 服务使配置生效

2.2 通过配置文件指定

在 Hermes Agent 的配置文件（通常为config.yml）中添加或修改以下段落：

providers: custom: base_url: https://taotoken.net/api/v1 api_key: your_taotoken_api_key

配置完成后运行hermes --validate-config可检查配置是否正确加载。

3. 在工作流中使用 Taotoken 模型

完成基础配置后，您可以在工作流定义中通过provider: custom指定使用 Taotoken。以下是一个示例任务配置片段：

tasks: - name: query_with_taotoken provider: custom model: claude-sonnet-4-6 prompt: | 请用中文回答这个问题...

模型 ID 需要与 Taotoken 模型广场中显示的完全一致。对于 Claude 系列模型，通常格式为claude-{model_name}-{version}。

4. 验证与调试

建议通过以下步骤验证配置是否生效：

1. 运行简单测试命令：hermes run --task test_connection
2. 检查日志输出中是否显示正确的 Base URL
3. 观察 API 调用是否返回预期结果

若遇到连接问题，可尝试以下排查方法：

• 确认 API Key 是否有调用权限
• 检查网络连接是否正常
• 验证 Base URL 是否包含必要的/v1路径

如需进一步了解 Hermes Agent 的高级用法，可参考其官方文档中的工作流编排章节。

Taotoken 提供了多种大模型供您选择，可在模型广场查看完整的模型列表与特性说明。