扣子怎么给智能体添加知识库
知识库让智能体按需检索长文档,比把资料塞进提示词更省上下文。分段、调用方式、发布这三步做错,回答就会答非所问。
智能体回答得准不准,很多时候差在它有没有资料可查。知识库就是把文档、网页、表格这些资料挂到智能体上,让它按需检索,而不是全部塞进提示词里。
入口在哪
知识库挂在智能体的编排页面里,不在独立的菜单,分两步走。
- 第一步在工作空间左侧的知识库列表里把库建好,之后才能挂载。
- 第二步回到智能体的编排页面,找到「知识」这一块,点加号选择刚建好的库。
- 知识一般分文本和表格两类,问答型资料放文本,结构化的数据放表格。
- 新建库时可以上传本地文件,也可以填网址让平台抓取网页内容。
不同版本的叫法略有差别,有的版本把知识库放在资源库里,思路是一样的:先有库,再挂到智能体上。
具体步骤
- 在工作空间新建一个知识库,名字起得能一眼看懂,后面挂载时才不会选错。
- 选择数据来源,上传文档或者粘贴网页链接,等平台完成解析。
- 检查解析结果,失败的文件会在列表里标出来,扫描件和加密文档最容易失败。
- 设置分段。默认的自动分段能用,长文档建议改成自定义分段,每段控制在几百字,相邻段之间留一点重叠。
- 回到智能体的编排页面,在知识区域点加号,选中这个库。
- 设置调用方式。自动调用由模型自己判断何时检索;按需调用需要在提示词里写清什么情况下查库。
- 在右侧预览区提问,确认回答引用了库里的内容,再发布到渠道。
几个坑
- 改完没重新发布:文档更新后智能体仍按旧内容回答,这是最常见的误会,改完一定要再发一次。
- 分段太长:一段几千字时召回精度明显下降,模型容易只看到开头,长文档拆细才稳。
- 召回条数调太高:一次塞进太多段落,回答会变得啰嗦还容易跑题,先调小再逐步加。
- 纯图片 PDF:没有可提取的文字,解析出来是空的,需要先做文字识别再上传。
- 表格混在文本里:带大量表格的资料放文本库,检索效果很差,应该单独建表格库。
- 库建在个人空间:团队协作时其他成员看不到,需要在开始就规划好建在哪个空间。
怎么验证
造一个只有库里才有的问题。比如文档写了某个内部流程的第三步,就让智能体回答这一步是什么,回答里出现原文的关键词、没有编造不存在的步骤,说明真的检索到了。
再故意问一个库里完全没有的问题。如果它仍然一本正经地给出答案,说明提示词里缺少约束,需要补一句「资料里没有就直说」。两次都过,再去看引用来源,确认命中是目标文档,而不是同名的旧版本。
最后在手机上试一次。发布到多个渠道时,各渠道的配置可能不一致,网页端正常不代表手机端也正常。
常见问题
知识库和提示词里直接贴资料有什么区别
贴在提示词里的内容每一轮对话都占上下文,资料一多就挤掉对话历史,改一次还得重新发布。知识库是按需检索,资料可以很长,更新只动库。常用的规则和语气放提示词,事实性资料放知识库,这样分工最省心。
一个智能体能挂几个知识库
一般可以挂多个,按主题分开建库比塞成一个大库更好维护。但总数要控制,挂太多时模型选错库的概率上升,检索也更慢。建议按业务场景拆,每个库只放一类资料。
上传的资料会被别人看到吗
取决于库建在哪个空间。个人空间的库只有自己能看,团队空间按成员权限共享。对外发布的智能体,访客只能得到回答、看不到原始文档,但回答里可能复述原文,敏感资料不要整份上传。
一句话总结:给智能体加知识库的关键是分段合理、调用方式选对、改完重新发布。