# Usar com IA

URL: https://0.0.0.0:3002/docs/ia

Leve a documentação do Hydro para o ChatGPT, o Claude, o Cursor ou o seu agente, em Markdown.

As docs do Hydro foram feitas para serem lidas também por agentes de IA.

## Arquivos para agentes [#arquivos-para-agentes]

| Endereço                           | O que tem                                                                                              |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| [`/llms.txt`](/llms.txt)           | Índice da documentação ([llmstxt.org](https://llmstxt.org)), com o link para o Markdown de cada página |
| [`/llms-full.txt`](/llms-full.txt) | Todas as páginas em Markdown, num arquivo só                                                           |
| `/docs/<página>.mdx`               | Uma página em Markdown, como [`/docs/aplicacoes.mdx`](/docs/aplicacoes.mdx)                            |
| [`/openapi.json`](/openapi.json)   | A especificação OpenAPI da API pública                                                                 |

## Em cada página [#em-cada-página]

No topo de cada página:

* **Copiar como Markdown** copia o texto da página para colar no chat.
* **Abrir em…** abre o ChatGPT ou o Claude já com a página indicada.

## Dicas [#dicas]

* **Dê o token por variável de ambiente.** Crie um [token de API](/docs/api/autenticacao) só para o agente, com o escopo `read` se ele só for consultar, e defina uma validade. Revogue quando terminar.
* **Comece pelo `llms.txt`.** Ele é pequeno e aponta para o resto; o `llms-full.txt` é melhor quando o agente precisa de tudo de uma vez.
* **Use o OpenAPI para gerar código.** Clientes e tipos gerados do `openapi.json` erram menos que rotas escritas à mão.
* **Peça confirmação para o que apaga.** Excluir apps e bancos e restaurar backups não tem volta: peça ao agente que confirme com você antes.