指令告诉智能体怎么表现,知识库告诉它什么是事实——你的课表、你的收费、你的 规定。当家长问枫街补习中心 “初三数学班多少钱?” 时,答案应该来自你写的某一页, 而不是模型的想象。
每个智能体都有自己的知识库,它服务于这个智能体接听的所有渠道:电话、WhatsApp、 网站聊天、邮件。填一次就够。
在哪里
从 /agents 打开智能体,选择 知识 标签页。同一个页面也在 /agents/knowledge——没选智能体时,它会提示 “选择一个智能体以管理其知识库。”
顶部是 添加文档 和 添加网站,下面是一个拖放文件的区域。再往下是三张卡片:
| 卡片 | 里面有什么 |
|---|---|
| 来源 | 你添加的每一个网站、文件或一组粘贴的笔记,附带状态、生成了多少篇文档、有多少篇被标记,以及抓取时间 |
| 全部文档 | 智能体能用来作答的每一篇文档。点一个来源会缩小到 来源中的文档;再点一次则显示全部 |
| 知识缺口 | 没能读取的网页和文件,等你把内容粘贴进来 |
添加你的网站
添加网站 会打开一个对话框,只有一个字段 网站 URL 和一个 查找页面 按钮。你输入什么,决定了会发生什么:
- 只输入域名——
maplestreettutoring.example——读取网站的站点地图,按栏目 列出找到的每一个页面:classes、fees、blog……看起来对回答问题有用的栏目 会替你勾上,其余的不勾。 - 单个页面——
maplestreettutoring.example/fees——只列出这一页,并且已勾选。
把智能体用不到的取消勾选——旧博客文章、新闻、标签页——或者用 全选 / 取消全选。站点地图漏掉的页面填进 添加更多 URL(每行一个)。底部的按钮 会显示你选了多少,比如 抓取 12 个页面,点它就开始抓取。每次抓取最多选 500 个页面;网站更大的话,分几次抓。
如果看到 “未在该 URL 发现任何页面。请尝试其他地址。”,说明这个网站没有可读取 的站点地图。请把你要的页面一个一个地输入,写完整的页面网址。
抓取在后台进行:来源先显示一个加载图标,然后变成 就绪。你也可以直接让 Octo 做——“给补习中心的智能体抓取 maplestreettutoring.example”——它会按栏目、 按可能的有用程度排好页面,让你挑选。
上传你的文件
把文件拖到拖放区域——“将文件拖放到此处,或”——或点 浏览文件。可以一次 添加多个;每个上传完成后会显示一个勾,读取会在后台继续。支持的格式:
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 都能在聊天里做:列出某个智能体的来源、检查哪些文档被标记、哪些缺口 还没补、添加笔记、编辑文档,以及在你确认后重新抓取网站——“补习中心那个智能体 的知识库里,有什么需要修的?”、“我们的收费页面今天早上改了,重新抓一下。”
下一步
在客户之前先测一遍——问家长 会问的问题,把每个答案和你的文档对一遍。智能体应该做什么(而不是知道什么), 属于它的指令。