llms.txt 文件，列出文档中的所有可用页面。该文件始终保持最新且无需维护。你也可以在项目根目录添加自定义的 llms.txt 文件。
根据你的站点配置，认证对
llms.txt 和 llms-full.txt 的影响有所不同：- 完全认证站点：两个文件都需要认证。无法通过认证的 AI 工具将无法访问这些文件。
- 部分认证站点：两个文件均可公开访问，但仅列出公开页面，不包含受用户分组限制的页面。
/llms.txt 追加到你的文档站点 URL 后查看 llms.txt。Mintlify 还会在 /.well-known/llms.txt 托管该文件，以兼容采用 .well-known 约定的工具。
Mintlify 会在每个页面的响应中添加 HTTP 标头，以便 AI 工具无需事先知道位置即可发现你的 llms.txt 文件：
Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"：遵循标准 HTTPLink标头格式，用于资源发现。X-Llms-Txt: /llms.txt：一个便捷标头，供检查llms.txt支持情况的工具使用。
llms.txt 文件结构
llms.txt 文件是一个纯 Markdown 文件，包含：
- 以 H1 标题形式呈现的站点标题。
- 站点描述，以引用块形式显示在标题下方，来源于
docs.json配置中的description字段。 - 自定义代理指令，如果你在
docs.json中设置了markdown.instructions，则会作为Agent Instructions块出现在描述之后。 - 结构化内容部分，包含链接以及文档中每个页面的说明。
- 指向 OpenAPI 和 AsyncAPI 规范的 API 规范链接 (如果文档中包含这些规范) 。
llms.txt 文件会按照页面在存储库中的位置，以字母顺序列出，从根目录开始。llms.txt 文件中的页面链接包含 .md 扩展名，以便 AI 工具可以直接获取每个页面的 Markdown 版本。
每个页面的说明来自其 frontmatter 中的 description 字段。说明会在达到 300 个字符或遇到第一个换行符时被截断。对于 API 参考页面，说明中还会包含来自 openapi 或 api frontmatter 字段的规范信息。没有 description 字段的页面将在 llms.txt 中显示，但不含说明。
这种结构化方法使 LLM 能够高效地从宏观层面处理你的文档，并为用户查询定位相关内容，从而提升 AI 辅助文档搜索的准确性和速度。
自动生成的
llms.txt 文件上限为 100,000 个字符。如果你的文档超过此限制，Mintlify 会截断该文件，并附加一条说明列出被省略的页面数量。若要不经截断列出所有页面，请在项目根目录添加一个自定义 llms.txt 文件。Example llms.txt
llms-full.txt
llms-full.txt 文件会将你的整个文档站点整合为一个文件，供 AI 工具作为 context 使用，并用于 LLM 索引。
Mintlify 会在你的项目根目录自动托管一个 llms-full.txt 文件。你可以在文档站点的 URL 末尾追加 /llms-full.txt 来查看该文件。Mintlify 还会在 /.well-known/llms-full.txt 托管该文件，以兼容采用 .well-known 约定的工具。
自定义文件
llms.txt 或 llms-full.txt 文件，请在项目根目录创建同名文件。添加自定义文件会覆盖同名的自动生成文件。如果你删除自定义文件，Mintlify 会恢复使用同名的自动生成文件。
自定义的 llms.txt 或 llms-full.txt 文件必须包含一个以 H1 标题呈现的站点标题。其他内容为可选。有关可选部分和最佳实践的更多信息，请参阅 llms.txt 规范中的Format。