使用 Hermes Agent 自定义提供方快速接入 Taotoken 聚合服务
使用 Hermes Agent 自定义提供方快速接入 Taotoken 聚合服务
1. 准备工作
在开始配置之前,请确保您已经拥有 Taotoken 平台的 API Key 和需要使用的模型 ID。这些信息可以在 Taotoken 控制台的「API 密钥管理」和「模型广场」页面获取。同时,请确认您已安装 Hermes Agent 的最新版本。
Hermes Agent 是一个支持多种大模型提供方的开发工具,通过自定义提供方配置可以灵活接入 Taotoken 的聚合服务。Taotoken 为 Hermes Agent 提供了 OpenAI 兼容的 API 接口,这意味着您可以使用与 OpenAI 相同的接口规范来调用 Taotoken 上的多种模型。
2. 配置 Taotoken 作为自定义提供方
Hermes Agent 支持通过环境变量或配置文件来设置自定义提供方。以下是两种配置方式的详细说明:
2.1 通过环境变量配置
在您的项目根目录下创建或修改.env文件,添加以下内容:
HERMES_PROVIDER=custom OPENAI_API_KEY=您的Taotoken_API_KEY OPENAI_BASE_URL=https://taotoken.net/api/v1关键配置说明:
HERMES_PROVIDER必须设置为custom以启用自定义提供方OPENAI_API_KEY填写您在 Taotoken 控制台获取的 API KeyOPENAI_BASE_URL必须设置为https://taotoken.net/api/v1,注意末尾的/v1不能省略
2.2 通过配置文件设置
如果您偏好使用配置文件,可以在 Hermes Agent 的配置文件(通常位于~/.hermes/config.json)中添加以下内容:
{ "provider": "custom", "openai": { "api_key": "您的Taotoken_API_KEY", "base_url": "https://taotoken.net/api/v1" } }配置完成后,Hermes Agent 将会使用 Taotoken 作为模型提供方。请注意,base_url的值必须包含/v1后缀,这是 Taotoken 对 OpenAI 兼容接口的要求。
3. 验证配置与测试调用
配置完成后,您可以通过以下方式验证设置是否正确:
hermes --check-config如果配置正确,您应该能看到类似以下的输出:
Provider: custom OpenAI API: configured Base URL: https://taotoken.net/api/v1接下来,您可以通过简单的测试调用来验证集成是否成功:
from hermes import Agent agent = Agent() response = agent.chat("你好,请介绍一下你自己") print(response)如果一切正常,您将收到来自 Taotoken 所提供模型的响应。您也可以在 Hermes Agent 的交互式命令行界面中测试调用:
hermes --interactive4. 模型选择与高级配置
Taotoken 平台提供了多种模型供您选择。要指定使用的模型,可以在调用时通过model参数设置:
from hermes import Agent agent = Agent() response = agent.chat( "请用英文回答这个问题:What is the capital of France?", model="claude-sonnet-4-6" )您也可以在配置文件中设置默认模型:
{ "provider": "custom", "openai": { "api_key": "您的Taotoken_API_KEY", "base_url": "https://taotoken.net/api/v1", "default_model": "claude-sonnet-4-6" } }5. 常见问题排查
如果在集成过程中遇到问题,请检查以下几点:
- Base URL 是否正确:确认
base_url设置为https://taotoken.net/api/v1,特别注意/v1后缀 - API Key 是否有效:在 Taotoken 控制台检查 API Key 的状态和剩余额度
- 网络连接是否正常:确保您的服务器能够访问
taotoken.net域名 - Hermes Agent 版本:使用
hermes --version检查是否为最新版本
如果问题仍然存在,可以参考 Hermes Agent 官方文档 或联系 Taotoken 技术支持。
通过以上步骤,您已经成功将 Hermes Agent 与 Taotoken 聚合服务集成。如需了解更多功能或开始使用,请访问 Taotoken。
