# Qué es agents.md y qué hace en una tienda Shopify > Qué es agents.md: el formato AGENTS.md de los repositorios de código y el /agents.md que Shopify sirve en cada tienda para los agentes de compra. URL: https://clione.ai/es/glosario/agents-md/ Lang: es Si buscas agents.md, puedes encontrarte con dos archivos que comparten nombre y propósito general, hablar a un [agente de IA](/es/glosario/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.[^agents-md-format] 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)](/es/glosario/ucp/) y el punto de acceso de [MCP (Model Context Protocol)](/es/glosario/mcp/), 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.[^shopify-agents-md] 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.[^ucp-spec] 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.[^shopify-agents-md] - **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.[^shopify-agents-md] - **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.[^shopify-agents-md] Esas plantillas se pueden personalizar desde el 28 de mayo de 2026.[^shopify-changelog] - **Su plantilla ve muy poco.** En `agents.md.liquid` solo funcionan dos objetos de [Liquid](/es/glosario/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](/es/glosario/sitemap-xml/).[^shopify-agents-md] ## 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. ```markdown # 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.[^shopify-changelog] Una versión mínima que solo usa los datos que Shopify pone a disposición de esa plantilla:[^shopify-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.[^shopify-agents-md] **agents.md no es un [robots.txt](/es/glosario/robots-txt/) para agentes.** Describe la tienda y enlaza sus puntos de acceso, pero ni la documentación de Shopify ni la del formato AGENTS.md le dan un papel de permiso o de bloqueo.[^shopify-agents-md][^agents-md-format] Qué bot puede pedir qué URL lo sigue diciendo robots.txt, el protocolo de exclusión de robots, cuyas reglas, además, no son una autorización de acceso.[^rfc9309] Y la confusión contraria también existe: el AGENTS.md que encuentras en tutoriales de programación no tiene nada que ver con la visibilidad de tu tienda. ## 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.[^shopify-agents-md] 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.[^shopify-agents-md] 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.[^shopify-changelog] 4. **Busca datos que no deberían estar**: un correo personal, un teléfono, una URL de pruebas.[^shopify-agents-md] 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/glosario/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.[^llmstxt] 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`.[^shopify-agents-md] 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.[^shopify-agents-md] Para seguir, la entrada de [llms.txt](/es/glosario/llms-txt/) cuenta qué dijo Google de esos archivos, y la [ruta de lectura](/es/aprender/rastreo-e-indexacion/) de este tema ordena el resto de términos.