Integração com Agentes de IA
Esta documentação foi feita para ser lida por agentes de IA, ferramentas baseadas em LLM e assistentes de desenvolvedor, e não só por pessoas. Três recursos tornam isso possível:
- Uma versão em Markdown puro de cada página.
- Um índice
llms.txtpara cada idioma, que mapeia o site inteiro. - Uma barra de ações no topo de cada página, que envia a página para um assistente com um clique.
Versão em Markdown de cada página
Adicione .md ao final de qualquer URL de página no seu navegador ou cliente HTTP:
| URL da página | URL em Markdown |
|---|---|
/developers/api-reference/post-processes | /developers/api-reference/post-processes.md |
/products/sign-up/multi-accounts | /products/sign-up/multi-accounts.md |
/capabilities/liveness | /capabilities/liveness.md |
/pt-BR/capabilities/liveness | /pt-BR/capabilities/liveness.md |
A resposta é o conteúdo em Markdown da página, sem navegação, sidebar ou wrapper HTML. Cada idioma tem a própria versão em Markdown, com o mesmo prefixo de idioma da página.
O índice llms.txt
Cada idioma tem um arquivo llms.txt, no formato llms.txt:
| Idioma | URL do índice |
|---|---|
| Inglês | /llms.txt |
| Português (Brasil) | /pt-BR/llms.txt |
| Espanhol | /es/llms.txt |
Todos os outros idiomas seguem o mesmo padrão: o prefixo de idioma das suas páginas, seguido de /llms.txt.
O arquivo espelha a navegação do site:
- Uma seção para cada aba da barra de navegação superior. Depois delas vêm as abas da Dual API, cada uma com o nome da aba seguido de
(Dual API). - A sidebar de cada aba em listas aninhadas, na mesma ordem do site.
- Um link para a versão em Markdown de cada página, seguido da descrição da página quando ela tem uma.
Um agente pode começar pelo llms.txt do idioma do leitor para entender como a documentação está organizada. Depois, ele abre só as páginas em Markdown de que precisa.
Barra de ações
Toda página da documentação, exceto a página inicial, tem uma barra de ações abaixo do título:
- Copiar página — copia o Markdown da página para a área de transferência.
- Markdown — abre a versão em Markdown da página em uma nova aba.
- Abrir em — abre a página em um assistente de IA: ChatGPT, Claude, Gemini, Perplexity, Grok ou Copilot. O assistente recebe um prompt com a URL em Markdown da página. No Gemini e no Copilot, o prompt é copiado para a área de transferência, e você o cola no chat.
- Copiar URL do Markdown — copia a URL absoluta da versão em Markdown, para colar em agentes de programação como Cursor, Codex ou Claude Code.
No desktop, Copiar página, Markdown, ChatGPT e Claude são botões da barra, e as outras ações ficam em Mais. No celular, as outras ações ficam no menu que a seta ao lado de Copiar página abre.
Descoberta automática
O HTML de toda página declara os dois recursos no <head>, então um agente que visita qualquer página consegue encontrá-los sem instruções:
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
rel="alternate"aponta para a versão em Markdown da página atual.rel="llms-txt"aponta para ollms.txtdo idioma da página.
Casos de uso
- Assistentes de programação com IA — passe ao seu assistente o
llms.txtou uma URL.md, para que ele trabalhe com contexto preciso e atualizado sobre um endpoint, uma capacidade ou um caso de uso. - Prompts de LLM — busque uma página como Markdown e inclua-a em um prompt para resumo, tradução ou geração de código.
- Pipelines RAG — use o
llms.txtcomo lista de fontes e as URLs.mdcomo fonte de ingestão para sistemas de geração aumentada por recuperação. - Scripts automatizados — processe o conteúdo da documentação sem precisar de um scraper de HTML.
Exemplos
Busque o índice da documentação em inglês:
curl https://developer.unico.io/llms.txt
Busque a versão em Markdown da página de Autenticação:
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
As duas respostas são texto puro, prontas para serem usadas por qualquer LLM ou pipeline de processamento.