当前位置：首页 > news >正文

在Hermes Agent项目中接入Taotoken作为自定义模型提供商

news 2026/5/7 22:20:35

在Hermes Agent项目中接入Taotoken作为自定义模型提供商

基础教程类，针对使用Hermes Agent框架的开发者，教程详细说明如何在配置文件中按文档要求设置provider与base_url，并将Taotoken提供的密钥写入约定的环境变量文件，最终完成自定义模型提供方的接入，让Hermes Agent能够调用Taotoken聚合的模型。

1. 准备工作：获取Taotoken API Key与模型ID

在开始配置之前，你需要准备好两个关键信息：Taotoken的API Key和你想调用的模型ID。

首先，登录Taotoken控制台。在控制台的“API密钥”管理页面，你可以创建一个新的API Key。请妥善保管此密钥，它将在后续步骤中作为身份验证凭证使用。

其次，前往“模型广场”页面。这里列出了平台当前支持的所有模型及其对应的模型ID。例如，你可能看到类似claude-sonnet-4-6、gpt-4o这样的标识符。记下你计划在Hermes Agent项目中使用的模型ID。

2. 理解Hermes Agent的Provider配置机制

Hermes Agent框架允许开发者通过配置来指定模型服务的提供方。当使用Taotoken这类聚合平台时，你需要将provider类型设置为custom。这告诉Hermes Agent，你将使用一个自定义的、兼容OpenAI API规范的端点。

配置的核心在于正确指定base_url。对于Taotoken平台，当你使用OpenAI兼容的API路径时，base_url必须设置为https://taotoken.net/api/v1。请注意末尾的/v1路径，这是与平台OpenAI兼容接口约定的格式，确保请求能被正确路由。

3. 配置环境变量与项目设置

Hermes Agent通常通过环境变量来管理敏感信息，如API Key。推荐的做法是在项目根目录下的.env文件中进行配置。

创建一个名为.env的文件（如果尚未存在），并添加以下内容：

OPENAI_API_KEY=你的Taotoken_API_Key

这里将环境变量OPENAI_API_KEY的值设置为你从Taotoken控制台获取的API Key。Hermes Agent的OpenAI客户端通常会读取这个环境变量作为认证凭证。

请确保.env文件已被添加到.gitignore中，避免将密钥提交到版本控制系统。

接下来，你需要在Hermes Agent的配置文件（例如config.yaml或config.json，具体取决于你的项目结构）中，找到模型提供方配置的部分。将其修改为如下示例所示的结构，关键点在于指定provider为custom，并设置正确的base_url。

# 示例配置片段 model_provider: name: custom config: api_key: ${OPENAI_API_KEY} # 引用环境变量 base_url: "https://taotoken.net/api/v1" default_model: "claude-sonnet-4-6" # 替换为你在模型广场选定的模型ID

如果你的配置是JSON格式，原理相同：

{ "model_provider": { "name": "custom", "config": { "api_key": "${OPENAI_API_KEY}", "base_url": "https://taotoken.net/api/v1", "default_model": "claude-sonnet-4-6" } } }

4. 使用TaoToken CLI工具快速配置（可选）

除了手动编辑配置文件，你也可以使用TaoToken官方提供的CLI工具来简化接入流程。首先，确保你的系统已安装Node.js环境。

你可以通过npm全局安装CLI工具，或者使用npx直接运行：

npm install -g @taotoken/taotoken # 或 npx @taotoken/taotoken

安装后，运行taotoken hermes或简写taotoken hm命令。该工具会启动一个交互式命令行界面，引导你输入Taotoken API Key和选择的模型ID。根据提示完成操作后，CLI工具会自动帮你生成或更新Hermes Agent项目所需的配置文件和环境变量，确保base_url等参数被正确设置为https://taotoken.net/api/v1。

此方法可以减少手动配置出错的可能，具体操作细节可参考工具运行时的提示或官方文档。