¿Qué es agents.md y para qué sirve en una tienda?

Si buscas agents.md, puedes encontrarte con dos archivos que comparten nombre y propósito general, hablar a un agente de IA en Markdown, pero que viven en sitios distintos. Uno es AGENTS.md, el archivo que los equipos de software ponen en sus repositorios para que los agentes de programación sepan cómo trabajar en ellos. El otro es /agents.md, el archivo que Shopify sirve en la raíz de cada tienda para que los asistentes de compra sepan qué vende y cómo consultarla. Si tienes una tienda, el que te afecta es el segundo, y probablemente ya lo tienes publicado sin haberlo escrito.

Qué incluye

El formato original es AGENTS.md, que su sitio describe como un README para agentes: un lugar fijo y previsible donde dar el contexto y las instrucciones que necesita un agente de programación para trabajar en un proyecto. Es Markdown sin campos obligatorios; suele llevar la descripción del proyecto, los comandos para compilar y probar, el estilo de código y las instrucciones de despliegue. Lo usan más de 60.000 proyectos de código abierto, lo leen herramientas como Codex de OpenAI, Jules de Google, Cursor o Aider, y lo mantiene como formato abierto una fundación dentro de la Linux Foundation. En un repositorio con varios AGENTS.md, manda el más cercano al archivo que se está editando.⁠^{[1]agents.md (Agentic AI Foundation, Linux Foundation). AGENTS.md}

Shopify tomó el nombre para otra cosa. En una tienda, /agents.md es la descripción canónica de la tienda pensada para agentes. Según su documentación, recoge los puntos de descubrimiento de UCP (Universal Commerce Protocol) y el punto de acceso de MCP (Model Context Protocol), unas URL de solo lectura para consultar productos, colecciones y búsquedas, las políticas publicadas de la tienda y orientación para asistentes de compra como el Shop skill.⁠^{[2]Shopify Dev Docs. agents.md.liquid} UCP es el protocolo con el que un agente descubre qué sabe hacer un comercio: cada negocio publica su perfil en /.well-known/ucp, y desde ahí la plataforma del agente localiza los puntos de acceso y negocia lo que puede hacer.⁠^{[3]ucp.dev. Universal Commerce Protocol: specification overview (2026-04-08)}

Cuatro detalles de cómo lo sirve Shopify:

• Se genera solo. Shopify crea un agents.md por defecto para cada tienda, y la plantilla propia solo hace falta para necesidades avanzadas que el archivo gestionado no cubre.⁠^{[2]Shopify Dev Docs. agents.md.liquid}
• Hay uno por tienda, no por idioma. Se sirve en el dominio principal, sin prefijo de idioma ni de mercado, y no tiene versión traducida.⁠^{[2]Shopify Dev Docs. agents.md.liquid}
• Es el archivo de referencia para otros dos. Las URL /llms.txt y /llms-full.txt repiten por defecto el contenido de /agents.md. Si el tema no tiene una plantilla para una de esas rutas, Shopify usa la de agents.md y, si tampoco existe, el texto que genera él.⁠^{[2]Shopify Dev Docs. agents.md.liquid} Esas plantillas se pueden personalizar desde el 28 de mayo de 2026.⁠^{[4]Shopify developer changelog. Customize /llms.txt, /llms-full.txt and /agents.md}
• Su plantilla ve muy poco. En agents.md.liquid solo funcionan dos objetos de Liquid, request y agents; los habituales, como shop o collections, no. El objeto agents trae el nombre y la URL de la tienda, la URL de descubrimiento UCP, la del punto de acceso MCP, las versiones de UCP, la moneda y la URL del sitemap XML.⁠^{[2]Shopify Dev Docs. agents.md.liquid}

En una tienda

Así podría leerse el /agents.md de una tienda pequeña de cerámica. Es un ejemplo ficticio: la tienda y las rutas están inventadas, y en una tienda real las URL las rellena Shopify.

