3.1 场景与知识库准备

前两篇的 Agent 依赖模型自身知识和实时搜索,但企业场景中最常见的需求是“基于内部文档回答”。这个项目创建一个产品客服 Agent,知识库中放入一份虚构的“智能水杯产品手册”,要求 Agent 只基于手册内容回答用户问题,手册中没有的信息必须明确说“暂未收录”。

在动手之前,先准备文档。假设手册包含:产品规格、充电说明、清洗注意事项、保修政策。上传前做三件事:文件名改为英文(如 smart_cup_manual_v1.pdf),避免中文名导致解析失败;确认 PDF 不是扫描图片版(用鼠标能否选中文字来判断);删除页眉页脚和无关的广告页,避免这些内容被切片后干扰检索。

3.2 创建知识库与调优检索参数

在扣子左侧菜单进入“知识库”,点击创建,命名为 smart_cup_manual,可见范围选私有。上传文件后,不要直接点保存,先展开高级设置:

  • 分块大小:设为 512。默认的 1024 可能把“保修期为购买后12个月”和后面的例外条款切到不同块中,检索时容易漏掉例外。

  • 分块重叠:设为 64,保留相邻块的上下文衔接。

  • 索引模式:选混合检索,结合关键词和语义匹配,召回准确率最高。

确认入库后,在知识库详情页点击“调试”。输入真实用户可能问的问题,比如“杯子能放洗碗机吗”,查看 Top 3 召回片段。如果第一条召回的是“充电说明”而不是“清洗注意事项”,说明分块或索引需要调整。可以尝试在原始文档中给每节加明确的标题(如“## 清洗方式”),帮助分段器识别边界。

3.3 挂载知识库并写 Prompt

回到 Agent 编辑页,在知识库栏点击“+”添加刚创建的库。配置参数:召回数量设为 3(每次参考最相关的 3 个片段),最小相关度设为 0.5(过滤掉明显不相关的匹配)。

Prompt 的写法决定 Agent 会不会“编造”。人设与回复逻辑中必须包含:

text

你是智能水杯的客服助手。请严格基于【知识库】中的内容回答用户问题。

规则:
1. 如果知识库中有明确答案,直接引用原文要点,不要自行扩展。
2. 如果知识库中没有相关信息,回复:“抱歉,这个问题暂未收录在产品手册中,建议联系人工客服确认。”
3. 不要根据常识或推测回答,即使你觉得答案“应该是什么”。

调试时专门测“诱骗”问题:“杯子充满电能用多久?”如果手册里有续航时间,Agent 应该给出具体数值;如果手册没写,Agent 必须说“暂未收录”而不是猜一个“大约 7 天”。另一个测试:“你们公司总部在哪?”——这明显不在产品手册范围内,Agent 应拒绝回答。

3.4 发布到飞书

Agent 调试通过后,点击右上角“发布”,在渠道列表中选择“飞书”。发布飞书需要先在飞书开放平台创建应用:

  1. 用管理员账号登录飞书开放平台,创建“企业自建应用”,类型选“内部应用”。

  2. 在应用详情页的“机器人”标签中启用机器人,复制 App ID 和 App Secret。

  3. 回到扣子发布页,粘贴这两个值,勾选“消息接收”和“发送消息”权限,点击验证并保存。

发布成功后,在飞书群中 @ 这个 Bot 发送“怎么清洗杯子”,确认能收到基于手册的回答。如果无响应,检查飞书应用是否已“发布上线”——在飞书开放平台的发布管理页面需要再点一次发布,这一步经常被漏掉。

上线后的监控:在扣子 Agent 的分析后台,关注“知识库检索命中率”。如果大量用户问题都触发“暂未收录”,说明要么手册内容覆盖不够,要么分块参数需要再调。可以把用户常问但未收录的问题记录下来,补充到手册文档中,重新上传更新知识库。

三篇小结:第一篇练的是 Agent 的“人设控制力”——提示词写得越具体,输出越稳定。第二篇练的是工作流的“确定性编排”——每个节点的输入输出必须闭环,画板变量绑定是高频出错点。第三篇练的是知识库的“边界意识”——RAG 的效果一半靠文档质量,一半靠 Prompt 中的“禁止编造”约束。建议按顺序做一遍,每个项目跑通后再进入下一个;如果时间有限,优先做第二篇的工作流项目,因为它最能体现扣子区别于普通聊天工具的核心能力。github.0voice

Logo

更多推荐