Usar com 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.
Usando um agente de IA?
Copie as instruções para o seu agente (Claude Code, Cursor, Codex e outros). Ele passa a seguir o jeito recomendado de usar a API do Hydro.
Arquivos para agentes
| Endereço | O que tem |
|---|---|
/llms.txt | Índice da documentação (llmstxt.org), com o link para o Markdown de cada página |
/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 |
/openapi.json | A especificação OpenAPI da API pública |
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
- Dê o token por variável de ambiente. Crie um token de API só para o agente, com o escopo
readse ele só for consultar, e defina uma validade. Revogue quando terminar. - Comece pelo
llms.txt. Ele é pequeno e aponta para o resto; ollms-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.jsonerram 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.