Intégration avec les agents IA
Cette documentation est conçue pour être lue par des agents IA, des outils basés sur des LLM et des assistants de développement, et pas seulement par des personnes. Trois ressources le permettent :
- Une version Markdown brute de chaque page.
- Un index
llms.txtpour chaque langue, qui cartographie tout le site. - Une barre d'actions en haut de chaque page, qui envoie la page à un assistant en un clic.
Version Markdown de chaque page
Ajoutez .md à la fin de n'importe quelle URL de page dans votre navigateur ou client HTTP :
| URL de la page | URL 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 réponse est le contenu Markdown de la page, sans navigation, barre latérale ni wrapper HTML. Chaque langue a sa propre version Markdown, sous le même préfixe de langue que la page.
L'index llms.txt
Chaque langue a un fichier llms.txt, au format llms.txt :
| Langue | URL de l'index |
|---|---|
| Anglais | /llms.txt |
| Portugais (Brésil) | /pt-BR/llms.txt |
| Espagnol | /es/llms.txt |
Toutes les autres langues suivent le même modèle : le préfixe de langue de leurs pages, suivi de /llms.txt.
Le fichier reflète la navigation du site :
- Une section pour chaque onglet de la barre de navigation supérieure. Les onglets de la Dual API viennent ensuite, chacun avec le nom de l'onglet suivi de
(Dual API). - La barre latérale de chaque onglet sous forme de listes imbriquées, dans le même ordre que le site.
- Un lien vers la version Markdown de chaque page, suivi de la description de la page lorsqu'elle en a une.
Un agent peut commencer par le llms.txt de la langue du lecteur pour comprendre l'organisation de la documentation. Il n'ouvre ensuite que les pages Markdown dont il a besoin.
Barre d'actions
Chaque page de la documentation, sauf la page d'accueil, a une barre d'actions sous son titre :
- Copier la page — copie le Markdown de la page dans le presse-papiers.
- Markdown — ouvre la version Markdown de la page dans un nouvel onglet.
- Ouvrir dans — ouvre la page dans un assistant IA : ChatGPT, Claude, Gemini, Perplexity, Grok ou Copilot. L'assistant reçoit un prompt avec l'URL Markdown de la page. Pour Gemini et Copilot, le prompt est copié dans le presse-papiers, et vous le collez dans le chat.
- Copier l'URL du Markdown — copie l'URL absolue de la version Markdown, à coller dans des agents de codage comme Cursor, Codex ou Claude Code.
Sur ordinateur, Copier la page, Markdown, ChatGPT et Claude sont des boutons de la barre, et les autres actions sont sous Plus. Sur mobile, les autres actions sont dans le menu qu'ouvre la flèche à côté de Copier la page.
Découverte automatique
Le HTML de chaque page déclare les deux ressources dans son <head>, ce qui permet à un agent qui visite n'importe quelle page de les trouver sans instructions :
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
rel="alternate"pointe vers la version Markdown de la page actuelle.rel="llms-txt"pointe vers lellms.txtde la langue de la page.
Cas d'utilisation
- Assistants de codage IA — donnez à votre assistant le
llms.txtou une URL.md, pour qu'il travaille avec un contexte précis et à jour sur un endpoint, une capacité ou un cas d'utilisation. - Prompts LLM — récupérez une page en Markdown et incluez-la dans un prompt pour la synthèse, la traduction ou la génération de code.
- Pipelines RAG — utilisez le
llms.txtcomme liste de sources et les URLs.mdcomme source d'ingestion pour les systèmes de génération augmentée par récupération. - Scripts automatisés — analysez le contenu de la documentation sans extracteur HTML.
Exemples
Récupérez l'index de la documentation en anglais :
curl https://developer.unico.io/llms.txt
Récupérez la version Markdown de la page d'authentification :
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
Les deux réponses sont du texte brut, prêt à être transmis à n'importe quel LLM ou pipeline de traitement.