为 hermes agent 配置 taotoken 作为自定义模型供应商

为 Hermes Agent 配置 Taotoken 作为自定义模型供应商

1. 准备工作

在开始配置前，请确保已安装 Hermes Agent 并具备基本运行环境。同时需要准备好 Taotoken 的 API Key，该 Key 可在 Taotoken 控制台的「API 密钥」页面创建。模型 ID 可在「模型广场」查看，选择适合您需求的模型。

2. 配置 Taotoken 作为供应商

Hermes Agent 支持通过配置文件指定自定义模型供应商。要使用 Taotoken 服务，需将 provider 设置为 custom，并正确配置 base_url 和 API Key。

在 Hermes Agent 的配置文件中（通常为config.yml或项目根目录下的.hermes/config.yml），添加或修改以下内容：

providers: custom: base_url: https://taotoken.net/api/v1 api_key: ${TAOTOKEN_API_KEY}

请注意 base_url 必须包含/v1后缀，这是与 OpenAI 兼容 API 的必要路径组成部分。

3. 设置环境变量

为避免将 API Key 直接写入配置文件，推荐通过环境变量传递密钥。在运行 Hermes Agent 前，设置环境变量：

export TAOTOKEN_API_KEY=your_api_key_here

对于 Windows 系统，使用以下命令：

set TAOTOKEN_API_KEY=your_api_key_here

4. 验证配置

完成配置后，可以通过 Hermes Agent 的测试命令验证连接是否正常。运行以下命令测试模型响应：

hermes test --model taotoken/<model_id>

将<model_id>替换为您在 Taotoken 模型广场选择的实际模型 ID。如果配置正确，您应该能收到模型的正常响应。

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

配置完成后，您可以在 Hermes Agent 的工作流文件中指定使用 Taotoken 提供的模型。在工作流配置的模型部分，使用以下格式：

steps: - name: generate-content model: taotoken/<model_id> # 其他步骤参数...

6. 常见问题排查

如果遇到连接问题，请检查以下方面：

• 确认 base_url 正确包含/v1后缀
• 验证 API Key 是否有权限访问所选模型
• 检查网络连接是否能够正常访问 Taotoken 服务
• 确认模型 ID 拼写正确且当前可用

如需进一步了解 Hermes Agent 与 Taotoken 的集成细节，可参考 Taotoken 官方文档中的相关说明。