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

在 Hermes Agent 中自定义 provider 接入 Taotoken 服务

news 2026/6/4 18:05:06

🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度

在 Hermes Agent 中自定义 provider 接入 Taotoken 服务

Hermes Agent 是一个流行的 AI 智能体开发框架，它支持通过配置不同的模型提供方（provider）来调用各类大语言模型。如果你希望将 Taotoken 平台作为模型源接入 Hermes Agent，可以通过其custom提供方来实现。本文将指导你完成这一配置过程。

1. 准备工作：获取 Taotoken 的接入信息

在开始配置 Hermes Agent 之前，你需要从 Taotoken 平台获取必要的凭证和地址信息。

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

其次，你需要确定要使用的模型。前往模型广场页面，浏览并选择适合你需求的模型，并记录下其模型 ID。这个 ID 通常是类似claude-sonnet-4-6或gpt-4o的字符串，在配置 Hermes Agent 时会用到。

最后，请明确 Taotoken 为 Hermes Agent 这类 OpenAI 兼容工具提供的Base URL。这是配置中最关键的一步，正确的地址是https://taotoken.net/api/v1。请务必注意末尾的/v1路径，这与直接使用 Anthropic 原生协议的配置不同。

2. 配置 Hermes Agent 使用 Taotoken

Hermes Agent 允许你通过环境变量和配置文件来定义模型提供方。我们将以配置一个名为taotoken的 custom provider 为例。

核心配置要点：

provider 类型：必须设置为custom。
base_url：必须设置为https://taotoken.net/api/v1。
api_key：填入你在 Taotoken 控制台创建的 API Key。
model：填入你在模型广场选定的模型 ID。

最常用的配置方式是通过环境变量文件（如.env）进行设置。你可以在你的 Hermes Agent 项目根目录下创建或编辑.env文件，添加如下内容：

# Hermes Agent 对接 Taotoken 配置示例 HERMES_PROVIDER=custom HERMES_BASE_URL=https://taotoken.net/api/v1 HERMES_API_KEY=你的_Taotoken_API_Key HERMES_MODEL=你在_Taotoken_选择的模型_ID

注意：在实际文件中，请将你的_Taotoken_API_Key和你在_Taotoken_选择的模型_ID替换为真实的、不含尖括号的值。

Hermes Agent 通常会读取OPENAI_API_KEY这个环境变量作为默认的 API 密钥。为了兼容性，你也可以同时设置它：

OPENAI_API_KEY=你的_Taotoken_API_Key

这样，当 Hermes Agent 的代码默认从OPENAI_API_KEY读取密钥时，就能正确使用 Taotoken 的服务。

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

为了简化配置流程，Taotoken 提供了一个官方的命令行工具@taotoken/taotoken。你可以使用它来快速生成 Hermes Agent 所需的配置。

如果你尚未安装，可以通过 npm 进行安装：

npm install -g @taotoken/taotoken

安装完成后，运行taotoken命令，你会看到一个交互式菜单。选择与Hermes Agent相关的选项，然后按照提示输入你的 Taotoken API Key 和想要使用的模型 ID。工具会自动帮你生成或更新对应的配置文件（如.env）和环境变量。

你也可以使用一行命令快速完成配置：

taotoken hermes --key 你的_API_Key --model 你的_模型_ID

或者使用简写：

taotoken hm -k 你的_API_Key -m 你的_模型_ID

CLI 工具的核心作用是确保base_url等关键参数被正确写入为https://taotoken.net/api/v1，避免手动配置可能出现的路径错误。关于 CLI 工具的更多子命令和细节，可以参考其官方说明文档。

4. 验证与测试配置

完成配置后，你可以创建一个简单的测试脚本来验证 Hermes Agent 是否能成功通过 Taotoken 调用模型。

以下是一个使用 Hermes Agent SDK 的 Python 测试示例：

import os from hermes.agent import Agent # 假设你的环境变量已通过 .env 文件加载 agent = Agent( provider=os.getenv(‘HERMES_PROVIDER’, ‘custom’), base_url=os.getenv(‘HERMES_BASE_URL’), api_key=os.getenv(‘HERMES_API_KEY’), model=os.getenv(‘HERMES_MODEL’) ) # 发起一个简单的对话 response = agent.run(“你好，请简单介绍一下你自己。”) print(response)

如果配置正确，你将收到来自所选模型的回复。如果遇到连接或认证错误，请按顺序检查以下项：