llms.txt y documentación en Markdown
Todo en este sitio de documentación existe dos veces: como el HTML que estás leyendo y como Markdown pensado para consumo automático. Los agentes necesitan texto limpio y rico en enlaces que puedan indexar, recuperar o cargar en contexto. Esta página explica las tres formas legibles por máquinas y cómo se relacionan.
El corpus
- /llms.txt, el índice: Un punto de entrada curado a productos, guías para desarrolladores, herramientas y referencias legibles por máquinas. Sigue la convención llms.txt y es lo bastante pequeño para caber en contexto. Úsalo como punto de partida cuando un agente recupera páginas bajo demanda.
- /llms-full.txt, la exportación de guías en inglés: Docs en inglés de autoría concatenados como Markdown. Excluye las referencias de operaciones generadas de API, las referencias generadas de SDK y la documentación importada. Úsalo cuando tu tarea necesite una colección amplia de guías.
- El gemelo Markdown por página: Cada página también está disponible como Markdown sin procesar, para que un agente pueda recuperar una sola página sin el resto del corpus.
La exportación de guías y los gemelos Markdown usan las mismas fuentes publicadas que sus páginas HTML. El índice curado te dirige a esas fuentes. Para una tarea específica, busca en los docs con el endpoint público GET: cambia q por tu pregunta y luego recupera un markdown_url coincidente. La búsqueda devuelve enlaces de página y sección, más un conteo estimado de tokens por página.
La función Copiar página
Rara vez necesitas recordar esas URL. Cada página en las secciones de Guías, referencia de API, SDK y base de conocimiento incluye un menú Copiar página que entrega las formas legibles por máquinas directamente a tus herramientas:
- Copiar página como Markdown: El gemelo Markdown de la página actual, listo para pegar en un chat o archivo de contexto.
- Abrir llms-full.txt: La colección de guías en inglés para tareas que necesitan varias guías.
- Copiar comando de instalación de MCP: El comando de una línea que añade el servidor MCP alojado a la configuración de tu cliente, para que el agente que lee la página también pueda conectar las herramientas necesarias para actuar.
- Conectar a Cursor / Conectar a VS Code: Configuración de MCP con un clic para dos editores agénticos populares.
El panel de control ofrece una versión más acotada de la misma idea. En la página de incorporación de correo electrónico, el menú Copiar para IA copia el ejemplo de código actual como un prompt listo para pegar, o lo abre directamente en Cursor, Claude o ChatGPT.
La referencia de API nunca se desincroniza
La sección de referencia de API se genera a partir de la especificación OpenAPI que valida la API. Su gemelo Markdown proviene de la misma fuente. Para firmas de operaciones y esquemas, consulta la referencia generada o la especificación OpenAPI pública. La exportación de guías en inglés no incluye páginas de operaciones generadas. Comienza en la introducción a la referencia de API para ver cómo está organizada la referencia.
Las páginas de precios incluyen sus precios
Una página de precios y su gemelo Markdown se generan a partir de los mismos datos de tarifas, en la misma solicitud. /email-api/pricing.md devuelve los planes de email y ambas escalas de volumen, /pricing/email.md la cuadrícula de planes de envío en cada volumen de envío, /pricing/sms.md la tabla de tarifas por destino, /pricing/voice/us.md las tarifas por minuto de llamada para un destino, y /pricing/sms/fees.md las tarifas de operador y 10DLC. Comienza en /pricing.md: lista cada producto que publica una tarifa, su página de precios y la URL de .md donde residen las tarifas. Las tarifas que provienen del catálogo de facturación se obtienen cuando las solicitas, no se copian en el archivo, así que el gemelo no puede citar un precio que la página haya cambiado desde entonces. Las tablas identifican la moneda publicada y la unidad de facturación. Usa la moneda proporcionada por la fuente de precios.
Elegir una forma
| Quieres que el agente… | Dale… |
|---|---|
| Descubra qué existe y recupere páginas bajo demanda | /llms.txt |
| Lea las guías en inglés de autoría en conjunto | /llms-full.txt |
| Entienda un tema con precisión | El Markdown de esa página mediante Copiar página |
| Actúe sobre Bird además de leer sobre ella | El servidor MCP; la documentación sola no puede enviar un correo |
Para una configuración guiada de principio a fin que instale el servidor MCP, conecte el editor e integre el corpus, sigue Incorporación con IA.
Próximos pasos
- Incorporación con IA: instala el servidor MCP, conecta el editor e integra el corpus.
- Servidor MCP: permite que tu agente actúe sobre Bird además de leer sobre él.
- Agent skills: flujos de trabajo predefinidos que enseñan a los agentes de código la superficie de Bird.
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Ver la guíaSetting up your coding agentComprender el conceptoWhat is an MCP server, and how does an agent use one to send messages?Explorar la funcionalidadCoding agentsSeguir la ruta de aprendizajeBuild with AI agents
Obtener un resumen de implementación