Claix es la capa controlada de recuperación de datos para agentes de IA: se conecta a tu base relacional y permite que cada agente recupere solo las tablas y columnas que tú autorizas, guiado por tus propias reglas y devolviendo resultados validados o respuestas tipadas, sin mover tus datos. Disponible vía API REST, MCP y A2A.

En tres pasos: conecta tu base Postgres con un rol de solo lectura (Claix redacta un Data Map para que lo revises), define rutas y agentes con tus reglas (sin YAML ni código) y llama a un endpoint para que tu agente obtenga respuestas tipadas en vivo dentro del perímetro que fijaste.

¿Claix copia mis datos a un almacén vectorial?

No. Claix no copia tus datos ni construye un índice vectorial sobre ellos. Los agentes consultan tu base donde vive, dentro de las tablas y columnas que permites. Cada consulta se valida antes de ejecutarse y queda trazada después.

¿Claix escribe en mi base de datos?

No. Claix se conecta con un rol de solo lectura. Cargar documentos en campos estructurados es un producto aparte, Claix Ingest, que usas solo si lo eliges.

¿Qué bases de datos admite Claix?

Postgres hoy (incluidos entornos compatibles como Supabase). Te conectas con un rol de solo lectura para que los agentes nunca obtengan escritura a través de Claix.

¿Qué son las rutas y los agentes?

Una ruta es una capacidad de recuperación: las tablas y columnas permitidas más una guía breve con tus reglas y vocabulario. Un agente es la identidad que las usa: su propio endpoint, prompt de negocio, rutas asociadas y modo de respuesta (resultados en bruto o respuestas razonadas tipadas). Crea una ruta una vez y asígnala a tantos agentes como necesites.

¿Cómo llamo a un agente Retrieve?

Haz POST a /retrieve/{agent_name} con un body JSON de preguntas (cada una con format opcional: string, int, boolean, json o array:string). Recibes respuestas tipadas en orden y un log_id. El mismo agente está disponible por MCP (claix.retrieve.ask) y A2A.

¿Qué formatos de respuesta puedo pedir?

En modo razonada puedes pedir string, int, boolean, timestamp, timestamptz, date, json, array:string o array:int. Los valores tipados permiten ramificar por booleanos, usar números y listas directamente y evitar parsear texto libre.

¿Cómo funciona el precio?

Con la IA gestionada de Claix la tarifa es 0,10 € por pregunta. Con tu propia clave LLM (BYOK) de OpenAI, Google, Anthropic o xAI, la tarifa de Claix baja a 0,02 € por pregunta y pagas los tokens de tu proveedor. Con tu propia clave, los resultados dependen del modelo: pruébalo en el Sandbox antes de pasar a producción.

¿Agentic RAG es lo mismo que vector RAG?

No. Están en ejes distintos. “Agentic” habla de quién dispara la recuperación (pipeline fijo vs agente que llama a una herramienta). “Vector” habla de cómo se emparejan resultados (embeddings). Un agente puede llamar a SQL, BM25 o embeddings; un pipeline fijo puede usar búsqueda híbrida. Para datos de negocio relacionales, los embeddings suelen ser el default equivocado.

¿La recuperación por SQL es RAG?

Sí. RAG significa que la información recuperada alimenta al modelo. No exige embeddings ni que lo recuperado sean trozos de texto. Una consulta SQL que devuelve registros en vivo para el modelo sigue siendo recuperación.

¿Cuándo sigue teniendo sentido una base vectorial?

Cuando necesitas descubrimiento semántico sobre una colección grande y permanente de texto, mucho tráfico de búsqueda repetido, o un producto donde la búsqueda es el producto. Para valores exactos, conteos, fechas y filas en vivo que ya están en Postgres, consulta la base donde vive con acceso acotado en lugar de copiarla a un índice.

¿Puedo usar Claix desde LangChain, Cursor o n8n?

Sí. Claix no es un framework de agentes: es una capa de recuperación que llamas desde el stack que ya usas. Llama por REST desde cualquier cliente HTTP (incluido n8n), expón el agente como herramienta MCP para Cursor y clientes compatibles, o conéctalo por A2A para que otros agentes deleguen preguntas de datos.

¿Qué pasa si la respuesta no está en las tablas permitidas?

El campo vuelve vacío en lugar de una invención. Las consultas solo se ejecutan dentro de las rutas que adjuntaste al agente; todo lo que queda fuera de ese perímetro no existe para ellos. Las trazas muestran qué se preguntó, qué ruta respondió y qué volvió.

¿En qué se diferencia Claix de un servidor MCP genérico sobre la base?

Conectar un MCP de base es rápido, pero el modelo de acceso depende del servidor y del rol. Claix añade rutas, allowlists por agente, validación antes de ejecutar, respuestas tipadas multi-pregunta y una traza revisable: defines el límite una vez y se aplica en cada llamada.

Python SDK

Cliente oficial de Claix en Python

