跳到内容

Instructor 采用 llms.txt:让文档更便于 AI 理解

我们很高兴地宣布,Instructor 现在实现了 llms.txt 规范!您现在可以在 python.useinstructor.com/llms.txt 找到我们的 llms.txt 文件。此次采用标志着我们朝着让文档更易于 AI 语言模型访问迈出了重要一步。

什么是 llms.txt?

llms.txt 规范由 Jeremy Howard 和 Answer.AI 团队开发,解决了 AI 与文档交互中的一个关键挑战:大多数网站的上下文窗口太小,并且包含导航、广告和 JavaScript 的 HTML 页面难以被 LLM 有效处理。

可以将 llms.txt 视为 AI 语言模型的 robots.txt——一种帮助 AI 系统理解和导航文档的标准化方法。虽然 robots.txt 告诉搜索引擎可以索引哪些内容,但 llms.txt 帮助 AI 模型找到并理解有关您项目的最相关信息。

为什么 Instructor 采用 llms.txt

作为一个专注于 LLM 结构化输出的库,我们实施这一标准是完全合理的。原因如下:

  1. 更好的 AI 集成:我们的用户经常通过 AI 编码助手与 Instructor 交互。拥有 llms.txt 文件有助于这些工具更好地理解我们的文档。

  2. 更清晰的文档访问:AI 模型现在可以直接访问我们文档的干净 Markdown 版本,而无需解析完整的 HTML 文档。

  3. 支持标准:我们相信标准化 AI 模型与文档交互方式的重要性。通过尽早采用 llms.txt,我们正在帮助建立对 AI 友好的文档的最佳实践。

这对用户意味着什么

如果您在使用 Instructor 时使用 GitHub Copilot、Claude 或 Cursor 等 AI 编码助手,您应该会注意到:

  • 更准确的代码建议
  • 更好地理解 Instructor 的功能
  • 更相关的文档引用

例如,当您向 AI 助手询问 Instructor 的功能时,它现在可以通过 llms.txt 文件直接访问我们的 Markdown 文档,而无需尝试解析我们的 HTML 文档。

工作原理

我们的 llms.txt 文件提供了:

  • Instructor 的简明概述
  • 关键文档的 Markdown 格式链接
  • 关于用法和最佳实践的重要说明
  • 示例代码和教程的参考

AI 模型可以使用这些信息更好地理解:

  • Instructor 的核心概念
  • 如何使用我们的关键功能
  • 实施的最佳实践
  • 在哪里找到详细文档

实施 llms.txt

llms.txt 规范正在得到广泛采用,我们鼓励其他 Python 库和框架也实施它。以下是如何将 llms.txt 添加到您的项目中:

  1. 在您的文档根目录下创建 /llms.txt 文件
  2. 遵循标准格式
  3. 包含关键信息和 Markdown 链接
  4. 使用各种 AI 助手进行测试

展望未来

这仅仅是个开始。随着越来越多的项目采用 llms.txt,我们期望看到:

  • 更好的 AI 辅助编码体验
  • 更标准化的文档访问
  • 提高 AI 对代码库的理解
  • 增强人与 AI 之间的协作

我们很高兴能成为建立此标准的一份子,并期待看到它如何发展。如果您有兴趣了解更多关于 llms.txt 的信息或想讨论其实现,请在 GitHubTwitter 上联系我们。

有关 llms.txt 规范的更多详细信息,请查看官方仓库,并加入关于如何使文档更对 AI 友好的讨论。

祝您编码愉快!