Shopi8 原创中文封面:Shopify agents.md 和 llms.txt 要不要改

Shopify 的 agents.md 和 llms.txt 要不要改?先查这 5 件事

摘要

用 5 件事判断 Shopify 店铺是否需要自定义 agents.md、llms.txt 和 llms-full.txt。

看到 Shopify 开始支持自定义 agents.mdllms.txtllms-full.txt,很多店主会立刻想问:是不是今天就要加一个文件,不然 AI 搜索就看不到店铺?

先给结论:不用急着改文件。先打开你自己的 /agents.md 看默认内容,再判断商品页、集合页、政策页、FAQ、sitemap 和 robots 是否已经把事实说清楚。Shopify 的 agent 发现文件可以帮助 AI shopping agents 读取店铺入口,但它不是替代页面内容、商品数据、抓取权限和结构化数据的捷径。

背景解释:这 3 个文件解决的是入口说明

Shopify 在 2026 年 6 月更新了主题能力:商家可以通过 Liquid 模板自定义 /llms.txt/llms-full.txt/agents.md。Shopify 同时说明,每个店铺都有默认 agents.md,默认的 llms.txtllms-full.txt 会镜像这个 agent 文档。这个变化的意义是:你可以更清楚地告诉 AI shopping agents,哪些页面、商品信息、政策和店铺规则值得读取。

但这不等于“写一个 AI 文件就能被推荐”。Google Search Central 对 AI features 的公开说明仍然指向基础搜索要求:页面需要可抓取、可索引、内容有文本形式,并且不要用和页面可见内容不一致的结构化数据。OpenAI 对网站所有者的说明也把 crawler 访问控制放在 robots.txt 等标准机制里。换到 Shopify 上看,agents.md 更像一张店铺说明卡,sitemap 才是 URL 清单,robots.txt 才是抓取控制,商品页和政策页才是事实本体。

所以今天不要从“我要不要追一个新文件”开始,而要从“这个文件有没有把正确页面指给 AI,页面自己是否经得住读取”开始。文件能做的是引导,不是替你修商品信息。

Shopify agents.md llms.txt sitemap 和 robots.txt 四类文件作用对照
先分清文件角色,再决定要不要改主题模板。

具体例子/案例说明

下面 4 个例子都按同一条线看:原始问题 -> 判断过程 -> 改法 -> Shopify 落点。

类目 原始问题 判断重点 Shopify 落点
服装 只想把尺码表写进 llms.txt 尺码和退换规则是否在页面可见 商品页、尺码页、政策页、agents.md
美妆 成分卖点只放在 AI 文件里 商品页是否有同样的成分文本 Products、metafields、FAQ
家居 安装和保修说明藏在 PDF Agent 能不能找到 HTML 说明页 Page、Product block、内链
数字产品 授权范围在多处写法不同 文件摘要和页面条款是否一致 授权页、商品描述、FAQ

例子 1:服装店想把尺码表直接塞进 llms.txt

原始问题:一个女装店的商品页只有 S、M、L 选项,尺码表在弹窗里,退换政策页写“促销款不可退”,商品页却没有提醒。店主打算在 llms.txt 里写完整尺码和退换规则,希望 AI 搜索回答用户时能讲清楚。

判断过程:先打开商品页源码和渲染后的页面,确认腰围、臀围、衣长、模特身高、面料弹力和退换限制是否在可见文本里。再打开 /agents.md,看它是否能指向尺码页、配送退货页和重要集合页。如果页面本身没写清,AI 文件只是把不完整的站点说明了一遍。

改法:商品页增加“尺码选择”和“退换限制”两个可见模块;尺码页改成 HTML 表格,不只放图片;政策页和商品页用同一套促销款规则。agents.md 只写简短入口,例如“尺码指南:/pages/size-guide”“退换政策:/policies/refund-policy”。

Shopify 落点:Products 描述、商品页主题 block、Pages 尺码指南、Policies 退换政策、templates/agents.md.liquid

例子 2:美妆品牌把成分说明写进文件,但商品页没跟上

原始问题:一个护肤品牌在 AI 文件里写“适合敏感肌、含神经酰胺、无香精”,但商品页正文只有“舒缓修护精华 30ml”,成分表在第二张图片里。用户问“敏感肌能不能用”,AI 可能无法判断这些描述是否来自真实商品页。

判断过程:先查商品页是否有可复制的成分文本、适用肤质、使用频率和注意事项。再查 product metafields 是否存了成分、肤质、质地、容量这些字段,并且主题有没有把字段显示到前台。最后对照 agents.md:文件里写的店铺事实,不能比页面事实更激进。

改法:把成分、肤质和使用边界写回商品页;用 metafields 存结构化成分;FAQ 回答“敏感肌是否适合”“孕期是否可用”“白天能否使用”这类真实问题。AI 文件可以把品牌的成分说明页列出来,但不要把没有证据的功效承诺写成确定事实。

Shopify 落点:产品描述、product metafields、动态源、商品页 FAQ、品牌成分说明页、llms-full.txt.liquid

