一文读懂 Shopify 网站 llms.txt 与 agents.md 及如何自定义修改完善 助力 AI 跨境电商
背景介绍
在 Agentic Commerce（智能体电商）快速发展的背景下，AI 爬虫和智能体如何理解并与电商网站交互成为核心议题。llms.txt 规范旨在为大语言模型（LLMs）提供精简的网站内容地图；而随着 2026 年初 Google 与 Shopify 联合推出的通用商业协议 (Universal Commerce Protocol, UCP)，agents.md 作为更高级的 “智能体操作手册” 应运而生。Shopify 平台在 2026 年 5 月底自动为所有店铺部署了这两个文件，并确立了 agents.md 的规范地位。本文将深入探讨这两个文件在 Shopify 生态中的用途、必要性、它们共存的深层设计意图，以及如何进行自定义修改。
1. llms.txt 规范的起源与用途
1.1 起源与定义
llms.txt 是由 Answer.AI 的 Jeremy Howard 于 2024 年 9 月提出的一项标准提案。其核心理念是：传统的网页结构（包含导航、广告、复杂的 JavaScript 等）对于上下文窗口有限的大语言模型来说，解析困难且效率低下。因此，提案建议在网站根目录添加一个名为 /llms.txt 的 Markdown 文件，专门为 LLMs 提供友好的、结构化的网站背景信息、核心内容摘要以及指向详细 Markdown 文件的链接。
1.2 在网站中的用途
与用于搜索引擎索引的 sitemap.xml 或用于访问控制的 robots.txt 不同，llms.txt 的作用是推荐与引导。它就像是书籍的索引，告诉 AI 哪些页面最重要，以及每个页面的核心内容是什么。其典型结构包括：
- 网站/项目名称（必需）
- 简短的背景摘要
- 核心内容和文档的链接列表（带简要说明）
- 可选的次要信息链接
1.3 在电商环境下的局限性
尽管 llms.txt 能有效帮助 AI 了解 “这个网站是关于什么的”，但它仅停留在信息描述层面。对于电商网站而言，AI 智能体不仅需要知道商店卖什么，还需要知道如何搜索商品、如何构建购物车、如何结账以及遵守哪些交易规则。这超出了 llms.txt 的设计初衷。
2. agents.md 的背景与 UCP
2.1 Agentic Commerce 与 UCP
2026 年 1 月，在 NRF（全美零售业联盟）展会上，Google 宣布与 Shopify 联合开发了通用商业协议 (Universal Commerce Protocol, UCP)。UCP 是一个开放标准，旨在让 AI 智能体能够与任何商户连接并完成交易。
UCP 将商业交易抽象为多个层级：
- 核心购物服务：定义结账会话、订单项、总价等基础原语。
- 能力 (Capabilities)：如结账、订单管理、目录搜索等。
- 扩展 (Extensions)：商户可自定义的特定领域模式（如特定的履约方式或忠诚度积分）。
在 UCP 架构中，商户和 AI 智能体都需要声明各自支持的 “能力”，通过动态协商（Negotiation）来确定如何完成交易。
2.2 agents.md 的用途与必要性
为了配合 UCP 协议，agents.md 应运而生。如果说 llms.txt 是品牌简介，那么 agents.md 就是智能体操作手册。它是一份面向 AI 的 Markdown 规范，详细描述了网站的交互能力。
在 Shopify 平台上，agents.md 的核心内容通常包括：
- UCP 发现流程：指向
/.well-known/ucp的 JSON 配置文件，声明商户支持的 UCP 版本和能力。 - MCP（模型上下文协议）端点：提供 AI 智能体可以直接调用的 API 地址（如
/api/ucp/mcp），用于实时查询库存、构建购物车等。 - 交易规则与限制：例如明确规定结账必须由人类买家明确批准、MCP 端点的速率限制、以及必须传递买家上下文（国家、货币）以获取正确报价。
3. Shopify 平台的设计意图：为什么两者共存？
2026 年 5 月28 日，Shopify 在未发布广泛公告的情况下，自动为平台上的数百万个店铺启用了四个面向智能体的端点：/llms.txt、/agents.md、/.well-known/ucp 和 /sitemap_agentic_discovery.xml。
3.1 共存现象的表象
在默认情况下，Shopify 的 /llms.txt 和 /llms-full.txt 实际上是指向 /agents.md 的内容。这意味着除非商家主动覆盖，否则这三个路径返回的是相同的、由 Shopify 生成的默认内容（在未修改完善的情况下内容基本相同）。
3.2 深层设计意图
Shopify 采取这种架构设计，主要基于以下战略考量（滑动查看表格内容）：
| 设计考量 | 详细分析 |
|---|---|
| 向下兼容与过渡 | /llms.txt 在 2024-2025 年间获得了广泛关注，许多早期的 AI 爬虫和工具已经习惯于请求这个路径。保留该路径可以确保兼容早期的 AI 系统。 |
| 确立 agents.md 的规范地位 | Shopify 通过其后备链（Fallback chain）机制，明确将 agents.md 确立为规范（Canonical）文件。这表明 Shopify 认为，对于电商而言，描述“如何交易”的规范比仅仅描述“这是什么”的规范更为重要。 |
| 平台级流量路由与控制 | Shopify 自动生成的默认 agents.md 会引导 AI 智能体使用 Shopify 的 Shop 技能和 Shop Pay 进行跨店交易。通过控制这个入口，Shopify 将 AI 驱动的购物流量锁定在其自身的支付和生态系统内。 |
| 灵活性与定制化 | Shopify 允许商家通过 Liquid 模板分别覆盖这些文件。对于复杂的跨国商店（Shopify Markets）或受监管商品（如酒精、处方药），商户可以定制 agents.md 以声明特定的交易限制，同时保持 llms.txt 作为纯粹的品牌宣传。 |
4. 结论与建议
对于 Shopify 网站而言，llms.txt 和 agents.md 并非重复冗余，而是代表了 AI 时代网页信息化的两个不同演进阶段。llms.txt 解决了“信息被 AI 读取”的问题，而 agents.md 结合 UCP 协议，解决了“让 AI 替人类操作和购买”的问题。
两者共存是 Shopify 有意为之的平台战略：既兼容早期的信息抓取标准，又强力推行其主导的智能体电商（Agentic Commerce）交易标准。
对 Shopify 商家的建议：
- 不要将其视为传统 SEO 工具：
agents.md的核心价值在于控制 AI 智能体如何描述和操作你的店铺。 - 重视 agents.md 的定制：如果默认的 Shopify 模板不符合品牌利益，例如：不希望流量被强制导向 Shop Pay（大部分国内 Shopify 店铺根本没有开通它）、默认内容末尾 Platform 部分的创建 Shopify 店铺和开发者文档链接更像是 Shopify 植入的广告，应通过主题代码覆盖。
- 处理多区域陷阱：对于使用 Shopify Markets 的跨国商店，必须在 Liquid 模板中添加逻辑，确保向 AI 提供正确的区域定价和货币信息，否则会导致 AI 报价与实际结账价格不符。
- 优先优化核心内容：在配置好基础的智能体文件后，仍应将主要精力放在高质量的网站内容、结构化数据（JSON-LD）以及清晰的商品描述上，这些是 AI 理解网站的基石。