ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

MaxKB 接 SQLBot 做连续问数,问题拆解节点的 Base URL 填 TaoToken

MaxKB 接 SQLBot 做连续问数,问题拆解节点的 Base URL 填 TaoToken 在 MaxKB 里把 SQLBot 的 MCP 服务接成一条 12 节点的连续问数工作流最容易卡住的不是 SQLBot 那边的.env和sqlbot.conf而是主体工作流第 5 个节点——AI 对话节点。这个节点负责把「以及 / 另外 / 同时」分隔的复合问句拆成 JSON 数组它必须真正调到一个可用的大模型通道否则提示词填得再完整请求也发不出去后面的循环节点拿不到数组整条链路就停在原地。这篇就把这个节点的模型来源补上用 TaoToken 提供 OpenAI 兼容的 Base URL 和 KeyMaxKB 侧只改模型设置SQLBot 侧的 chat_id、mcp_start、mcp_question 全部保持原样。TaoToken 官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后创建 Key 即可。一、原问题与场景AI 对话节点为什么发不出请求原文方案的整体结构是清楚的SQLBot 负责问数MaxKB 负责编排。主体 7 个节点里mcp_start 做认证、提取 Token、AI 对话节点拆解复合问题、循环节点按数组逐个跑循环体 5 个节点用 mcp_question 把问题、chat_id、Token 逐一传给 SQLBot。真正吃模型算力的只有 AI 对话节点这一个位置。问题就出在这里。原文把问题拆解提示词写得很细要求模型识别连接词、按语义单元拆分、直接输出合法 JSON 数组但通篇没有交代这个节点的模型从哪来。很多人在 MaxKB 里新建 AI 对话节点时看到要选模型、要填 API 地址就随手填了一个自己也不确定能不能用的地址结果有两种典型表现一种是节点保存成功但一运行就报连接失败或鉴权失败工作流日志里 AI 对话节点直接标红循环节点因为上游没有输出数组而跳过用户看到的就是「只回答了第一个问题」或者「什么都没返回」。另一种是地址能通但返回的不是纯 JSON模型在数组前后加了「好的以下是拆分结果」之类的说明文字自定义工具节点解析失败循环体同样跑不起来。这两种情况的根因是同一个AI 对话节点缺少一个稳定、格式可控的模型通道。MaxKB 支持 OpenAI 兼容方式接入外部模型只要有一个兼容/chat/completions的地址和对应 Key就能把这个节点喂饱。TaoToken 在这里的角色很单一就是给这个模型通道发 Key 和地址不碰 SQLBot 的任何配置也不改变 MaxKB 工作流的节点结构。需要先明确边界SQLBot 侧的/opt/sqlbot/.env、conf/sqlbot.conf图片路径、第二步拿到的 chat_id以及 mcp_start / mcp_question 两个 MCP 工具全部按原文操作不动。本篇只解决「AI 对话节点的模型从哪来、怎么填」。二、TaoToken 前置注册、创建 Key、确认接入方式在动 MaxKB 之前先把模型通道准备好。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 完成注册并登录。进入控制台后找到 API Keys 相关入口创建一个新的 Key。这个 Key 就是后面要填进 MaxKB 模型设置里的凭证创建后先复制保存页面刷新后通常不再完整显示。创建 Key 的入口在控制台里对应地址是 https://taotoken.net/console/api-keys 。如果你对 OpenAI 兼容接入的字段含义不熟可以先看一眼接入文档 https://taotoken.net/doc 里面会说明 Base URL 和 Key 的对应关系。需要模型对话能力时模型对话页在 https://taotoken.net/models 可以用来确认当前可用的模型标识。这里有一个容易踩的细节MaxKB 走 OpenAI 兼容方式时Base URL 填https://taotoken.net/api不要在后面加/v1。很多 OpenAI 兼容客户端习惯把/v1写进 Base URL但 MaxKB 的模型设置里如果多写了这一段请求路径会拼接成重复的版本段导致 404 或路径不匹配。记住这个地址就是https://taotoken.net/apiKey 填刚创建的那串。如果你后续还要在别的工具里复用这个通道比如 Claude Code 或 Codex 这类编码场景那是另一套配置方式本篇不展开。本篇只聚焦 MaxKB 的 AI 对话节点。三、可复制配置MaxKB 模型设置怎么填回到 MaxKB进入系统设置里的模型设置区域。MaxKB 的模型管理支持添加 OpenAI 兼容的模型供应商操作路径大致是系统设置 → 模型设置 → 添加模型 → 选择 OpenAI 兼容类型。不同版本菜单措辞可能略有差异认准「OpenAI 兼容」这个类型即可。添加时需要填的核心字段如下模型名称填你在 TaoToken 模型对话页确认过的模型标识比如某个具体的模型 ID。这个值会作为请求里的 model 字段发出去填错会报模型不存在。API 域名 / Base URL填https://taotoken.net/api不带/v1。API Key填你在控制台创建的那串 Key也就是YOUR_API_KEY的位置替换成真实值。其他参数如温度、最大 token 数按需设置。AI 对话节点做问题拆解时建议温度调低一些减少模型自由发挥保证输出是干净的 JSON 数组。保存后MaxKB 通常会提供一个测试或校验按钮能直接发一条测试请求确认通道是否可用。如果这一步就报错先不要往下走工作流回到本篇第五节排查。模型添加成功后回到那条 12 节点工作流打开主体工作流的 AI 对话节点在模型选择处选中刚刚添加的这个模型。节点里的问题拆解提示词保持原文内容不变它负责把{{开始.question}}拆成 JSON 数组。此时 AI 对话节点的模型来源就补齐了MaxKB 通过 OpenAI 兼容方式把请求发到https://taotoken.net/api带上你的 Key拿到模型返回的 JSON 数组。再强调一次 SQLBot 侧不动/opt/sqlbot/.env里的图片存放地址、conf/sqlbot.conf里的图片路径、第二步创建的智能问数记录对应的 chat_id以及 mcp_start 和 mcp_question 两个工具的调用参数全部按原文配置。TaoToken 只影响 AI 对话节点这一个位置。四、验证请求与成功结果配置完成后不要直接上复合问题先用一个简单输入验证链路。在工作流调试入口输入一句只包含单个问题的文本比如「查询各部门分类名称的销售金额总和」。观察执行详情AI 对话节点应该返回一个只含一个元素的 JSON 数组形如[查询各部门分类名称的销售金额总和]。自定义工具节点把它转成数组后循环节点进入循环体mcp_question 带着这个问题、chat_id 和 Token 去问 SQLBot最后指定回复节点输出问数结果。如果这一步能跑通说明模型通道、拆解逻辑、循环体三者已经串起来了。再用原文那个复合问题验证拆解能力「请查询各部门分类名称的销售金额总和以及使用饼图展示各商品分类名称的销售数量占比另外再使用折线图展示按日期的销售金额趋势」。理想情况下AI 对话节点输出三个元素的数组分别对应三个子问题循环体逐个执行最终整合输出。这就是原文想要的「一次提问、多次问数」。验证时重点看两个地方一是 AI 对话节点的原始返回是不是纯 JSON 数组没有多余文字二是循环节点的执行次数是不是等于数组长度。如果数组有三个元素但循环只跑了一次多半是自定义工具节点把数组转成了字符串而不是数组检查那一步的转换逻辑。五、本篇常见错排查错误一AI 对话节点报鉴权失败或 401。先确认 Key 是否复制完整有没有多余空格。再确认 Key 是在 TaoToken 控制台创建的、状态正常。如果 Key 没问题检查 Base URL 是否误加了/v1改成https://taotoken.net/api再试。错误二请求路径 404 或提示接口不存在。绝大多数是 Base URL 拼接问题。MaxKB 会在 Base URL 后自动补全请求路径如果你填的是https://taotoken.net/api/v1最终路径就会多出一段。统一用https://taotoken.net/api。错误三模型返回带说明文字JSON 解析失败。这是提示词约束和模型参数共同作用的结果。把温度调低并在提示词里强化「不要添加任何额外文本或解释」的要求。如果仍然偶发可以在自定义工具节点里加一层容错先提取第一个[到最后一个]之间的内容再解析。错误四循环体不执行或只执行一次。检查 AI 对话节点输出是否被正确转成数组。常见原因是自定义工具节点返回的是字符串形式的数组循环节点按字符串处理只当成一个元素。确认转换步骤输出的是真正的数组类型。错误五mcp_question 调用失败。这一般与模型通道无关回到 SQLBot 侧检查 chat_id 是否有效、Token 是否过期、mcp_start 是否成功返回。如果 AI 对话节点已经能正常输出数组说明模型通道没问题问题在 MCP 调用环节。错误六改了模型设置后工作流仍用旧配置。部分版本需要重新保存工作流或刷新模型缓存。保存 AI 对话节点后重新运行一次确认节点引用的是新添加的模型。排查顺序建议从模型通道开始先确认 MaxKB 模型设置里的测试请求能通再看 AI 对话节点输出最后看循环体和 MCP 调用。这样能把问题定位在正确的环节不会在 SQLBot 配置上白费功夫。六、按场景选择下一步如果你现在正卡在 AI 对话节点发不出请求、或者模型设置保存后报错优先去 TaoToken 控制台确认 Key 状态并对照接入文档核对 Base URL 和 Key 的填法。API Keys 入口在 https://taotoken.net/console/api-keys 接入文档在 https://taotoken.net/doc 这两个页面能解决大部分接入类问题。如果你已经配通、想确认某个模型标识是否可用或者想换一个更适合问题拆解的模型可以到模型对话页 https://taotoken.net/models 实际发一条请求看看返回格式确认它能稳定输出 JSON 数组再填回 MaxKB。如果你不只是想跑通这一条问数工作流而是打算长期做编码类、Agent 类的连续任务比如让模型在多个环节反复调用、需要更稳定的额度支撑那可以了解一下 Coding Plan 相关方案入口在 https://taotoken.net/coding-plan 。它面向的是长期编码和 Agent 场景和本篇这种单点接入的诉求不同按自己的实际使用频率选择即可。回到本篇的主线MaxKB 接 SQLBot 做连续问数AI 对话节点的 Base URL 填https://taotoken.net/apiKey 填控制台创建的 KeySQLBot 侧配置一律不动。配通之后复合问题会被拆成子问题数组循环体逐个问数单次对话完成多维度钻取。
返回列表