例子 3:家居品牌的安装和保修说明只有 PDF

原始问题:一个家居品牌卖壁挂收纳架,商品页写“安装简单”,保修说明在 PDF 说明书里,客服页有一段“安装需打孔”。用户问“租房能不能装”,AI 容易漏掉打孔和保修边界。

判断过程:先判断关键答案是否只有 PDF 或客服页面才有。PDF 可以保留,但核心信息应该在商品页或帮助中心有 HTML 版本。再看 sitemap 是否包含安装指南页,商品页有没有链接到这页,agents.md 是否列出安装、保修和退换入口。

改法:新建“安装与保修”页面,用短表格写清是否打孔、承重、墙面要求、安装工具、保修范围;商品页摘要写 3 行要点并链接到说明页;AI 文件只列入口,不替代完整说明。

Shopify 落点:Pages 安装说明、商品页信息 block、政策页、主菜单或页脚链接、sitemap、agents.md.liquid

例子 4:数字产品授权条款多处不一致

原始问题:一个数字模板店的商品页写“个人和商业可用”,FAQ 写“不可转售”,结账后邮件写“仅个人使用”。店主准备在 agents.md 里写一句“所有模板支持商业使用”。

判断过程:先不要改 AI 文件。把商品页、授权页、FAQ、邮件模板和退款政策放在一起看,找出同一个问题的不同答案。AI 文件如果摘要了错误条款,只会把错误扩散到更多入口。

改法:建立一个稳定授权页,按“可用于什么、不可用于什么、团队账号是否允许、是否可退款”写清楚;每个商品页只保留与该商品有关的授权摘要;FAQ 和邮件模板同步。agents.md 可以指向授权页,并说明“以授权页为准”。

Shopify 落点:数字商品页、Pages 授权条款、FAQ、订单邮件模板、退款政策、templates/agents.md.liquid

Shopify agents.md 和 llms.txt 发布前的五项检查流程
判断是否要改 AI 文件,先看页面事实和维护成本。

实战方法:先查这 5 件事

抽 3 个最重要集合、5 个最重要商品、2 个政策或帮助页面,按下面清单做一次小范围检查。不要先全站铺文件,先确认文件里要写的内容是否可靠。

检查项 具体看什么 不通过时先改哪里
默认文件 打开 /agents.md、/llms.txt、/llms-full.txt 记录缺少的入口,不急着重写
页面事实 商品、集合、FAQ、政策是否有同样事实 先改页面正文和字段
抓取状态 robots.txt、sitemap、canonical、noindex 别把重要页面挡住
结构数据 Product、Article、Organization 是否和正文一致 清掉冲突 schema
维护规则 谁更新、多久查一次、是否自动读取字段 少写硬编码库存和促销
  1. 在浏览器打开 https://你的域名/agents.md,把里面列出的页面和你希望 AI 读取的页面做对照。
  2. 再打开 /llms.txt/llms-full.txt,看它们是否只是默认镜像,还是已经被主题模板改过。
  3. 用 Google Search Console 或浏览器源码检查重要页面是否可抓取、可索引,并且没有错误 canonical。
  4. 把文件里准备写的每一句店铺事实,回到 Shopify 商品页、集合页、FAQ、政策页找对应文本。
  5. 如果缺口主要在页面,不改文件;如果页面已经清楚,只是 agent 入口缺失,再改 Liquid 模板。

Shopify 页面怎么改:不要让文件和页面各说各话

商品页负责商品事实:名称、适用人群、规格、材质、成分、库存、价格、限制和 FAQ。集合页负责分类和比较:这个集合适合什么场景,筛选项代表什么,商品之间差异在哪里。政策页负责交易边界:配送、退货、保修、订阅、数字产品授权、地区限制。

agents.md 可以做入口层:品牌是谁、主要集合是什么、哪些政策页重要、客服入口在哪里、哪些页面能解释购买前常见问题。它适合短,不适合写成另一个完整网站。llms-full.txt 可以更长,但也不要把全站商品描述硬复制进去,尤其不要复制会频繁变化的库存、限时优惠和临时活动。

主题代码里可以新增或调整 templates/agents.md.liquidtemplates/llms.txt.liquidtemplates/llms-full.txt.liquid。如果你是用 Shopify 后台编辑主题,先备份主题,再在预览环境测试输出。更稳的做法是从动态字段读品牌说明、重要集合、政策链接和帮助页链接,少写死商品列表。

结构化数据仍然要和页面一致。Product schema 里的 name、brand、sku、offers、availability 不要和商品页可见内容冲突;Organization schema 的品牌名、logo、社媒链接不要和首页、关于页不一致。AI 文件只做导航摘要,底层事实还是要回到页面、字段和主题输出。

Shopify agents.md llms.txt 修改要同步主题模板商品页政策页和数据检查
文件、页面、字段和数据检查要连起来看。

一个可直接套用的 agents.md 简版结构

下面不是标准答案,只是一个安全起点。把它当成入口清单,不要把它写成广告页。

