> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use a documentação com IA

> Esta documentação é feita para agentes de IA: toda página existe em Markdown puro, e os arquivos llms.txt e llms-full.txt indexam tudo para o seu assistente.

Hoje, boa parte das integrações começa num assistente de IA — Claude, ChatGPT, Cursor, Copilot.
Por isso esta documentação é **AI-first**: além das páginas que você lê aqui, todo o conteúdo é
publicado em formatos pensados para modelos de linguagem consumirem direto, sem HTML nem navegação
no meio do caminho.

<CardGroup cols={2}>
  <Card title="llms.txt" icon="list" href="https://docs.z2pay.com/llms.txt">
    Índice curado de toda a documentação, com um resumo por página. Ponto de partida ideal para
    um agente descobrir o que existe.
  </Card>

  <Card title="llms-full.txt" icon="book-open" href="https://docs.z2pay.com/llms-full.txt">
    A documentação **inteira** concatenada em um único arquivo Markdown. Útil para colocar todo o
    contexto de uma vez em modelos com janela grande.
  </Card>
</CardGroup>

## Copie qualquer página em Markdown

No topo de cada página há um menu de contexto com atalhos:

* **Copy page** — copia a página atual como Markdown puro, pronta para colar no chat.
* **View as Markdown** — abre a versão `.md` da página no navegador.
* **Open in ChatGPT / Claude** — abre o assistente já com a página carregada como contexto.

Também funciona na mão: **acrescente `.md` a qualquer URL** da documentação para obter a versão
Markdown daquela página.

```text theme={null}
https://docs.z2pay.com/pt-BR/ambientes      ← página normal
https://docs.z2pay.com/pt-BR/ambientes.md   ← a mesma página em Markdown puro
```

## Arquivos disponíveis

| Arquivo         | URL                                    | O que contém                               |
| --------------- | -------------------------------------- | ------------------------------------------ |
| `llms.txt`      | `https://docs.z2pay.com/llms.txt`      | Índice de todas as páginas, com descrição  |
| `llms-full.txt` | `https://docs.z2pay.com/llms-full.txt` | Documentação completa em um único Markdown |
| `<página>.md`   | qualquer URL + `.md`                   | Uma página específica em Markdown puro     |

## Exemplo prático

Cole no seu assistente ou agente de código:

```text theme={null}
Leia https://docs.z2pay.com/llms.txt para descobrir a documentação da Z2Pay.
A partir dela, busque as páginas necessárias e me ajude a integrar um checkout
transparente com PIX, começando pelo ambiente de sandbox.
```

O agente lê o índice, busca as versões `.md` das páginas relevantes e trabalha com o conteúdo
exato da documentação — sem depender do que ele "lembra" de treino.

<Tip>
  Integrações críticas merecem contexto completo: em modelos com janela grande, forneça o
  `llms-full.txt` inteiro e peça para o agente citar a seção da doc que embasa cada resposta.
</Tip>

## Uma convenção aberta

`llms.txt` é uma convenção aberta do mercado (veja [llmstxt.org](https://llmstxt.org)), já adotada
por boa parte das documentações técnicas. Vale o hábito: ao integrar **qualquer** API, experimente
acessar `/llms.txt` na documentação dela — se existir, seu assistente vai trabalhar com informação
muito mais confiável.

<Note>
  A documentação e os arquivos para IA são gerados da mesma fonte e publicados juntos — o conteúdo
  que o seu agente lê é sempre o mesmo que você vê aqui.
</Note>