# Cerámica Ejemplo

> Tienda online de cerámica de gres hecha a mano, con envío a España y Portugal.
> Precios en EUR.

## Para agentes de compra

- Descubrimiento UCP: https://ceramica-ejemplo.com/.well-known/ucp
- Punto de acceso MCP: https://ceramica-ejemplo.com/ruta-mcp-de-ejemplo

## Consultar el catálogo (solo lectura)

- Todas las colecciones: https://ceramica-ejemplo.com/collections
- Buscar: https://ceramica-ejemplo.com/search?q=taza

## Políticas

- Envíos, devoluciones y privacidad: https://ceramica-ejemplo.com/policies/

Si necesitaras cambiarlo, crearías templates/agents.md.liquid en el editor de código del tema, y ese cambio pasaría también a /llms.txt y /llms-full.txt mientras no tengan plantilla propia.⁠^{[4]Shopify developer changelog. Customize /llms.txt, /llms-full.txt and /agents.md} Una versión mínima que solo usa los datos que Shopify pone a disposición de esa plantilla:⁠^{[2]Shopify Dev Docs. agents.md.liquid}

# {{ agents.store_name }}

Tienda online de cerámica de gres hecha a mano. Precios en {{ agents.currency }}.

- Descubrimiento UCP: {{ agents.ucp_discovery_url }}
- Punto de acceso MCP: {{ agents.mcp_endpoint_url }}
- Sitemap: {{ agents.sitemap_url }}

Antes de publicar algo así, una advertencia de la propia Shopify: el archivo es público y se guarda en caché, así que no debe llevar datos privados del comerciante, como un correo o un teléfono de contacto.⁠^{[2]Shopify Dev Docs. agents.md.liquid}

Cómo comprobarlo

1. Abre tudominio.com/agents.md en el navegador. Si tu tienda está en Shopify, verás el archivo que genera la plataforma o el de tu tema.⁠^{[2]Shopify Dev Docs. agents.md.liquid}
2. Abre también /llms.txt y /llms-full.txt y compáralos. Si son iguales, lo normal es que ninguno tenga plantilla propia y los tres salgan de la misma fuente.⁠^{[2]Shopify Dev Docs. agents.md.liquid}
3. Mira en el editor de código del tema si existe templates/agents.md.liquid. Si existe, alguien lo personalizó, y ese texto manda también en las rutas que no tengan plantilla propia.⁠^{[4]Shopify developer changelog. Customize /llms.txt, /llms-full.txt and /agents.md}
4. Busca datos que no deberían estar: un correo personal, un teléfono, una URL de pruebas.⁠^{[2]Shopify Dev Docs. agents.md.liquid}
5. Abre cada enlace del archivo y comprueba que responde. Un agente que llega a una ruta rota no tiene a quién preguntar.

Concepto cercano: llms.txt

El llms.txt es una propuesta de Jeremy Howard, de septiembre de 2024, para dar a los modelos de lenguaje un archivo en Markdown con una visión del sitio seleccionada y fácil de usar cuando responden.⁠^{[6]llmstxt.org (Jeremy Howard). The /llms.txt file} En Shopify los dos archivos se tocan: por defecto, /llms.txt repite el contenido de /agents.md, y solo se separan si el tema tiene una plantilla llms.txt.liquid.⁠^{[2]Shopify Dev Docs. agents.md.liquid} La diferencia está en el lector previsto. El llms.txt es una guía de lectura general; el /agents.md de Shopify, según su documentación, está pensado para agentes y asistentes de compra que necesitan descubrir la tienda y saber cómo comprar en ella, con UCP y MCP como puertas de entrada.⁠^{[2]Shopify Dev Docs. agents.md.liquid}

Para seguir, la entrada de llms.txt cuenta qué dijo Google de esos archivos, y la ruta de lectura de este tema ordena el resto de términos.