# Instrucciones para el agente: PageIndex: recupera información recorriendo la estructura documental

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/VectifyAI/PageIndex (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/pageindex-vectorless-rag

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala el SDK

Comprueba que tu entorno tiene Python ≥3.10, pip y venv, según el [pyproject.toml oficial](https://github.com/VectifyAI/PageIndex/blob/main/pyproject.toml).

En macOS/Linux crea y activa un entorno en una carpeta de ensayo con `python -m venv .venv` y `source .venv/bin/activate`. Después:

```bash
pip install -U pageindex
```

### Paso 2: elige la modalidad

Esta ruta usa índice local con inferencia de OpenAI, como el inicio rápido del README. Carga `OPENAI_API_KEY` desde tu entorno privado con acceso a los modelos `gpt-6-luna` y `gpt-6-sol`. Coloca un PDF de texto no sensible en esa carpeta como `report.pdf`. Guarda en `prueba.py`:

```python
from pageindex import PageIndexClient

client = PageIndexClient(index="gpt-6-luna", chat="gpt-6-sol")
doc_id = client.submit_document("report.pdf")["doc_id"]
print(doc_id)
print(client.chat("¿Cuál es el tema principal del documento?", doc_id=doc_id))
```

Ejecuta en el entorno activado:

```bash
python prueba.py
```

Debe imprimir el identificador y una respuesta basada en el PDF. El índice se construye en tu máquina, pero el proveedor de modelos recibe contenido. La variante cloud queda como ampliación: usa `index="cloud"` y otra clave `PAGEINDEX_API_KEY`, según el README; no es esta prueba.

## Comprobación

La indexación debe devolver un identificador y la consulta debe ser consistente con el documento. Revisa la sección de origen, no solo la redacción de la respuesta.

## Si algo falla

Si falla la carga, revisa el formato y el texto del PDF. Si falla el modelo, verifica su configuración y credenciales. No mezcles la clave de PageIndex Cloud con la del proveedor de inferencia.