扣子平台的智能体怎么从官方模型切换到自定义模型供应商通道?切换后工作流节点和已发布渠道要单独改吗?

扣子平台切换模型供应商分两层:先在模型管理里新增自定义通道(Base URL、API Key、模型名称),再到智能体编辑页的模型下拉框选中该通道;工作流里的大模型节点要逐个改,已发布渠道必须重新发布才生效,只改编辑器里的模型不会影响线上版本。

扣子平台切换模型供应商通道分为三步:接入通道、选择节点、重新发布,不能只靠一次点击完成。在智能体编排页直接改模型下拉框,只能在平台已上架的官方模型之间换;要把对话真正指向自己的供应商账号,必须先在企业版或专业版的模型管理里新增自定义通道,填好兼容协议的 Base URL、API Key 和模型名称,保存后回到智能体页选中带自定义标记的那一项。只改下拉框不新增通道,计费主体仍是平台资源点,请求也不会落到你的账号上。 先分清官方模型与自定义通道,再决定改哪里,因为这两条路的计费和能力边界同时变化。官方模型由平台侧统一调度,消耗资源点,插件调用、多模态输入、工具参数格式都按平台规范适配过;自定义通道把请求转发到你自己的账号,费用、并发上限、上下文长度由供应商决定。所以切换供应商不是纯界面操作,而是一次涉及成本归属与兼容性的变更,动手前要明确谁承担账单、谁负责排查故障。 自定义通道能用的前提是协议兼容,不是模型名称看起来对口。填 Base URL 时注意版本路径,多数供应商要求写到 /v1 一级;模型名称必须与供应商控制台里的标识完全一致,大小写和版本后缀都算数;鉴权方式通常选 Bearer Token 一类。通道保存后一般会提供连通性测试,测试不通优先查两件事:密钥是否有该模型的调用权限、平台到供应商的网络出口是否通,这两项不解决,后面选哪个节点都没用。 通道接入成功后,模型下拉框里会多出一个自定义分组,这一步最容易出问题的是命名。多人协作时建议按供应商、模型、用途三段命名,例如把对话模型和向量化模型明确区隔,否则列表里并排放着三个名字相近的通道,运营同事改错一次,线上就等于换了个模型。命名规范是低成本高回报的动作,尤其在同时维护多个智能体时。 智能体级别的切换只影响草稿,不影响线上,这是最常见的误判。扣子的智能体是编辑态与发布态双轨运行,编辑页把模型换成自定义通道后,飞书、微信、网页 SDK 等渠道跑的仍是上一次发布的版本,必须点发布并勾选对应渠道才会生效。通过接口调用智能体的团队,发布后还要确认调用侧引用的是最新版本号,否则测试环境正常、线上依旧旧模型。 工作流里的大模型节点不跟随智能体的对话模型,必须逐个改。一个客服工作流里常见意图识别、信息抽取、话术生成、质检四个大模型节点,每个节点都有独立的模型选择,切换供应商要点开每一个修改;漏改一个,线上就会出现部分回答来自新通道、部分来自旧模型的混合状态,排查时极难定位是哪一环出的问题。 知识库的向量化模型和对话模型是两套配置,换对话模型不会自动重建索引。只换对话模型时,索引不动,召回照旧,回答风格和推理能力才变;如果连 embedding 通道也一起换掉,旧索引与新向量不在同一空间,召回会直接失效,需要重建知识库并重跑召回测试。客服场景里更稳的顺序是先只换对话模型,观察召回质量与答案一致性,再决定要不要动向量化。 常见报错按返回码定位,比反复换模型试要快。401 多为密钥无效或前缀缺失,403 是账号未开通该模型或已欠费,404 集中在 Base URL 路径与模型名称写错,429 是并发或额度触顶,请求超时则要对比供应商的首字延迟与平台侧等待时间。上下文超限不属于鉴权层问题,缩短提示词、精简知识库片段或改选长上下文模型即可,不必怀疑通道配置。 该不该切,取决于智能体对工具调用和多模态的依赖程度。依赖插件、工作流嵌套、图片输入的智能体,优先用平台已适配的官方模型,因为工具调用的参数格式和流式行为平台已经对齐;只做问答、话术生成、意图分类这类文本任务的智能体,换成协议兼容度高的自定义通道,成本与可控性通常更好。判断标准是任务类型,不是模型榜单排名。 客服接待场景切换后必须跑一遍回归清单,覆盖多轮上下文保持、知识库引用准确性、工具调用成功率、拒答与转人工触发、长文档摘要五类。切换前后用同一批真实会话做对比,重点看首字延迟、一次解决率和转人工率三项运营指标;通用榜单分数不反映你的知识库结构、提示词写法和业务话术,只能作参考,不能作验收依据。 灰度与回滚要提前设计好,否则切换就是一次性赌博。保留旧通道不删,用两个智能体分别挂新旧模型,把一小部分入口流量导到新版本,观察失败率与人工转接率的变化,异常时把入口流量切回旧版本即可,不必再动配置。通道配置本身允许保留多个,把回滚成本压到一次流量切换,才算真正完成了供应商迁移。