llms.txt et documentation Markdown
Tout sur ce site de documentation existe en double : sous forme de HTML que vous lisez et sous forme de Markdown conçu pour la consommation par les machines. Les agents ont besoin de texte propre et riche en liens qu'ils peuvent indexer, récupérer ou charger en contexte. Cette page explique les trois formes lisibles par les machines et leurs relations.
Le corpus
- /llms.txt, l'index : Une carte plate de chaque page, avec un résumé d'une ligne et un lien pour chacune. Il suit la convention llms.txt et est suffisamment petit pour tenir dans le contexte. Utilisez-le comme point de départ lorsqu'un agent récupère des pages à la demande.
- /llms-full.txt, le corpus complet : Toutes les pages de documentation concaténées en Markdown dans un seul fichier. Utilisez-le pour une session à contexte long, un job d'ingestion RAG, ou un fichier de connaissances au niveau projet nécessitant le corpus complet.
- Le jumeau Markdown par page : Chaque page est également disponible en Markdown brut, afin qu'un agent puisse récupérer une seule page sans le reste du corpus.
Les trois formes sont générées à partir des mêmes sources que le site HTML et regénérées à chaque déploiement, de sorte qu'elles ne sont jamais en retard sur la documentation publiée.
L'affordance Copier la page
Vous avez rarement besoin de mémoriser ces URLs. Chaque page des sections Guides, Référence API, SDK et base de connaissances dispose d'un menu Copy page qui fournit les formes lisibles par les machines directement à vos outils :
- Copy page as Markdown : Le jumeau Markdown de la page courante, prêt à coller dans un chat ou un fichier de contexte.
- Open llms-full.txt : Le corpus complet pour les tâches nécessitant plus d'une page.
- Copy MCP install command : La commande en une ligne qui ajoute le serveur MCP hébergé à la configuration de votre client, afin que l'agent lisant la page puisse également connecter les outils nécessaires pour agir.
- Connect to Cursor / Connect to VS Code : Configuration MCP en un clic pour deux éditeurs agentiques courants.
Le tableau de bord offre une version plus restreinte de la même idée. Sur la page d'onboarding email, le menu Copy for AI copie l'exemple de code actuel sous forme de prompt prêt à coller, ou l'ouvre directement dans Cursor, Claude ou ChatGPT.
La référence API ne dérive jamais
La section de référence API est générée à partir de la spécification OpenAPI qui valide l'API. Son jumeau Markdown provient de la même source. Lorsqu'un endpoint change, la spécification, le HTML, le Markdown et llms-full.txt sont regénérés ensemble. Un agent lisant le corpus lit donc directement le contrat API. Commencez par l'introduction de la référence API pour voir comment la référence est organisée.
Les pages de tarification contiennent leurs prix
Une page de tarification et son jumeau Markdown sont rendus à partir des mêmes données tarifaires, dans la même requête. /products/email/pricing.md retourne les plans email et les deux grilles de volume, /pricing/email.md la grille du plan d'envoi à chaque volume d'envoi, /pricing/sms.md la grille tarifaire par destination, /pricing/voice/us.md les tarifs d'appel à la minute pour une destination, et /pricing/sms/fees.md les frais opérateur et 10DLC. Commencez par /pricing.md : il liste chaque produit publiant un tarif, sa page de tarification et l'URL .md où se trouvent les tarifs. Les tarifs provenant du catalogue de facturation sont récupérés à la demande, et non copiés dans le fichier, de sorte que le jumeau ne peut pas citer un prix que la page a depuis modifié. Chaque montant est en dollars américains et chaque tableau nomme son unité.
Choisir une forme
| Vous voulez que l'agent… | Fournissez-lui… |
|---|---|
| Découvre ce qui existe et récupère les pages à la demande | /llms.txt |
| Dispose du corpus complet de la documentation en contexte ou dans un store RAG | /llms-full.txt |
| Comprenne un sujet précisément | Le Markdown de cette page via Copy page |
| Agisse sur Bird en plus de lire la documentation | Le serveur MCP ; la documentation seule ne peut pas envoyer un email |
Pour une configuration guidée de bout en bout qui installe le serveur MCP, connecte l'éditeur et intègre le corpus, suivez Onboarding IA.
Étapes suivantes
- Onboarding IA : installer le serveur MCP, connecter l'éditeur et intégrer le corpus.
- Serveur MCP : permettre à votre agent d'agir sur Bird en plus de lire la documentation.
- Compétences agent : workflows pré-construits qui enseignent la surface Bird aux agents de codage.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideSetting up your coding agentComprendre le conceptWhat is an MCP server, and how does an agent use one to send messages?Explorer la fonctionnalitéCoding agentsSuivre le parcours d'apprentissageBuild with AI agents
Obtenir un guide d'implémentation