框架与平台
n8n
在 n8n 的 AI Agent 工作流里用 TokenLab 的对话模型
概览
n8n 用一套 LangChain 风格的节点跑 AI Agent 工作流:AI Agent 节点接一个对话模型子节点。社区节点包 n8n-nodes-tokenlab 就是给 TokenLab 用的那个对话模型,一个凭据、一个 Base URL 覆盖目录里的全部对话模型。
包里有两部分:
- 凭据 TokenLab API(
tokenlabApi):一个 Base URL 加一个 API key。 - 子节点 TokenLab Chat Model(
tokenLabChatModel):输出ai_languageModel,模型列表从GET /v1/models?category=chat拉取。
安装
先要在实例上打开社区节点:Settings → Community Nodes,启用社区节点(自建 Docker 设 N8N_COMMUNITY_PACKAGES_ENABLED=true)。
n8n-nodes-tokenlab 是未验证的社区节点,只能装在自建的 n8n 上:n8n Cloud 只列已验证的社区节点。在自建实例上打开 Settings → Community Nodes → Install,输入包名 n8n-nodes-tokenlab 安装。
把包预装进镜像的自建实例,则把 n8n-nodes-tokenlab 加进实例依赖后重启 n8n;只在 n8n 容器里跑 npm install 不会把节点注册进去。
建凭据
- 在 TokenLab 控制台 创建一个 API key。
- 在 n8n 里新建 TokenLab API 凭据:
- Base URL:
https://api.tokenlab.sh(只有走自己的代理时才改)。 - API Key:第 1 步的 key。
- Base URL:
- 保存。n8n 以
Authorization: Bearer <API key>发出,并在保存时试连一次(列对话模型)。
在 workflow 里用
加一个 AI Agent 节点
把 AI Agent 拖到画布上。
接上模型
加 TokenLab Chat Model,用 ai_languageModel 连线类型接到 Agent 上。
选模型
在下拉里选(列表来自你账号能调的 TokenLab 目录),也可以直接填模型 ID,例如 claude-sonnet-5-5、claude-haiku-4-5、qwen3.8-max。
运行
执行 workflow。每次运行按 token 记到你的 TokenLab 账号,价格与直接调 API 相同。
一个只有这两个节点、已经连好的最小 workflow 导出:
{
"nodes": [
{
"parameters": {},
"id": "agent-1",
"name": "AI Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 1.7,
"position": [0, 0]
},
{
"parameters": { "model": "claude-sonnet-5-5", "temperature": 0.7, "maxTokens": -1 },
"id": "model-1",
"name": "TokenLab Chat Model",
"type": "n8n-nodes-tokenlab.tokenLabChatModel",
"typeVersion": 1,
"position": [-240, 0],
"credentials": { "tokenlabApi": { "id": "REPLACE_WITH_CREDENTIAL_ID", "name": "TokenLab API" } }
}
],
"connections": {
"TokenLab Chat Model": {
"ai_languageModel": [[{ "node": "AI Agent", "type": "ai_languageModel", "index": 0 }]]
}
}
}选模型
下拉里列出的是你账号能调的对话模型。要钉住某个模型 ID 时,从模型页复制准确的 ID。图片、向量、视频这类非对话能力不在本包范围内,用 HTTP Request 节点直接调 https://api.tokenlab.sh/v1。
排查
| 现象 | 处理 |
|---|---|
节点列表里没有 TokenLab Chat Model | 实例没开社区节点,或包没装上;重装 n8n-nodes-tokenlab 后重启 n8n |
| 凭据测试报 401 | key 被删了,或复制时带了空格;在控制台新建一个 key |
| 模型下拉是空的 | 这个账号对这个 key 没有可用模型;到模型页核对目录 |
| workflow 运行报 429 | 账号触到限流;见速率限制 |