llms.txt e documentazione Markdown
Ogni pagina di questo sito di documentazione esiste in due forme: l'HTML che stai leggendo e il Markdown pensato per il consumo da parte delle macchine. Gli agenti hanno bisogno di testo pulito e ricco di link da indicizzare, recuperare o caricare nel contesto. Questa pagina spiega le tre forme leggibili dalle macchine e come si collegano tra loro.
Il corpus
- /llms.txt, l'indice: un punto di ingresso curato verso prodotti, guide per sviluppatori, strumenti e riferimenti leggibili dalle macchine. Segue la convenzione llms.txt ed è abbastanza piccolo da stare nel contesto. Usalo come punto di partenza quando un agente recupera le pagine su richiesta.
- /llms-full.txt, l'esportazione delle guide in inglese: la documentazione in inglese concatenata in Markdown. Esclude i riferimenti alle operazioni API generati, i riferimenti SDK generati e la documentazione importata. Usalo quando la tua attività richiede un'ampia raccolta di guide.
- Il gemello Markdown per pagina: ogni pagina è disponibile anche come Markdown grezzo, così un agente può recuperare una singola pagina senza il resto del corpus.
L'esportazione delle guide e i gemelli Markdown usano le stesse fonti pubblicate delle rispettive pagine HTML. L'indice curato rimanda a quelle fonti. Per un'attività specifica, cerca nei docs con l'endpoint GET pubblico: sostituisci q con la tua domanda, poi recupera un markdown_url corrispondente. La ricerca restituisce link a pagine e sezioni più un conteggio stimato dei token per pagina.
La funzione Copia pagina
Raramente hai bisogno di ricordare quegli URL. Ogni pagina nelle sezioni Guide, reference API, SDK e knowledge base include un menu Copy page che consegna le forme leggibili dalle macchine direttamente ai tuoi strumenti:
- Copy page as Markdown: il gemello Markdown della pagina corrente, pronto da incollare in una chat o in un file di contesto.
- Apri llms-full.txt: la raccolta delle guide in inglese per attività che richiedono più guide.
- Copy MCP install command: il comando su una riga che aggiunge il server MCP ospitato alla configurazione del tuo client, così l'agente che legge la pagina può anche collegare gli strumenti necessari per agire.
- Connect to Cursor / Connect to VS Code: configurazione MCP con un clic per due editor agentici comuni.
La dashboard offre una versione più mirata della stessa idea. Nella pagina di onboarding email, il menu Copy for AI copia l'esempio di codice corrente come prompt pronto da incollare, oppure lo apre direttamente in Cursor, Claude o ChatGPT.
La reference API non va mai fuori sincrono
La sezione di riferimento API è generata dalla specifica OpenAPI che valida la API. Il suo gemello Markdown proviene dalla stessa fonte. Per le firme delle operazioni e gli schemi, consulta il riferimento generato o la specifica OpenAPI pubblica. L'esportazione delle guide in inglese non include le pagine delle operazioni generate. Parti dall'introduzione al riferimento API per vedere come è organizzato il riferimento.
Le pagine dei prezzi includono i loro prezzi
Una pagina dei prezzi e il suo gemello Markdown vengono generati dagli stessi dati tariffari, nella stessa richiesta. /email-api/pricing.md restituisce i piani email e entrambe le scale di volume, /pricing/email.md la griglia dei piani di invio a ogni volume di invio, /pricing/sms.md la tabella tariffaria per destinazione, /pricing/voice/us.md le tariffe al minuto per le chiamate verso una destinazione e /pricing/sms/fees.md le commissioni dell'operatore e 10DLC. Parti da /pricing.md: elenca ogni prodotto che pubblica una tariffa, la sua pagina dei prezzi e l'URL .md in cui risiedono le tariffe. Le tariffe provenienti dal catalogo di fatturazione vengono recuperate quando le richiedi, non copiate nel file, quindi il gemello non può citare un prezzo che la pagina ha nel frattempo modificato. Le tabelle indicano la valuta pubblicata e l'unità di fatturazione. Usa la valuta fornita dalla fonte dei prezzi.
Scegliere una forma
| Vuoi che l'agente… | Passa… |
|---|---|
| Scopra cosa esiste e recuperi le pagine su richiesta | /llms.txt |
| Legga insieme le guide in inglese | /llms-full.txt |
| Comprenda un argomento con precisione | Il Markdown della pagina tramite Copy page |
| Agisca su Bird oltre che leggerne la documentazione | Il server MCP; la sola documentazione non può inviare un'email |
Per una configurazione guidata end-to-end che installa il server MCP, collega l'editor e integra il corpus, segui AI onboarding.
Prossimi passi
- AI onboarding: installa il server MCP, collega l'editor e integra il corpus.
- Server MCP: permetti al tuo agente di agire su Bird oltre che leggere la documentazione.
- Agent skills: workflow predefiniti che insegnano agli agenti di codifica la superficie Bird.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaSetting up your coding agentComprendi il concettoWhat is an MCP server, and how does an agent use one to send messages?Esplora la funzionalitàCoding agentsSegui il percorso di apprendimentoBuild with AI agents
Ottieni un brief di implementazione