# Leer esta documentación desde un agente

> Cómo obtener la documentación de hiClient como Markdown con llms.txt, el sufijo .md o la cabecera Accept.

Cada página de docs.hi-client.com existe también como Markdown plano, sin menús ni estilos. Es la forma recomendada de pasarle esta documentación a un asistente de IA.

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

| Dirección | Contenido |
|---|---|
| `https://docs.hi-client.com/llms.txt` | Índice de todas las páginas, con título, descripción y enlace al Markdown. |
| `https://docs.hi-client.com/llms.txt?lang=es` | Índice de las páginas en un idioma (`?lang=es`, `?lang=en` o `?lang=pt`). |
| `https://docs.hi-client.com/llms-full.txt` | Toda la documentación en un solo archivo de texto. |

Usá el índice cuando el agente pueda seguir enlaces y elegir qué leer. Usá `llms-full.txt` cuando prefieras pasarle todo de una vez.

## Una página en Markdown {#markdown}

Hay dos formas de pedir una página como Markdown:

1. Agregá `.md` al final de la dirección.

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

2. Pedí la dirección normal con la cabecera `Accept: text/markdown`.

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

El Markdown conserva el front matter (`title`, `description`) y los identificadores de los encabezados, así que los enlaces a una sección (`#offers-read`) siguen sirviendo.

## Desde el navegador {#buttons}

Cada página tiene dos botones:

- **Copiar para agente**: copia la página al portapapeles, lista para pegar en una conversación.
- **Descargar**: guarda la guía como archivo Markdown.

## Qué leer primero {#reading-order}

Para un agente que va a operar una cuenta, este orden alcanza:

1. [Convenciones](https://docs.hi-client.com/agents/conventions.md?lang=es): cómo paginar, revisiones, errores y textos de terceros.
2. [Permisos](https://docs.hi-client.com/agents/permissions.md?lang=es): qué permite cada permiso concedido.
3. [Herramientas](https://docs.hi-client.com/agents/tools.md?lang=es): el catálogo por área.

> [!TIP]
> Dentro de una conexión, la herramienta `account_whoami` dice qué permisos tiene el agente, qué cubre cada área y qué queda reservado al portal. Llamala primero.
