AGENTS.md vs llms.txt
两个文件,两种职责
它们都位于根目录,都面向智能体,但回答的问题不同:
| llms.txt | AGENTS.md | |
|---|---|---|
| 回答 | "这里有什么？" | "在这里该如何行事？" |
| 形式 | 带单行摘要的 markdown 链接索引 | 自由格式的 markdown 指令 |
| 起源于 | 文档站点(llmstxt.org) | 代码仓库,面向编码智能体 |
| 读者 | 正在了解网站的智能体 | 即将在此开展工作的智能体 |
| 类比 | 给机器看的站点地图 | 写给机器的 README |
llms.txt 是精选索引: 关键 URL 加单行描述,智能体一次抓取就能了解你的表面。AGENTS.md 是散文式指令: 约定、可为与不可为、如何运行 —— 编码智能体在动手之前会在仓库里寻找的文件,如今正扩散到仓库之外。
为什么店面突然有了 AGENTS.md
Shopify 让这一约定在商业网络上成为主流: 每个 Shopify 店铺现在默认提供 /agents.md,并且 —— 根据 Shopify 自己的主题文档 —— Shopify 通过镜像 /agents.md 的内容来管理 /llms.txt,/llms-full.txt 也指向同处。商家可以用 Liquid 模板(templates/agents.md.liquid、templates/llms.txt.liquid、templates/llms-full.txt.liquid)覆盖三者中的任何一个。一份指令文件,三个入口。
这个设计选择很能说明问题: 当被迫选择单一事实来源时,Shopify 选择了指令文件,并从它生成索引。
你该发布哪个？
- 你有文档或 API → 先发布 llms.txt。索引你的关键页面,并交叉引用你的 MCP 端点和 OpenAPI 规范。
- 智能体在你的网站上交易或操作(结账、预订、客服流程) → 添加带行为指令的 AGENTS.md: 智能体可以做什么、频率预期、机器可读路径在哪里。
- 两者都发布是稳妥的默认。它们能干净地互相引用: llms.txt 把 AGENTS.md 链接为"操作指南",AGENTS.md 把 llms.txt 链接为"索引"。
不要把它们与 agents.txt(一个访问策略提案)或 robots.txt(爬取权限)混淆。四个根文件,四种职责: 权限、策略、索引、指令。
常见问题
AGENTS.md 是标准吗？
它是约定,不是规范 —— 背后没有正式的标准组织。它的力量在于采用度: 编码智能体会在仓库中寻找它,Shopify 为每个店面默认提供它。
AGENTS.md 会取代 llms.txt 吗？
不会 —— 它们回答不同的问题,Shopify 的镜像设计展示了两者如何共存: 指令是源,索引是视图。只有 AGENTS.md 的网站失去了一次抓取的链接索引;只有 llms.txt 的网站没有给智能体任何行为指引。
AgentGrade 检查 AGENTS.md 吗？
扫描器的发现类检查以 llms.txt 为中心 —— 在"这里有什么"这个职责上,它仍是更广泛的约定 —— 同时检查它是否交叉引用了你的其他机器文件。扫描你的网站,看看你的根文件现在告诉智能体什么。