Endpoint

PIPpip install claix-ai

claix-ai es el SDK Python tipado de la API de inteligencia documental de Claix (OpenAPI 1.8.2). El import sigue siendo from claix import ClaixClient. Sirve para extracción, Modo agente, documentos persistidos y espacios de conocimiento — o para enchufar el mismo cliente en LangChain, LangGraph, CrewAI y LlamaIndex.

Requiere Python ≥ 3.10. La autenticación es la misma API key que REST, MCP y A2A: cabecera x-api-key, o variable de entorno CLAIX_API_KEY.

El mismo cliente también está en TypeScript: npm install claix-ai, con tools para LangChain.js, CrewAI y LlamaIndex.TS.

1. Código, paquete y docs relacionadas

GitHub · Gaelproodoos/claix-python — código, issues y ejemplos
PyPI · claix-ai — paquete instalable (nombre de import: claix)
TypeScript SDK — npm install claix-ai, el mismo mapa de llamadas
npm · claix-ai — paquete del SDK de TypeScript
GitHub · Gaelproodoos/claix-typescript — código del SDK de TypeScript
Especificación OpenAPI — contrato HTTP que envuelve el SDK
Protocolo A2A — superficie JSON-RPC si no usas Python
Servidor MCP — IDEs y automatizaciones sin un proceso Python

2. Instalación

pip install claix-ai
pip install 'claix-ai[langchain]'
pip install 'claix-ai[crewai]'
pip install 'claix-ai[llamaindex]'
pip install 'claix-ai[all]'

El extra base trae httpx y Pydantic v2. Los extras de framework añaden los adapters documentados en esta sección.

3. Autenticación

Recomendado — variable de entorno:

export CLAIX_API_KEY=ck_...

O pasa api_key= a ClaixClient / AsyncClaixClient. El cliente envía x-api-key en cada petición (la API también acepta Bearer). Timeout por defecto 120s, con reintentos en 429, 502, 503, 504 y errores de transporte.

4. Inicio rápido

from claix import ClaixClient

client = ClaixClient()  # lee CLAIX_API_KEY
result = client.extract.pdf("invoice.pdf", schema_id="3c7a9f21-4b8e-4d1a-9c6f-2e0d8a5b7c4f")
print(result.data)

Cliente asíncrono:

from claix import AsyncClaixClient

async with AsyncClaixClient() as client:
    doc = await client.extract.pdf("invoice.pdf", schema_id="...")
    answers = await client.context.ask(doc.document_id, ["¿Cuál es el total?"])

5. Mapa de métodos (OpenAPI 1.8.2)

Método SDK	HTTP
client.extract.pdf(..., is_agent_mode=False)	POST /api/pdf-json o POST /agent/pdf-json
client.extract.excel(...)	POST /api/excel-json o POST /agent/excel-json
client.extract.document(...)	POST /api/doc-json o POST /agent/doc-json
client.extract.image(...)	POST /api/img-json o POST /agent/img-json
client.extract.text(content, schema_id, ...)	POST /api/txt-json o POST /agent/txt-json
client.extract.audio(...)	POST /api/audio-json o POST /agent/audio-json
client.extract.json_to_excel(schema_id=..., data=...)	POST /api/json-excel
client.context.get(document_id)	GET /get-document/{id}
client.context.ask(document_id, questions)	POST /document-context/{id} (máx. 5 × 400 caracteres)
client.context.delete(document_id)	DELETE /delete-document/{id}
client.context.replace(document_id, new_content_document_id)	POST /replace-document
client.spaces.create(name)	POST /create-space
client.spaces.add(document_id, space_id)	POST /add-space
client.spaces.ask(space_id, questions)	POST /space-context/{id}
client.spaces.remove_document(document_id)	DELETE /remove-document-from-space/{id}
client.spaces.delete(space_id)	DELETE /delete-space/{id}
client.schemas.list()	GET /api/schemas
client.schemas.get(schema_id)	GET /api/get-schema/{schema_id}
client.schemas.create(...)	POST /api/create-schema
client.schemas.update(schema_id, ...)	PUT /api/update-schema/{schema_id}
client.schemas.delete(schema_id)	POST /api/delete-schema

Las preguntas se envían como { question, format } (string, int, boolean, timestamp o array). Un string suelto se manda como format: "string". ia_response sigue el format pedido, o null si falta evidencia. Si la verificación de fuente está activada en consulta a documentos o a espacio de conocimiento, cada ítem pasa a {value, source}. Extracción y modo agente incluyen log_id; con verificación de fuente en el schema cada campo es {value, source}.

6. Errores

Todos heredan de ClaixError y exponen status_code más el payload {error, detalle}: ClaixAuthenticationError (401), ClaixNotFoundError (404), ClaixValidationError (400/413/422), ClaixRateLimitError (429), ClaixTimeoutError, ClaixConnectionError, ClaixAPIError (5xx).