框架与平台

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 不会把节点注册进去。

建凭据

  1. 在 TokenLab 控制台 创建一个 API key。
  2. 在 n8n 里新建 TokenLab API 凭据:
    • Base URL:https://api.tokenlab.sh(只有走自己的代理时才改)。
    • API Key:第 1 步的 key。
  3. 保存。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
凭据测试报 401key 被删了,或复制时带了空格;在控制台新建一个 key
模型下拉是空的这个账号对这个 key 没有可用模型;到模型页核对目录
workflow 运行报 429账号触到限流;见速率限制

本页内容