必须将扣子ai知识库接入工作流，否则ai不会调用；需确认知识库状态为【已完成】且已提取内容，再添加知识库检索节点并正确连接至开始节点，配置语义检索、变量绑定及返回数量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要把扣子AI知识库真正用起来，必须把它接入工作流——否则知识库只是静静躺在后台的“电子档案”，用户提问时AI根本不会去翻它。你上传了《客服FAQ》《产品说明书》《退换货政策》，但用户问“怎么退货”时AI还在胡编乱造，问题就出在这一步没连通。
确认知识库已就绪
打开扣子平台左侧菜单，点击「知识库」，检查目标知识库状态是否为【已完成】。如果旁边显示“处理中”或“失败”，工作流节点调用时会直接报错，无法返回任何结果。单个文件超过50MB、扫描版PDF、加密PDF都会导致解析失败，此时需重新上传合规文档。
鼠标悬停在知识库名称上，确认右侧显示“已提取XX条内容”。没有这个数字，说明文本未被成功识别，后续所有检索都无效。
添加知识库检索节点
进入你要编辑的工作流画布，在左侧节点栏找到「知识库」分类，拖拽「知识库检索」节点到画布空白处。
将该节点连接到「开始」节点之后——这是强制顺序，不能跳过或反向连接。如果连错了位置（比如连到大模型节点后面），AI会在没有上下文的情况下强行生成答案，完全绕过你的知识库。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
双击打开节点配置面板，在「选择知识库」下拉菜单中，勾选你已创建并完成解析的那个知识库。注意：这里只显示状态为“已完成”的知识库，其他选项是灰色不可选的。
配置检索参数
第一步：在「检索内容（query）」输入框内，点击右侧「添加变量」→「节点引用」→「开始节点」→「input」。这一步必须手动点选，不能手输“input”或粘贴文字，否则系统无法绑定用户原始问题。
第二步：设置「返回文档数量」为3～5条。设为1条容易漏关键信息，设为10条则可能引入噪声，干扰大模型判断。电商类问答建议填3，制度类问答建议填5。
第三步：勾选「启用语义检索」。这是默认开启项，但务必确认开关处于蓝色开启状态——关闭后将退化为关键词匹配，遇到同义词、口语化表达（如“不想要了” vs “申请退货”）时大概率查不到结果。
完成配置后，节点右上角应出现绿色对勾图标。此时可点击画布右上角「试运行」，在输入框中输入“退货流程”，观察下方日志是否返回真实文档片段。若返回空或报错，立即回溯前两步检查知识库状态与节点连线。
