# Ler esta documentação a partir de um agente

> Como obter a documentação do hiClient em Markdown com llms.txt, o sufixo .md ou o cabeçalho Accept.

Cada página de docs.hi-client.com também existe como Markdown simples, sem menus nem estilos. É a forma recomendada de passar esta documentação a um assistente de IA.

## Índices llms.txt {#llms-txt}

| Endereço | Conteúdo |
|---|---|
| `https://docs.hi-client.com/llms.txt` | Índice de todas as páginas, com título, descrição e link para o Markdown. |
| `https://docs.hi-client.com/llms.txt?lang=pt` | Índice das páginas de um idioma (`?lang=es`, `?lang=en` ou `?lang=pt`). |
| `https://docs.hi-client.com/llms-full.txt` | Toda a documentação em um único arquivo de texto. |

Use o índice quando o agente puder seguir links e escolher o que ler. Use `llms-full.txt` quando preferir passar tudo de uma vez.

## Uma página em Markdown {#markdown}

Há duas formas de pedir uma página em Markdown:

1. Acrescente `.md` ao final do endereço.

   ```
   https://docs.hi-client.com/agents/permissions.md?lang=pt
   ```

2. Peça o endereço normal com o cabeçalho `Accept: text/markdown`.

   ```bash
   curl -H "Accept: text/markdown" https://docs.hi-client.com/agents/permissions?lang=pt
   ```

O Markdown mantém o front matter (`title`, `description`) e os identificadores dos títulos, então os links para uma seção (`#offers-read`) continuam funcionando.

## No navegador {#buttons}

Cada página tem dois botões:

- **Copiar para agente**: copia a página para a área de transferência, pronta para colar em uma conversa.
- **Baixar**: salva a guia como arquivo Markdown.

## O que ler primeiro {#reading-order}

Para um agente que vai operar uma conta, esta ordem basta:

1. [Convenções](https://docs.hi-client.com/agents/conventions.md?lang=pt): paginação, revisões, erros e textos de terceiros.
2. [Permissões](https://docs.hi-client.com/agents/permissions.md?lang=pt): o que cada permissão concedida permite.
3. [Ferramentas](https://docs.hi-client.com/agents/tools.md?lang=pt): o catálogo por área.

> [!TIP]
> Dentro de uma conexão, a ferramenta `account_whoami` diz quais permissões o agente tem, o que cada área cobre e o que fica reservado ao portal. Chame-a primeiro.
