llms.txt et documentation Markdown
Tout ce qui se trouve sur ce site de documentation existe en double : le HTML que vous lisez et un Markdown conçu pour la consommation par les machines. Les agents ont besoin d'un texte propre et riche en liens qu'ils peuvent indexer, récupérer ou charger dans leur contexte. Cette page décrit les trois formats lisibles par les machines et leur relation.
Le corpus
- /llms.txt, l'index : un point d'entrée organisé vers les produits, les guides développeur, les outils et les références lisibles par machine. Il suit la convention llms.txt et est assez 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, l'export des guides en anglais : les docs rédigées en anglais concaténées en Markdown. Il exclut les références d'opérations API générées, les références SDK générées et la documentation importée. Utilisez-le lorsque votre tâche nécessite une large collection de guides.
- Le jumeau Markdown par page : chaque page est aussi disponible en Markdown brut, ce qui permet à un agent de récupérer une seule page sans le reste du corpus.
L'export des guides et les jumeaux Markdown utilisent les mêmes sources publiées que leurs pages HTML. L'index organisé vous oriente vers ces sources. Pour une tâche précise, recherchez dans les docs avec le point de terminaison GET public : remplacez q par votre question, puis récupérez un markdown_url correspondant. La recherche renvoie des liens vers les pages et sections ainsi qu'une estimation du nombre de tokens par page.
L'affordance Copier la page
Vous avez rarement besoin de retenir ces URL. Chaque page des Guides, de la référence API, de SDK et des sections de base de connaissances dispose d'un menu Copier la page qui transmet les formats lisibles par les machines directement à vos outils :
- Copier la page en Markdown : le jumeau Markdown de la page en cours, prêt à coller dans un chat ou un fichier de contexte.
- Ouvrir llms-full.txt : la collection de guides en anglais pour les tâches qui nécessitent plusieurs guides.
- Copier la commande d'installation MCP : 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 aussi connecter les outils nécessaires pour agir.
- Se connecter à Cursor / Se connecter à VS Code : configuration MCP en un clic pour deux éditeurs agentiques courants.
Le tableau de bord propose une version plus restreinte de la même idée. Sur la page d'onboarding e-mail, le menu Copier pour l'IA 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. Pour les signatures d'opérations et les schémas, consultez la référence générée ou la spécification OpenAPI publique. L'export des guides en anglais n'inclut pas les pages d'opérations générées. Commencez par l'introduction à 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 tarifs et son jumeau Markdown sont générés à partir des mêmes données tarifaires, dans la même requête. /email-api/pricing.md renvoie les plans e-mail et les deux grilles tarifaires par volume, /pricing/email.md la grille des plans 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 qui publie un tarif, sa page de tarifs et l'URL .md où se trouvent les tarifs. Les tarifs provenant du catalogue de facturation sont récupérés au moment de votre requête, et non copiés dans le fichier : le jumeau ne peut donc pas afficher un prix que la page a depuis modifié. Les tableaux indiquent la devise publiée et l'unité de facturation. Utilisez la devise fournie par la source tarifaire.
Choisir un format
| Vous voulez que l'agent… | Donnez-lui… |
|---|---|
| Découvre ce qui existe et récupère les pages à la demande | /llms.txt |
| Lise l'ensemble des guides rédigés en anglais | /llms-full.txt |
| Comprenne un sujet précisément | Le Markdown de cette page via Copier la page |
| Agisse sur Bird en plus de lire la documentation | Le serveur MCP ; la documentation seule ne peut pas envoyer un e-mail |
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 à son sujet.
- Compétences d'agent : workflows prêts à l'emploi qui enseignent aux agents de code la surface Bird.
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