扣子外部业务数据交互操作指南

先把话说明白：想让扣子里的AI智能体真正读懂你们公司的销售报表、客户合同或者内部SOP，关键一步就是把原始业务数据接进去，而且得建一个能随时被AI调用的实时通道。这事儿听起来有点技术门槛，但拆开了看，就那么几个步骤。

先说个关键点：未完成解析的知识库，没法参与任何推理。所以，别急着让智能体去问它不明白的东西。

上传业务数据到知识库

第一步：进扣子工作台 → 点左边导航的【知识库】→ 再点右上角的【新建知识库】。

第二步：给知识库起个名，最好带上业务类型，比如“2026Q2_销售合同库”。接着选更新模式：如果你的文档不怎么变，选【手动更新】就行；要是想自动抓公开网页或RSS源，得用【自动抓取】，但前提是你已经配好了爬虫权限。

第三步：点【上传文件】，看看都支持什么格式——PDF、Word、Excel、TXT、Markdown都行。不过，一次不能超过20个文件，总大小控制在200MB以内。这里有个坑得注意：Excel表格如果带了好几个Sheet，系统默认只认第一个Sheet。想要全部解析？先把每个Sheet拆成独立的XLSX文件，再分别上传。

第四步：上传完，右边会显示解析进度。别急，等状态变成“就绪”再说。得提醒一句：没解析完的知识库，谁也调不动。

在工作流中调用知识库数据

方法一：用「知识库检索」节点

在工作流编辑界面，拖一个「知识库检索」节点进来 → 双击打开配置 → 在「知识库」下拉菜单里选你刚才就绪的那个 → 填上检索关键词模板，比如“客户{{input.customer_name}}的签约条款”→ 然后把输出接到大模型节点的「上下文」端口上。

方法二：玩个组合拳——「数据库查询」+「知识库嵌入」+动态过滤

先用「数据库查询」节点从你们自己的MySQL或PostgreSQL里拉出客户ID列表 → 接一个「循环」节点 → 每次循环里，用「知识库检索」节点传当前客户ID作为关键词 → 把查回来的内容写进变量，方便后面统一处理。这一步得保证一件事：知识库里的每个文档，标题或开头最好都带上客户ID，不然检索可能找不着北。

绑定知识库到智能体

进到智能体的编辑页面 → 左边菜单选【设置】→ 往下翻，找到【知识库】模块 → 点【添加知识库】→ 勾上你准备好的业务知识库（一次可以选多个）→ 保存。

搞定之后，当用户提问时，智能体会自动触发向量检索，从你上传的销售合同、产品说明书里挑最相关的段落，塞进提示词的上下文里。但必须再次强调：知识库不会自己更新。你改了原始文件，得重新上传，等它解析完，旧数据才会被新数据替代。

验证数据交互是否生效

第一步：在工作流里加一个「调试输出」节点，接在「知识库检索」节点后面，输出字段设为「检索结果」。

第二步：点右上角的【试运行】，输入一句能明确匹配知识库里某文档关键词的话，比如“请列出《XX服务协议》第3.2条内容”。执行完看调试输出，是不是返回了对应的原文段落。

第三步：如果返回为空，别慌，检查三个地方：① 知识库状态到底是不是“就绪”？② 你的检索关键词，跟文档原文差异太大？（试试换个更直白的说法，比如把“履约义务”换成“要做什么”）③ 系统切分文档时，会不会把内容误判成无意义的碎片扔了？（去知识库详情页点「查看片段」确认一下）

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：扣子外部业务数据交互操作指南要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题