# Brand name
Short description: what the store sells, for whom, and in which markets.

Important shopping pages:
- Main collections: /collections/...
- Buying guides: /blogs/...
- Size or compatibility guide: /pages/...

Product facts:
- Product pages include price, variants, availability, materials, usage limits and FAQ.
- Policy pages explain shipping, returns, warranty and digital license terms.

Use these pages for current rules:
- Shipping: /policies/shipping-policy
- Returns: /policies/refund-policy
- Contact: /pages/contact

如果你有多语言或多市场页面,不要只在英文文件里写中文市场事实,也不要把美国政策写给加拿大、英国或欧盟页面。先把多地区 URL、页面正文、hreflang、canonical 和政策页做好,再决定不同语言文件怎么输出。

常见误区:这些事不用急着做

误区一:以为 llms.txt 是新的排名开关。它更像公开摘要和入口,不等于搜索排名、引用资格或 AI 推荐资格。

误区二:用 AI 文件替代商品页改写。文件里说得再清楚,商品页没有同样事实,用户和搜索系统仍然会看到断层。

误区三:把 robots.txt 和 llms.txt 混为一谈。robots.txt 用来表达抓取规则,llms.txt 和 agents.md 不应该承担访问控制。

误区四:把所有商品、所有促销、所有库存都硬写进文件。更新成本一高,最容易出现旧价格、旧政策和失效链接。

误区五:写看起来很聪明但页面无法证明的品牌承诺。AI 文件只应该摘要站内能被用户看到、能被你长期维护的事实。

FAQ

Shopify 店铺现在一定有 agents.md 吗?

Shopify 官方变更说明写到,每个店铺都有默认 agents.md,默认 llms.txtllms-full.txt 会镜像这个文件。你可以直接打开自己的域名加 /agents.md 查看。如果没有看到预期内容,先确认店铺、主题和访问状态,再看是否被自定义模板覆盖。

改了 agents.md,Google AI 搜索就会引用我吗?

不能这样判断。Google 对 AI features 的说明没有要求额外的 AI 专用文本文件;基础仍然是可抓取、可索引、页面内容清楚、结构化数据和可见文本一致。agents.md 可以帮助部分 agent 理解入口,但不能替代 SEO 和页面质量。

llms.txt 和 sitemap.xml 有什么区别?

sitemap.xml 是给搜索系统发现 URL 的标准文件,通常包含页面地址和更新时间等信息。llms.txt 更像给语言模型或 agent 阅读的资源摘要。Shopify 店铺不要因为做了 llms.txt 就忽略 sitemap、canonical、robots 和页面内链。

可以用 llms.txt 阻止 AI 抓取内容吗?

不要这样用。访问控制应看 robots.txt、页面权限、登录限制、noindex 或服务器层规则。llms.txtagents.md 更适合说明店铺入口和重要资源,不是抓取屏蔽工具。

小店需要马上自定义这些文件吗?

不一定。商品少、页面结构清楚、政策页完整的小店,可以先用默认文件,再观察 AI 搜索和 agent 渠道是否经常漏读关键页面。真正值得马上改的是这类店:有大量集合、复杂政策、多语言市场、数字授权、B2B 规则或重要内容散在多个页面。

这些文件应该谁来维护?

内容负责人定入口和事实边界,主题开发者负责模板输出,运营负责在商品、集合、政策更新后复查。最容易出问题的是无人维护的硬编码列表。建议每月抽查一次 /agents.md/llms.txt 和重要页面是否一致。

下一步阅读

如果你正在做 GEO 基础整理,可以继续看 GEO / AI 搜索栏目。如果不确定自己的网站是页面信息、主题代码还是数据追踪出了问题,先走一遍 独立站诊断入口。商品页说服力弱,可以看 商品页与转化优化;准备上线或改版前,再用 Shopify 上线检查清单 把基础项过一遍。

分享这篇文章

阅读说明

这些文章更适合当作排查笔记,而不是万能模板。

这篇文章适合怎么读?

先看结论和步骤,再对照自己的网站情况判断是否适用。涉及代码或后台设置的部分,建议先在预览主题或测试环境里试。

可以直接照着改吗?

有些步骤可以直接参考,有些要看主题结构、App、页面内容和当前业务阶段。不要在正式主题上直接试,先备份或用预览主题验证。

代码片段需要注意什么?

不同主题的 section、snippet 和 CSS 结构不一样。复制代码前先确认文件位置和命名,改完后检查桌面端、移动端和购物流程。

后续还会补充吗?

会。内容会围绕建站流程、主题代码、页面优化、速度排查和工具实测慢慢补,不追热点,优先写实际遇到的问题。

我的情况和文章不一样怎么办?

可以先把网站链接、页面现象和你已经尝试过的操作记下来,再决定是继续自查,还是发来让我帮你判断问题类型。

继续看 Shopify 实操笔记

如果这篇文章解决了一部分问题,可以回到博客列表继续看相关笔记;如果情况不一样,再带着页面和现象来判断。

返回博客列表 发来问题