通过 Hermes Agent 自定义供应商接入 Taotoken 大模型服务
1. 准备工作
在开始配置之前,请确保已安装 Hermes Agent 并具备基本的运行环境。您需要准备以下信息:
- Taotoken API Key:从 Taotoken 控制台获取
- 目标模型 ID:在 Taotoken 模型广场查看可选模型
Hermes Agent 支持通过自定义供应商接入第三方模型服务。我们将使用 Taotoken 的 OpenAI 兼容接口作为供应商端点,这需要正确设置 base_url 和 API Key。
2. 配置 Hermes Agent
Hermes Agent 的供应商配置主要通过环境变量或配置文件实现。以下是两种常用方式的详细说明:
2.1 通过环境变量配置
在项目根目录下的.env文件中添加以下配置:
OPENAI_API_KEY=your_taotoken_api_key OPENAI_BASE_URL=https://taotoken.net/api/v1关键注意事项:
OPENAI_BASE_URL必须包含/v1路径- 密钥直接写入
.env文件,请确保该文件不被提交到版本控制系统
2.2 通过配置文件设置
如果您使用 Hermes Agent 的配置文件(通常为config.yml或hermes.config.js),请添加如下配置:
providers: custom: base_url: https://taotoken.net/api/v1 api_key: your_taotoken_api_key或 JavaScript 配置:
module.exports = { providers: { custom: { base_url: 'https://taotoken.net/api/v1', api_key: process.env.TAOTOKEN_API_KEY || 'your_taotoken_api_key' } } }3. 验证连接
配置完成后,可以通过以下方式验证连接是否成功:
hermes --test-connection如果返回成功响应,则表示配置正确。您也可以创建一个简单的测试脚本来验证:
from hermes import Hermes agent = Hermes() response = agent.chat("Hello, world!") print(response)4. 调用指定模型
在 Hermes Agent 中调用 Taotoken 提供的模型时,需要在请求中指定模型 ID。例如:
from hermes import Hermes agent = Hermes() response = agent.chat( "请解释量子计算的基本原理", model="claude-sonnet-4-6" )模型 ID 需要与 Taotoken 模型广场中显示的完全一致。您可以在 Taotoken 控制台的模型列表中找到所有可用模型及其对应 ID。
5. 常见问题排查
如果遇到连接问题,请检查以下方面:
- 确认
base_url是否正确包含/v1 - 验证 API Key 是否有有效且未被撤销
- 检查网络连接是否能够访问
taotoken.net - 确认模型 ID 拼写完全正确
如需进一步了解 Hermes Agent 的高级配置选项,可以参考 Hermes Agent 官方文档。
通过以上步骤,您已成功将 Taotoken 配置为 Hermes Agent 的自定义模型供应商。如需了解更多关于 Taotoken 的功能和使用方式,请访问 Taotoken。