把你的业务知识交给它

抓取你的网站,上传你手头已有的文档,再把只存在你脑子里的内容粘贴进去。智能体的知识库在哪里、怎么写才能让它找到对的那一段,以及怎么让它保持准确。

更新于

从把网站交给智能体、让它读取页面的地方开始播放;往回拖可以看完整过程。

指令告诉智能体怎么表现,知识库告诉它什么是事实——你的课表、你的收费、你的 规定。当家长问枫街补习中心 “初三数学班多少钱?” 时,答案应该来自你写的某一页, 而不是模型的想象。

每个智能体都有自己的知识库,它服务于这个智能体接听的所有渠道:电话、WhatsApp、 网站聊天、邮件。填一次就够。

在哪里

从 /agents 打开智能体,选择 知识 标签页。同一个页面也在 /agents/knowledge——没选智能体时,它会提示 “选择一个智能体以管理其知识库。”

顶部是 添加文档 和 添加网站,下面是一个拖放文件的区域。再往下是三张卡片:

卡片里面有什么
来源你添加的每一个网站、文件或一组粘贴的笔记,附带状态、生成了多少篇文档、有多少篇被标记,以及抓取时间
全部文档智能体能用来作答的每一篇文档。点一个来源会缩小到 来源中的文档;再点一次则显示全部
知识缺口没能读取的网页和文件,等你把内容粘贴进来
“知识”标签页:顶部“添加文档”和“添加网站”,文件拖放区,“来源”里是标着“1 项已标记”的网站、timetable.pdf 和“粘贴的笔记”,“全部文档”里试听课页面标着“内容偏少”,“知识缺口”里有一个带“粘贴内容”的页面。
一个智能体的知识:来源、每一篇文档、被标记的那篇,以及没能读取的页面。

添加你的网站

添加网站 会打开一个对话框,只有一个字段 网站 URL 和一个 查找页面 按钮。你输入什么,决定了会发生什么:

  • 只输入域名——maplestreettutoring.example——读取网站的站点地图,按栏目 列出找到的每一个页面:classes、fees、blog……看起来对回答问题有用的栏目 会替你勾上,其余的不勾。
  • 单个页面——maplestreettutoring.example/fees——只列出这一页,并且已勾选。

把智能体用不到的取消勾选——旧博客文章、新闻、标签页——或者用 全选 / 取消全选。站点地图漏掉的页面填进 添加更多 URL(每行一个)。底部的按钮 会显示你选了多少,比如 抓取 12 个页面,点它就开始抓取。每次抓取最多选 500 个页面;网站更大的话,分几次抓。

如果看到 “未在该 URL 发现任何页面。请尝试其他地址。”,说明这个网站没有可读取 的站点地图。请把你要的页面一个一个地输入,写完整的页面网址。

抓取在后台进行:来源先显示一个加载图标,然后变成 就绪。你也可以直接让 Octo 做——“给补习中心的智能体抓取 maplestreettutoring.example”——它会按栏目、 按可能的有用程度排好页面,让你挑选。

在 maplestreettutoring.example 上点“查找页面”之后的“添加网站”对话框:找到 16 个页面,按栏目分组,classes、fees、timetable、about、faq 已勾选,blog 和 news 未勾选,按钮为“抓取 12 个页面”。
“查找页面”按栏目分组列出页面,并勾选有用的栏目。按钮上显示你选了多少。

上传你的文件

把文件拖到拖放区域——“将文件拖放到此处,或”——或点 浏览文件。可以一次 添加多个;每个上传完成后会显示一个勾,读取会在后台继续。支持的格式:

PDF, DOCX, PPTX, XLSX, ODT, ODP, ODS, RTF, HTML, CSV, TSV, TXT, MD, JSON, YAML, TOML, SRT, VTT

枫街补习中心把本学期的课表以 PDF 上传。文件来源以文件名命名;打开其中一篇文档, 下载原文件 就能把原件取回来。

粘贴只存在你脑子里的内容

有些事哪里都没写:假期停课、孩子缺课怎么处理、家长在哪里停车。添加文档 需要填 标题 和 内容(Markdown),填完立即添加。所有粘贴的笔记都归在同一个 来源 粘贴的笔记 下。

如果同样的文字已经在知识库里,就不会重复添加:“该内容已作为“退款政策”存在于 您的知识库中。未添加新文档。”

写成它找得到的样子

内容框里写着智能体是怎么读你给它的内容的:

撰写或粘贴 markdown。使用 # 标题将文档拆分为可检索的小节 — 每个标题都会成为 智能体可引用的独立片段。

