必须将业务数据接入扣子知识库并建立实时调用通道：先创建知识库、上传支持格式文件（注意Excel多Sheet需拆分），待解析为“就绪”状态后，方可通过工作流检索节点或绑定智能体使用，且需手动更新以确保数据最新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在扣子中让智能体真正理解并响应你公司的销售报表、客户合同或内部SOP文档，必须把原始业务数据接入平台并建立可被AI实时调用的连接通道。
上传业务数据到知识库
第一步：进入扣子工作台 → 点击左侧导航栏【知识库】→ 点击右上角【新建知识库】。
第二步：填写知识库名称（建议含业务类型，如“2026Q2_销售合同库”），选择更新模式——【手动更新】适合静态文档，【自动抓取】仅支持已配置爬虫权限的公开网页或RSS源。
第三步：点击【上传文件】，支持PDF、Word、Excel、TXT、Markdown格式；单次最多上传20个文件，总大小不超过200MB。注意：Excel表格若含多Sheet，系统默认只解析第一个Sheet；如需全部解析，请先拆分为多个独立XLSX文件再上传。
第四步：上传完成后，右侧会显示解析进度条。等待状态变为“就绪”后，该知识库才可被工作流或智能体调用——【未完成解析的知识库无法参与任何推理】。
在工作流中调用知识库数据
方法一：使用「知识库检索」节点
在工作流画布中拖入「知识库检索」节点 → 双击打开配置面板 → 在「知识库」下拉菜单中选择已就绪的目标知识库 → 输入检索关键词模板（例如：“客户{{input.customer_name}}的签约条款”）→ 连接至后续大模型节点的「上下文」输入端口。
方法二：通过「数据库查询」+「知识库嵌入」组合实现动态过滤
先用「数据库查询」节点从自有MySQL/PostgreSQL中读出客户ID列表 → 接「循环」节点 → 每次循环中，用「知识库检索」节点传入当前客户ID作为关键词 → 将返回片段写入「变量」供后续汇总处理。这一步必须确保知识库中每个文档标题或首段明确包含客户ID字段，否则检索将失效。
绑定知识库到智能体
进入智能体编辑页 → 左侧菜单选择【设置】→ 下拉找到【知识库】模块 → 点击【添加知识库】→ 勾选已就绪的业务知识库（可多选）→ 保存设置。
此时智能体在收到用户提问时，会自动触发向量检索，从你上传的销售合同、产品说明书等材料中提取最相关段落，注入提示词上下文。但要注意：知识库内容不会自动更新，修改原始文件后必须重新上传并等待解析完成，旧版本数据仍保留在索引中直至新解析覆盖。
验证数据交互是否生效
步骤一：在工作流中添加「调试输出」节点，接在「知识库检索」节点之后，输出字段设为「检索结果」。
步骤二：点击画布右上角【试运行】→ 在输入框中填入一个明确匹配知识库内某文档关键词的句子（例如：“请列出《XX服务协议》第3.2条内容”）→ 执行后查看调试输出是否返回对应原文段落。
步骤三：若返回为空，检查三个关键点：① 知识库状态是否为“就绪”；② 检索关键词是否与文档实际文本存在语义偏差（尝试换更直白的词，如把“履约义务”换成“要做什么”）；③ 该文档是否被系统切分时误判为无意义内容而丢弃（可在知识库详情页点击「查看片段」确认）。
