Claix es la capa controlada de recuperación de datos y de seguridad para agentes de IA: se conecta a tu base relacional y permite que cada agente recupere solo las tablas y columnas que tú autorizas y ejecute solo las acciones permitidas según tus reglas y límites, sin mover tus datos. Disponible vía API REST, MCP y A2A.

Conecta cualquier base de datos SQL 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), escribe reglas de Guard en lenguaje natural para los cambios que un agente puede proponer, y llama a un endpoint para que tu agente obtenga respuestas tipadas en vivo y un veredicto antes de cualquier cambio, 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 nunca escribe en tu base de datos. Retrieve se conecta con un rol de solo lectura. Cuando un agente propone un INSERT, UPDATE o DELETE, Claix Guard responde permitir o denegar, con el motivo, y tu código ejecuta. Cargar documentos en campos estructurados es un producto aparte, Claix Ingest, que usas solo si lo eliges.

¿Qué bases de datos admite Claix?

Cualquier base de datos SQL, incluidas Postgres, MySQL y MariaDB, y los entornos compatibles con Postgres como Supabase. Te conectas con un rol de solo lectura. Claix nunca ejecuta escrituras: Guard solo responde si un cambio propuesto está permitido, y tu código lo ejecuta.

¿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?

Cada cuenta tiene 30 llamadas exitosas gratis al mes, sin tarjeta. Después, la IA gestionada de Claix cuesta 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. Claix Guard cuesta 0,01 € por llamada: cada comprobación de un INSERT, UPDATE o DELETE. En esa comprobación no hay modelo ni IA gestionada.

¿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 tu base SQL, 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, Claix Guard —que comprueba cada cambio propuesto contra reglas exactas antes de que tu código lo ejecute— y una traza revisable: defines el límite una vez y se aplica en cada llamada.

TypeScript SDK

Cliente oficial de Claix en TypeScript

Endpoint

NPMnpm install claix-ai

El paquete npm claix-ai expone ClaixClient, el mismo mapa de llamadas que el SDK de Python. Las llamadas principales son client.retrieve.ask (lecturas en vivo) y client.guard.check (permitir o denegar un INSERT, UPDATE o DELETE). Ingest sigue en el mismo cliente. El cliente es async (Node.js 18+).

Las tools de CrewAI en TypeScript usan @crewai-ts/core (claix-ai/crewai). El runtime oficial de CrewAI en Python sigue en pip install 'claix-ai[crewai]'.

1. Instalación

npm install claix-ai
npm install claix-ai @langchain/core zod
npm install claix-ai @crewai-ts/core
npm install claix-ai llamaindex

La API key va en CLAIX_API_KEY o en el constructor (apiKey). El cliente envía x-api-key.

2. Inicio rápido

import { ClaixClient } from "claix-ai";

const client = new ClaixClient();
const answers = await client.retrieve.ask("orders-agent", [
  { question: "How many orders are confirmed?", format: "int" },
]);
const decision = await client.guard.check(
  "UPDATE orders SET discount = $1 WHERE id = $2",
  { params: [0.35, 90421] },
);
console.log(answers.ia_response, decision.allowed, decision.reason);

3. Mapa de métodos

Método	HTTP
client.retrieve.ask(agentName, questions)	POST /retrieve/{agent_name}
client.guard.check(sql, { params, connectionId })	POST /check-sql
client.extract.pdf / excel / document / image / audio / text	POST /api/-json o POST /agent/-json
client.extract.jsonToExcel({ schemaId, data })	POST /api/json-excel
client.context.get / ask / delete	GET /get-document, POST /document-context, DELETE /delete-document
client.context.replace(documentId, newContentDocumentId)	POST /replace-document
client.spaces.create / add / ask / removeDocument / delete	create-space, add-space, space-context, remove-document-from-space, delete-space
client.schemas.list / get / create / update / delete	GET /api/schemas, GET /api/get-schema, POST /api/create-schema, PUT /api/update-schema, POST /api/delete-schema

Retrieve acepta string, int, boolean, timestamp, timestamptz, timestampz, date, json, array, array:string y array:int. Las preguntas de un documento o un espacio siguen en string, int, boolean, timestamp o array. Una denegación de Guard sigue siendo HTTP 200. connectionId solo hace falta si la cuenta tiene más de una conexión activa.