使用 Hermes Agent 框架时快速接入 Taotoken 的配置指南
使用 Hermes Agent 框架时快速接入 Taotoken 的配置指南
1. 准备工作
在开始配置之前,请确保您已经完成以下准备工作:拥有有效的 Taotoken API Key,可以在 Taotoken 控制台中创建和管理;了解 Hermes Agent 框架的基本使用方法;准备好在项目中使用的模型 ID,可以在 Taotoken 模型广场查看。
2. 配置 Hermes Agent 使用 Taotoken
Hermes Agent 是一个流行的智能体开发框架,支持通过自定义 provider 接入不同的模型服务。要使用 Taotoken 作为模型提供商,需要进行以下配置:
2.1 设置 provider 为 custom
在 Hermes Agent 的配置文件中,需要将 provider 设置为 custom,这样才能使用 Taotoken 提供的服务。典型的配置文件可能位于项目根目录下的config.yml或hermes.config.js中,具体位置取决于您的项目结构。
# config.yml 示例 provider: custom base_url: https://taotoken.net/api/v1 model: taotoken/claude-sonnet-4-62.2 配置 base_url
Taotoken 为 Hermes Agent 提供的 base_url 必须是https://taotoken.net/api/v1。请注意结尾的/v1是必需的,这与 OpenAI 兼容的 API 路径约定一致。如果省略/v1,请求将无法正确路由。
3. 安全地管理 API Key
为了安全地使用 Taotoken API Key,推荐通过环境变量文件来管理密钥,而不是直接硬编码在配置文件中。
3.1 创建 .env 文件
在项目根目录下创建.env文件,并添加以下内容:
OPENAI_API_KEY=your_taotoken_api_key_here请将your_taotoken_api_key_here替换为您在 Taotoken 控制台中获取的实际 API Key。
3.2 确保 .env 不被提交到版本控制
将.env添加到项目的.gitignore文件中,防止敏感信息被意外提交到代码仓库:
# .gitignore .env4. 验证配置
完成上述配置后,可以通过运行一个简单的测试脚本来验证连接是否成功:
// test-connection.js import { Hermes } from 'hermes-agent'; const hermes = new Hermes({ provider: 'custom', baseUrl: process.env.OPENAI_API_BASE_URL || 'https://taotoken.net/api/v1', apiKey: process.env.OPENAI_API_KEY, model: 'taotoken/claude-sonnet-4-6' }); async function test() { const response = await hermes.chat({ messages: [{ role: 'user', content: 'Hello, world!' }] }); console.log(response); } test().catch(console.error);如果配置正确,您应该能看到来自 Taotoken 的模型响应。
5. 使用 TaoToken CLI 简化配置
对于希望快速完成配置的用户,可以使用 TaoToken 官方提供的 CLI 工具来简化流程:
- 安装 CLI 工具:
npm install -g @taotoken/taotoken - 运行配置向导:
taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_ID - 按照提示完成配置
CLI 工具会自动为您生成正确的配置文件并设置环境变量。
如需了解更多关于 Taotoken 的信息,请访问 Taotoken。
