Dify 的 Agent 里挂了 GoogleSearch 工具SerpApi Key 填好、状态显示“已授权”可 Workflow 一跑 LLM 节点就跳401。这类问题在 Dify 工具生态里很常见工具本身没坏是模型通道的 Base URL 填错了。在 Dify 模型供应商里配置 TaoToken 时Base URL 要填https://taotoken.net/api末尾不带/v1Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建官网地址只用来注册、看模型广场和用量不能当接口地址填进供应商。下面按排查顺序把“第一方工具 / 自定义工具 / MCP 工具都要调用模型”这条线捋一遍。1. Dify 工具生态里的 401先看 LLM 节点背后的模型通道1.1 工具是桥梁但桥梁要有模型来驱动原文对工具的定义很准工具/插件是把 LLM 和外部世界连起来的桥梁第一方工具管搜索、图像、计算自定义工具按 OpenAPI/Swagger 或 OpenAI Plugin 规范导入。可不管是哪种工具真正决定“这一步怎么调工具、参数怎么填”的还是 Agent 策略或 Workflow 里 LLM 节点所引用的那个模型。模型通道一断表现就是工具列表里工具还在、授权状态也是“已授权”但 LLM 节点调用时报 401。因为 Dify 要先用模型通道去跑 Agent 策略模型通道鉴权失败后面的工具调用根本没机会发起。所以排查顺序不是先看 GoogleSearch、维基百科、WolframAlpha 这些工具的凭据而是先看模型供应商里填的Base URL 和 API Key。1.2 401 出现在明确的三类位置在 Dify 里401 基本集中在这三处模型供应商测试连接时直接返回 401说明 Base URL 或 Key 不对。Agent 策略面板选好模型后对话时报 401说明模型通道没配上。Workflow 的 LLM 节点执行时报 401节点里引用的模型来自某供应商实例那个实例没配通。这三处指向同一个根因Dify 模型供应商里的OpenAI-API 兼容配置写错了。往下逐段拆。2. Dify 模型供应商填 TaoTokenBase URL 到底写哪一段2.1 先分清官网地址和接口地址原文讲工具授权时让读者去 SerpApi 管理界面复制 API Key这个动作本身没问题。对应到模型通道很多人把两件事混在一起把 TaoToken 的官网地址当成了 API 接口地址。正确的划分是用途地址说明注册、创建 Key、看模型广场、看用量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end给人点的网页填进 Dify 模型供应商的 Base URLhttps://taotoken.net/api给程序调用的接口末尾不带/v1在 Dify 模型供应商里选的是OpenAI-API 兼容Base URL 填https://taotoken.net/api。末尾不要再加/v1也不要把官网链接、UTM 参数塞进去。Dify 调用时会在 Base URL 后面自己拼上/chat/completions这类路径多写一段就变成/api/v1/v1/...直接 404 或 401。2.2 创建 Key 和确认模型 IDKey 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建进去后到控制台里生成一把 API Key复制出来。Dify 模型供应商里的 API Key 就填这把占位写法是YOUR_API_KEY。模型名称/模型 ID 这块不要照抄别人的截图。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场当次列表为准能看到哪些模型就填哪些。Dify 的“OpenAI-API 兼容”供应商里通常要填一个模型名填的必须和模型广场里对得上否则也可能在 LLM 节点里报错。3. GoogleSearch 这类第一方工具授权动作不用改3.1 SerpApi 凭据和模型通道是两条线原文里第一方工具的配置路径很清晰左侧导航进“工具 → 第一方工具”找到对应工具点“授权”按提示填 API Key 或走 OAuth成功后显示“已授权”团队成员共享。GoogleSearch 的凭据是 SerpApi 那一套放在工具授权里。TaoToken 只负责模型通道不去替 GoogleSearch 做网页抓取也不换掉 SerpApi 的 Key。排 401 的时候不要动这些已经授权成功的工具凭据。它们和模型通道各自独立工具凭据决定工具能不能真的搜索、抓页面模型通道决定 LLM 节点能不能跑起来调用工具。3.2 授权显示“已授权”却仍 401 时怎么查如果工具那栏显示已授权LLM 节点还是 401可以按这个顺序核对打开 Dify 的模型供应商列表看 OpenAI-API 兼容那一条的 Base URL 是不是https://taotoken.net/api。看 API Key 是不是从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建的那把前后有没有多复制空格。在该供应商下点测试或发一条最简单消息看返回是不是 401。确认 LLM 节点引用的模型属于这个已经配好的供应商实例而不是还挂着另一个没配通的实例。顺序反过来查最容易绕远先怀疑工具凭据改半天 SerpApi最后发现模型通道从没填对。4. 自定义工具导入后 LLM 节点仍 401 的排查顺序4.1 Schema 解析成功不等于模型通道通原文自定义工具部分讲得很细导航到“工具 → 自定义工具”粘贴 OpenAPI/Swagger 的 JSON/YAML或提供 URL系统自动解析接口定义解析后可以测试接口看请求/响应格式测试通过就保存工具列表里新增一项能在 Agent/Workflow 里调用。凭据上无鉴权的开放 API 不用配有鉴权的可以定义secret-input、text-input或select类型的字段。这里容易误会的一点Schema 解析成功、接口测试通过只说明这个自定义工具本身的 HTTP 请求没问题。它照样不解决 LLM 节点 401。因为 Schema 里定义的是“这个工具怎么调”模型通道定义的是“LLM 拿哪个 Key、走哪个 Base URL 来规划调用”。两条线得分别配。4.2 从供应商配置回查 LLM 节点自定义工具导入完成、在工具列表里能看到之后如果 Agent 或 Workflow 里还是 401回查模型供应商供应商类型OpenAI-API 兼容Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建模型名称以模型广场当前列表为准保存后再跑一次 LLM 节点。如果这次能返回内容再去看工具调用是否正常如果工具调用有自己的鉴权错误比如自定义工具的 Key 过期那是工具侧的错跟模型通道分开处理。5. MCP 工具刷新后Agent 策略面板里的模型引用5.1 MCP 服务器不承载 LLM 通道原文 MCP 部分给的流程是工具 → MCP → 添加 HTTP 服务器填服务器 URL、唯一 ID、名称和图标Dify 轮询获取工具列表并处理 OAuth更新工具时点服务器卡片的“刷新”凭据过期点“重新授权”编辑或移除服务器要谨慎因为会影响所有引用它的应用。使用上Agent 策略面板里 MCP 工具和内置插件并列显示Workflow 里出现新节点类型参数界面自动生成。这些操作都是围绕“工具服务器”的。MCP 服务器再刷新、再重新授权也不会替你去配 LLM 的 Base URL。模型通道没通401 不会因为刷新 MCP 而消失。5.2 Workflow 里把工具节点和 LLM 节点拆开看Workflow 里出现 401先定位是哪一类节点报的报错在LLM 节点查模型供应商配置Base URL 是不是https://taotoken.net/api。报错在工具节点 / 自定义工具节点查该工具自己的凭据、Schema、请求格式。报错在Agent 节点既查模型通道也查 Agent 策略里引用的工具列表。如果 MCP 工具和内置插件在 Agent 策略面板里都显示正常但一对话就 401说明模型通道那条线还没配好跟 MCP 服务器状态无关。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 确认 Key 和模型 ID 没问题。6. 把关键配置写清楚一份可对照的核对表6.1 模型供应商核对表配置项正确写法常见错误供应商类型OpenAI-API 兼容选成别的、或自建供应商没配通Base URLhttps://taotoken.net/api写成官网链接、末尾多加/v1API KeyYOUR_API_KEY从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建模型名称以模型广场当时列表为准按截图硬填、名字对不上6.2 工具侧凭据核对表工具凭据来源是否受本次排障影响GoogleSearchSerpApi 管理界面不动网页抓取一般无需额外 Key不动自定义工具OpenAPI/Swagger 里定义的字段单独问题单独查MCP 工具MCP 服务器 URL / OAuth单独问题单独查两个表配合看就能判断 401 到底出在哪条线。7. 验证LLM 节点重新拿到模型401 消失7.1 先在模型对话里试同一把 Key供应商保存之后最省事的验证方式是拿同一把 Key 在 TaoToken 模型对话 里发一条测试消息。这一步能确认三件事Key 有效、模型 ID 对得上、Base URL 没填错。模型对话通了再回 Dify 去测。7.2 回 Dify 重跑一次 LLM 节点回到 Dify在模型供应商里点一次测试如果有或者在 Agent/Workflow 里发一条最简单的消息看 LLM 节点是否正常返回。要盯的是401 是不是没了工具列表里的 GoogleSearch、维基百科等第一方工具是否仍显示已授权自定义工具、MCP 工具的调用是否按预期触发。如果 401 没了但工具没被调用那是 Agent 策略或提示词的问题不是模型通道的问题按正常调试思路继续即可。8. 调完之后顺手做的两件事配通只是起点。长期用的话建议顺手确认两件小事。第一件是账户和用量打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看一眼控制台确认这把 Key 的调用记录、额度情况都在正常范围不要等 Dify 里又报错才回来查。第二件是把 Base URL 的正确写法记录下来团队里再有人配 Dify 供应商时直接说“Base URL 写https://taotoken.net/api末尾不带/v1”省得再走一遍 401 的弯路。如果打算长期跑 Workflow 和 Agent去 Coding Plan 看看套餐是否够用Key 集中在 控制台 API Keys 里管理想拿同一套模型通道去驱动 Claude Code 这类外部编码工具可以对照 Claude Code 接入文档 里的环境变量写法。排 401 这件事上先把 Dify 模型供应商那个 Base URL 位置填对比反复改工具凭据有用得多。