llms.txt e docs em Markdown
Tudo neste site de documentação existe duas vezes: como o HTML que você está lendo e como Markdown feito para consumo por máquinas. Agentes precisam de texto limpo e rico em links que possam indexar, recuperar ou carregar em contexto. Esta página explica as três formas legíveis por máquina e como elas se relacionam.
O corpus
- /llms.txt, o índice: Um ponto de entrada curado para produtos, guias para desenvolvedores, ferramentas e referências legíveis por máquina. Segue a convenção llms.txt e é pequeno o suficiente para caber no contexto. Use-o como ponto de partida quando um agente busca páginas sob demanda.
- /llms-full.txt, a exportação de guias em inglês: Documentação em inglês escrita por autores, concatenada em Markdown. Exclui referências de operações geradas da API, referências geradas da SDK e documentação importada. Use quando sua tarefa precisar de uma coleção ampla de guias.
- O espelho Markdown por página: Cada página também está disponível como Markdown bruto, para que um agente possa recuperar uma página sem o restante do corpus.
A exportação de guias e os pares Markdown usam as mesmas fontes publicadas que suas páginas HTML. O índice curado aponta você para essas fontes. Para uma tarefa específica, pesquise nos docs com o endpoint público GET: altere q para a sua pergunta e então busque um markdown_url correspondente. A pesquisa retorna links de página e seção, além de uma contagem estimada de tokens da página.
O recurso Copiar página
Você raramente precisa lembrar dessas URLs. Todas as páginas nos Guias, na referência API, em SDK e nas seções da base de conhecimento possuem um menu Copiar página que entrega as formas legíveis por máquina diretamente às suas ferramentas:
- Copiar página como Markdown: O espelho Markdown da página atual, pronto para colar em um chat ou arquivo de contexto.
- Abrir llms-full.txt: A coleção de guias em inglês para tarefas que precisam de vários guias.
- Copiar comando de instalação do MCP: O comando de uma linha que adiciona o servidor MCP hospedado à configuração do seu cliente, para que o agente que lê a página também possa conectar as ferramentas necessárias para agir.
- Conectar ao Cursor / Conectar ao VS Code: Configuração do MCP com um clique para dois editores agênticos populares.
O dashboard oferece uma versão mais restrita da mesma ideia. Na página de onboarding de e-mail, o menu Copy for AI copia o exemplo de código atual como um prompt pronto para colar, ou abre diretamente no Cursor, Claude ou ChatGPT.
A referência API nunca fica defasada
A seção de referência da API é gerada a partir da especificação OpenAPI que valida a API. Seu par Markdown vem da mesma fonte. Para assinaturas de operações e schemas, leia a referência gerada ou a especificação OpenAPI pública. A exportação de guias em inglês não inclui páginas de operações geradas. Comece pela introdução à referência da API para ver como a referência é organizada.
Páginas de preços incluem seus preços
Uma página de preços e seu par Markdown são renderizados a partir dos mesmos dados de tarifas, na mesma solicitação. /email-api/pricing.md retorna os planos de e-mail e ambas as escalas de volume, /pricing/email.md a grade de planos de envio em cada volume de envio, /pricing/sms.md a tabela de tarifas por destino, /pricing/voice/us.md as tarifas por minuto de chamada para um destino, e /pricing/sms/fees.md as taxas de operadora e 10DLC. Comece por /pricing.md: ele lista cada produto que publica uma tarifa, sua página de preços e a URL .md onde as tarifas ficam. Tarifas que vêm do catálogo de cobrança são buscadas quando você solicita, não copiadas para o arquivo, então o par não pode citar um preço que a página já alterou. As tabelas identificam a moeda publicada e a unidade de cobrança. Use a moeda fornecida pela fonte de preços.
Escolhendo uma forma
| Você quer que o agente… | Entregue… |
|---|---|
| Descubra o que existe e busque páginas sob demanda | /llms.txt |
| Leia os guias em inglês escritos por autores, juntos | /llms-full.txt |
| Entenda um tópico com precisão | O Markdown da página via Copiar página |
| Atue na Bird além de ler sobre ela | O servidor MCP; a documentação sozinha não consegue enviar um e-mail |
Para uma configuração guiada de ponta a ponta que instala o servidor MCP, conecta o editor e integra o corpus, siga AI onboarding.
Próximos passos
- AI onboarding: instale o servidor MCP, conecte o editor e integre o corpus.
- Servidor MCP: permita que seu agente atue sobre Bird além de ler a respeito.
- Agent skills: fluxos pré-construídos que ensinam a agentes de código a superfície Bird.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaSetting up your coding agentEntenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agentsSiga o percurso de aprendizagemBuild with AI agents
Obtenha um resumo de implementação