lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

caso de uso intermedio ragpythondocumentosinvestigacion

PageIndex: recupera información recorriendo la estructura documental

Consulta documentos largos mediante un índice jerárquico y razonamiento del modelo, sin preparar una base de datos vectorial.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.


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.

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:

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:

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:

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.

ver en .md ¿Prefieres el recurso entero?

Qué es

PageIndex es un sistema de recuperación documental basado en un índice de árbol. Usa la organización y el contenido del documento para orientar al modelo hacia las secciones pertinentes.

Para qué te sirve

  • Cuando una respuesta depende de la jerarquía de un informe y no de párrafos aislados.
  • Cuando quieres probar recuperación documental sin montar un almacén vectorial.
  • Cuando necesitas comparar una búsqueda estructural con el RAG por fragmentos de tu aplicación.

Cómo funciona

La construcción del índice organiza el documento en nodos; después el modelo navega por esa estructura para localizar evidencia y responder. El SDK actual distingue modo local y servicio cloud mediante un cliente común.

En modo local aportas tu proveedor de modelos. El modo cloud delega la construcción o el almacenamiento del índice según su configuración. No confundas ejecución del índice en tu máquina con inferencia necesariamente local.

Antes de empezar

Necesitas Python ≥3.10 y pip, un documento de prueba y acceso al modelo compatible que indique el ejemplo. Para cloud hace falta además una cuenta de PageIndex. Verifica el tipo de PDF y la calidad de su texto antes de evaluar respuestas.

Límites y alternativas

El índice no elimina errores del modelo ni garantiza que todas las tablas o páginas se interpreten bien. Compara preguntas con respuestas conocidas y comprueba la evidencia. Los benchmarks (pruebas comparativas) publicados por el autor no justifican afirmar que superará a una alternativa en tus documentos.

Recursos

  • Repositorio y README - 39789 estrellas; licencia detectada por GitHub: MIT.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.