The Papers

指南

如何为客服机器人和 AI 智能体提供唯一可信的产品文档来源

为每类产品事实——规格、限制、套餐、政策——选定一份规范文档,以 AI 工具易读的文本格式发布在永久链接上,并让您的客服机器人、内部智能体和公共 AI 爬虫都指向该链接,而不是指向副本。对它进行版本管理并原地更新,让每个机器人都基于同一份最新、经过核对的内容作答。

为什么机器人会给出不同的答案

客服机器人根据它拿到的资料作答:帮助中心导出文件、旧的 PDF 规格书、某人去年复制的 wiki 页面。公共助手则根据它在网上找到的任何内容作答。当同一个事实存在于五个地方时,每个机器人都会挑中不同的那一个。

结果就是机器人引用已废弃的限制、去年的价格,或者只在某个套餐中才有的功能——而客户却信以为真。

确定可信来源是什么

其他所有副本——幻灯片、新用户引导邮件、销售演示文稿——都应链接到规范文档,而不是重新陈述其内容。

事实类型规范文档负责方
规格与限制每个产品的规格书产品
套餐与价格套餐文档产品营销 / 财务
政策(退款、SLA、数据)政策文档法务 / 客服
操作指南与故障排除帮助中心文章客服 / 文档
版本变更更新日志产品

撰写机器人能据以正确作答的文档

  • 一个事实,一个位置,一种措辞。不要在三篇文章中重复陈述限制。
  • 写限制和数字时注明单位和范围:“Team 套餐每个工作区最多 10 GB”。
  • 说明某项陈述适用于哪个套餐、版本或地区。
  • 为会变化的事实标注日期,并清楚标记已弃用的功能。
  • 使用真正的标题和表格;避免使用设置界面或表格的截图。
  • 在每份文档开头放一段简短摘要,回答最常见的问题。

把机器人连接到来源

  • 将客服机器人的知识来源指向规范文档,最好使用 Markdown 或 JSON 而不是 PDF。
  • 发布列出规范文档的数据室索引(llms.txt),让外部 AI 工具能够发现它们。
  • 每当规范文档变更时重新同步机器人,或让它直接读取实时链接。
  • 审查机器人对话记录,找出无法追溯到规范文档的回答。

The Papers 的定位

The Papers 将每份规范文档发布为位于永久 URL 的 AI 版本:面向人的网页、带 front matter(规范 URL、版本、状态、AI 就绪度)的 Markdown,以及包含内容块、指标和页面出处的 JSON。位于 /{room}/llms.txt 和 /{room}/index.md 的数据室索引会列出每一份文档。

发布前,每个数字、日期和期间都必须与源文件一致,“最多”等限定语保持附着。更新文档时 URL 和版本历史保持不变,因此机器人和公共助手读取的始终是当前版本。分析数据会显示哪些 AI 智能体、爬虫和工具读取了每份文档,以及使用了哪种格式。

公开文档可以被列出和索引,ai.yourcompany.com 这样的自定义域名能让数据室位于您自己的地址。它适合您的关键参考文档;并非为不经逐份保真核对就批量转换整个档案库而设计。

常见问题

帮助中心本身应该作为可信来源吗?
对于操作指南类内容,通常可以。对于限制、套餐和政策等硬性事实,由帮助文章链接到一份规范文档更容易保持准确。
客服机器人应该读取哪种格式?
Markdown 或 JSON 等文本格式比 PDF 更便于检索,也更不容易出错。The Papers 会为每份文档同时发布这两种格式。
公共 AI 助手如何找到我们的文档?
将规范文档设为公开且可索引,并在 llms.txt 索引中列出,让 AI 工具和爬虫能够发现它们。
文档变更时链接会怎样?
使用 The Papers,URL 保持不变,版本历史也会保留,因此所有指向它的链接都不会失效。

在一个永久链接上,为每个机器人和智能体提供同一份最新的产品事实。

相关指南