智能体在回答 API 相关问题时，可能只需要一份身份验证指南和一份端点参考。加载整个网站还会引入与该任务无关的内容。
llms.txt 提案为发布者提供了一个描述其内容并链接到有用 Markdown 页面的位置。
文件中包含什么？
文件包含项目名称，还可以包含摘要、使用指引以及分组链接，指向更多信息。
该提案使用 Markdown，以便人和程序可以处理同一文件。其链接列表指向智能体可以在需要时获取的内容。
文档索引可以将身份验证、消息发送和投递事件归入不同的标题下。简短的描述帮助智能体在下载之前区分这些目标页面。
该提案还允许在站点根目录以下放置索引。文档路径下的索引覆盖该路径下的内容。
它和 robots.txt 或站点地图一样吗？
这些文件用途各不相同：访问规则、URL 发现，以及通往内容的精选路径。
| 文件 | 用途 |
|---|---|
robots.txt | 为自动化客户端提供抓取规则 |
| 站点地图 | 列出 URL 供搜索引擎发现 |
llms.txt | 描述内容并链接到对智能体有用的详细页面 |
提案中与现有标准的对比将 llms.txt 描述为其他文件的补充。发布它并不会授予对受保护内容的访问权限。
它也不会暴露可执行的操作。智能体需要单独的 API 或 MCP 连接来执行工作区操作。
发布它能证明智能体在使用它吗？
发布可读索引只是确立了可用性。要证明有人使用，需要观察到客户端确实检索并使用了该内容。
Chrome 的 Lighthouse 审计会检查检索该文件时是否出现服务器错误。缺失的文件会收到不适用的结果，因为该文件是可选的。通过该检查并不能衡量智能体的回答质量。
在自行评估时，记录任务和客户端获取的文档。检查智能体是否得出了正确答案或完成了预期操作。在评估索引是否有帮助时，比较等效的运行结果。
访问日志中的请求证明发生了获取。仅凭这一点并不能证明客户端在回答中使用了该内容。引用建立的是另一种观察。在报告结果时，将这些结论分开。
应该向智能体提供哪些 Bird 文档？
当智能体需要发现文档并获取相关页面时，可以提供 Bird 的 llms.txt 索引。
机器可读文档指南介绍了索引、各个 Markdown 页面以及完整语料库。索引提供链接；各个页面让客户端获取有针对性的答案。
llms-full.txt 将文档与源 URL 合并在一起。这种较大的形式适合明确需要完整语料库的工作流，但受限于客户端的上下文容量。
在检索到操作说明后，如需执行消息发送任务，请连接 Bird 的 MCP 服务器。文档提供信息；经过身份验证的连接提供对工作区操作的访问权限。