Pular para o conteúdo principal

Integração com Agentes de IA

MarkdownChatGPTClaude

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.txt para 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áginaURL 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:

IdiomaURL 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 o llms.txt do idioma da página.

Casos de uso​

  • Assistentes de programação com IA — passe ao seu assistente o llms.txt ou 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.txt como lista de fontes e as URLs .md como 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.