Integración con Agentes de IA
Esta documentación está hecha para que la lean agentes de IA, herramientas basadas en LLM y asistentes para desarrolladores, no solo personas. Tres recursos lo hacen posible:
- Una versión en Markdown plano de cada página.
- Un índice
llms.txtpara cada idioma, que mapea todo el sitio. - Una barra de acciones en la parte superior de cada página, que envía la página a un asistente con un clic.
Versión Markdown de cada página
Añade .md al final de cualquier URL de página en tu navegador o cliente HTTP:
| URL de la página | URL en Markdown |
|---|---|
/developers/api-reference/post-processes | /developers/api-reference/post-processes.md |
/products/sign-up/multi-accounts | /products/sign-up/multi-accounts.md |
/capabilities/liveness | /capabilities/liveness.md |
/pt-BR/capabilities/liveness | /pt-BR/capabilities/liveness.md |
La respuesta es el contenido Markdown de la página, sin navegación, barra lateral ni envoltura HTML. Cada idioma tiene su propia versión Markdown, con el mismo prefijo de idioma que la página.
El índice llms.txt
Cada idioma tiene un archivo llms.txt, en el formato llms.txt:
| Idioma | URL del índice |
|---|---|
| Inglés | /llms.txt |
| Portugués (Brasil) | /pt-BR/llms.txt |
| Español | /es/llms.txt |
Todos los demás idiomas siguen el mismo patrón: el prefijo de idioma de sus páginas, seguido de /llms.txt.
El archivo refleja la navegación del sitio:
- Una sección para cada pestaña de la barra de navegación superior. Después vienen las pestañas de la Dual API, cada una con el nombre de la pestaña seguido de
(Dual API). - La barra lateral de cada pestaña en listas anidadas, en el mismo orden que el sitio.
- Un enlace a la versión Markdown de cada página, seguido de la descripción de la página cuando la tiene.
Un agente puede empezar por el llms.txt del idioma del lector para entender cómo está organizada la documentación. Después, abre solo las páginas Markdown que necesita.
Barra de acciones
Cada página de la documentación, excepto la página de inicio, tiene una barra de acciones debajo del título:
- Copiar página — copia el Markdown de la página al portapapeles.
- Markdown — abre la versión Markdown de la página en una nueva pestaña.
- Abrir en — abre la página en un asistente de IA: ChatGPT, Claude, Gemini, Perplexity, Grok o Copilot. El asistente recibe un prompt con la URL Markdown de la página. En Gemini y Copilot, el prompt se copia al portapapeles y tú lo pegas en el chat.
- Copiar URL del Markdown — copia la URL absoluta de la versión Markdown, para pegarla en agentes de programación como Cursor, Codex o Claude Code.
En escritorio, Copiar página, Markdown, ChatGPT y Claude son botones de la barra, y las demás acciones están en Más. En móvil, las demás acciones están en el menú que abre la flecha junto a Copiar página.
Descubrimiento automático
El HTML de cada página declara ambos recursos en su <head>, así que un agente que visita cualquier página puede encontrarlos sin instrucciones:
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
rel="alternate"apunta a la versión Markdown de la página actual.rel="llms-txt"apunta alllms.txtdel idioma de la página.
Casos de uso
- Asistentes de programación con IA — dale a tu asistente el
llms.txto una URL.md, para que trabaje con contexto preciso y actualizado sobre un endpoint, una capacidad o un caso de uso. - Prompts de LLM — obtén una página como Markdown e inclúyela en un prompt para resumir, traducir o generar código.
- Pipelines RAG — usa el
llms.txtcomo lista de fuentes y las URLs.mdcomo fuente de ingesta para sistemas de generación aumentada por recuperación. - Scripts automatizados — analiza el contenido de la documentación sin necesidad de un scraper HTML.
Ejemplos
Obtén el índice de la documentación en inglés:
curl https://developer.unico.io/llms.txt
Obtén la versión Markdown de la página de Autenticación:
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
Ambas respuestas son texto plano, listas para ser procesadas por cualquier LLM o pipeline.