智能体会去找和问题对得上的那一节,所以每个话题给一个标题,每个标题下只放 一个话题:

# 缺课
每学期可补课一次。请在前一天下午 5 点前告知我们。

# 假期停课
寒假期间停课两周。

问缺课的家长,找到的是 缺课 这一节,而不是中间某处顺带提了一句的一长页。 把事实放在最前面,用平实的话写。

让 AI 依据你的网站和你的文档来回答邮件 讲的是邮件这一侧:每一份草稿都会列出它参考了哪些文档。

保持准确

点任意一篇文档即可打开。预览会显示它的来处——一个网页地址、“来自:timetable.pdf”, 或 手动笔记——它的大小(以 token 计)以及标记。编辑 修改标题和正文; 保存 保留修改。

留意文档上的标记:

标记含义怎么办
内容偏少几乎没提取出文字——常见于用 JavaScript 渲染的页面,或扫描的 PDF打开文档,编辑,粘贴真正的文字;或者用 添加文档 添加
乱码读起来像代码或数据,而不是句子用 编辑 删到只剩有用的文字,或者删掉后粘贴一份干净的
已在 3M 个字符处截断超出上限的部分没有保存把文件拆成更小的文档再上传

有被标记文档的来源会注明——“2 项已标记”——不用逐页打开也能找到。

网站变了,就刷新它。网站来源的 更多选项 菜单里有 重新抓取——“此操作会 重新索引该来源的所有页面,可能需要几分钟。”——每篇抓取来的文档也有自己的 重新抓取,只抓那一页。重新抓取会用网站现在的内容替换那些文档,所以先改网站; 只属于智能体的事实,用 添加文档 单独写一篇。

删除来源 会删除一个来源及其所有文档;文档上的 删除 只删那一篇。两者都 无法撤销。

补上知识缺口

知识缺口 列出抓取或上传时没能读取的每个网页或文件,标着 网页 或 文件,下方 用一句话说明原因——比如 “无法访问该网页。” 或 “此文件没有文字层,看起来是 扫描的图片。” 补法都 一样:自己打开那个页面,复制文字,点 粘贴内容。标题已经用页面地址或文件名 填好,加上正文,点 添加。缺口关闭,内容变成一篇文档。

如果那个页面不重要,点 ×——“忽略 — 移除此提醒”——就能清掉。一个都不剩时,这里显示 “没有待处理的 缺口。添加到此知识库的每个网页和文件都已成功读取。”

知识库很大时

当知识库超过智能体一次能读完的量,文档列表会显示:

知识库较大(约 180,000 个令牌)。 完整知识库无法放入智能体的上下文,因此它会 针对每个问题搜索相关段落来作答,而不是一次性查看全部内容。这对语音智能体的影响 比文本更大,因为搜索会在语音交互中引入更明显的延迟。

较小的知识库在每次对话时会被整个读入;较大的则针对每个问题去搜索。标题就是 为搜索准备的。对于电话智能体,知识库里只放来电者真正会问的内容——你取消勾选的 页面,就是它不必再去搜索的页面。

你的团队在外呼通话中给出的答案

在外呼语音营销活动中,智能体可以在通话中途向你的团队提问,并把答案留下来。在 营销活动的 高级设置 里,找到 操作员输入收集:勾选 启用操作员输入收集, 然后在 “当操作员作答时,将答案保存到:” 下面选择答案存到哪里—— 仅营销活动常见问题(默认),或者智能体的知识库。

在营销活动页面上,问题在 需要输入 下面等待。输入答案并发送; 保存到智能体知识库(所有营销活动) 决定答案是否也进入智能体的知识库。答案会 汇集在 FAQ 栏里(应用里显示为英文),每一条都有 推送到知识库,可以 以后再加。加进去之后按钮变成 已推送到知识库 ✓;再点一次则 从知识库移除。

在知识标签页里,这些文档会显示 “来自” 加营销活动名称,点一下就会打开那个营销 活动。反过来,在 FAQ 里点一个已推送的问题,知识库会打开并高亮那一条。

问 Octo

这些 Octo 都能在聊天里做:列出某个智能体的来源、检查哪些文档被标记、哪些缺口 还没补、添加笔记、编辑文档,以及在你确认后重新抓取网站——“补习中心那个智能体 的知识库里,有什么需要修的?”、“我们的收费页面今天早上改了,重新抓一下。”

下一步

在客户之前先测一遍——问家长 会问的问题,把每个答案和你的文档对一遍。智能体应该做什么(而不是知道什么), 属于它的指令。