Aller au contenu principal

Intégration avec les agents IA

MarkdownChatGPTClaude

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.txt pour 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 pageURL 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 :

LangueURL 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 le llms.txt de la langue de la page.

Cas d'utilisation​

  • Assistants de codage IA — donnez à votre assistant le llms.txt ou 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.txt comme liste de sources et les URLs .md comme 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.