Saltar al contenido principal

Integración con Agentes de IA

MarkdownChatGPTClaude

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.txt para 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áginaURL 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:

IdiomaURL 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 al llms.txt del idioma de la página.

Casos de uso​

  • Asistentes de programación con IA — dale a tu asistente el llms.txt o 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.txt como lista de fuentes y las URLs .md como 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.