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.

¿Qué es un agente en Claix?

Un endpoint con nombre, prompt de negocio, un conjunto de rutas y un modo de respuesta, que responde preguntas desde tu base de datos.

¿Un agente Claix es lo mismo que mi agente de IA?

No. Tu agente de IA decide qué hacer. Un agente Claix recupera datos para él, y solo desde las rutas asignadas.

¿Cómo llamo a un agente?

Envía tus preguntas a la URL del agente, que es /retrieve/ seguido de su nombre, y autentica con tu API key.

¿Un agente puede usar varias rutas?

Sí. El prompt de negocio le dice cuándo usar cada una.

¿Puedo hacer varias preguntas a la vez?

Sí. Envía una lista de preguntas en una petición y recibe las respuestas en el mismo orden.

¿Cuál es la diferencia entre Data y Answer?

Data devuelve el resultado de la consulta tal cual. Answer devuelve una respuesta razonada en el tipo pedido, y las filas se envían al modelo para producirla.

¿Cómo pruebo un agente?

Usa el Sandbox para hacer preguntas reales y revisa las peticiones en Traces.

Volver al inicio

Claix Retrieve · Agentes

Agentes: un endpoint, un trabajo, solo los datos que permites

Un agente Claix es el endpoint que tu aplicación o tu propio agente de IA llama para obtener respuestas de tu base de datos. Tiene un nombre que forma su URL, un prompt de negocio que explica su trabajo, las rutas que puede usar y un modo de respuesta. Lo creas una vez y lo llamas desde cualquier sitio.

Sin código que escribir y nada que hospedar. Tu agente de IA decide qué hacer. Un agente Claix solo recupera datos para él, dentro de los límites que tú defines.

Crea tu primer agente Pruébalo en el Sandbox

Relacionado

Definición

¿Qué es un agente?

Un agente Claix es la identidad que hace preguntas a tu base de datos a través de Claix. No es lo mismo que el agente de IA que tú construyes. Tu agente decide qué hacer. Un agente Claix solo recupera datos para él, dentro de los límites que defines.

Todo agente tiene cinco partes.

Un nombre. Forma la URL del agente: /retrieve/ seguido del nombre que elijas.
Una descripción. Para qué sirve el agente.
Un prompt de negocio. Su trabajo y cuándo usar cada ruta.
Rutas. Las rutas que el agente puede usar, que deciden las tablas y columnas a las que llega.
Un modo de respuesta. Si recibes el resultado en bruto de la consulta o una respuesta razonada.

En ejecución

Qué hace un agente cuando tu aplicación pregunta

01
Tu aplicación envía preguntas a la URL del agente
Una o varias, cada una con el tipo de respuesta que esperas.
02
Claix elige una ruta
Entre las rutas asignadas a ese agente. Si ninguna encaja, no improvisa.
03
Una consulta de solo lectura
Usando solo las tablas y columnas de esa ruta.
04
El modo de respuesta decide la forma
El resultado en bruto de la consulta, o una respuesta razonada en el tipo que pediste.
05
Las respuestas vuelven en orden
Con un log_id que puedes consultar en Traces.

Por qué agentes

Por qué usar agentes

Un endpoint por trabajo
Un bot de soporte, un asistente interno y una comprobación de workflow tienen cada uno su agente, con su propia URL.
Agentes distintos, datos distintos
Cada agente solo usa las rutas asignadas, así que dos agentes sobre la misma base pueden ver tablas y columnas distintas.
Tus reglas en lenguaje claro
El prompt de negocio es texto que puedes leer y cambiar.
Datos en bruto o respuesta razonada
Tú eliges qué vuelve, para cada agente.
Varias preguntas en una petición
Envía una lista y recibe una lista de respuestas.
Prueba antes de conectar
Prueba un agente con preguntas reales en el Sandbox y revisa las peticiones en Traces.

Configuración

Cómo crear un agente

01
Conecta tu base, publica el Data Map y crea tus rutas
Un agente usa las rutas que hayas preparado.
02
Crea el agente
Dale un nombre y una descripción. El nombre es la última parte de su URL.
03
Escribe el prompt de negocio
Explica qué hace el agente y cuándo usar cada ruta.
04
Asigna rutas
Elige las rutas que este agente puede usar.
05
Elige el modo de respuesta
El resultado en bruto de la consulta, o una respuesta razonada.
06
Pruébalo en el Sandbox
Después llámalo desde tu aplicación.

Respuesta

Qué recibes de vuelta

Esta es la respuesta de un agente al que se le hicieron tres preguntas. Cada pregunta indica el tipo de respuesta esperado, y las respuestas vuelven en el mismo orden, con un log_id.

La primera respuesta es null porque el teléfono no está en los datos que el agente puede usar. Claix no inventa un valor.

[
  {
    "user_ask": [
      {
        "question": "What is the phone number of the employee named Carlos?",
        "format": "string"
      },
      {
        "question": "Has the customer Javier Perez accepted marketing consent?",
        "format": "boolean"
      },
      {
        "question": "What is Marta's job title?",
        "format": "string"
      }
    ],
    "ia_response": [
      null,
      true,
      "Waiter"
    ],
    "log_id": "9ff38974-1392-4c1a-83e5-3b2f09bb43dc"
  }
]

Modos

Modos de respuesta

Cada agente tiene un modo de respuesta. En modo Answer, las filas de la consulta se envían al modelo para que redacte la respuesta. Si tus datos son sensibles, tenlo en cuenta al elegir el modo.

Modo	Qué recibes	Sirve para
Data	El resultado de la consulta, tal como sale de tu base	Código y otros agentes que procesan el resultado ellos mismos
Answer	Una respuesta razonada en el tipo pedido: texto, número, verdadero/falso, fecha, lista o JSON	Resultados que van directo a una persona o a un workflow que necesita un solo valor

Prompt de negocio

Cómo escribir un buen prompt de negocio

El prompt de negocio dice al agente cuál es su trabajo y cuándo usar cada ruta. También ayuda a interpretar tus datos, por ejemplo qué significa un código. Lo que el agente puede alcanzar de verdad lo deciden las rutas asignadas.

Eres el asistente de reservas de un grupo de restaurantes.
Usa la ruta Bookings para preguntas sobre reservas y mesas.
Usa la ruta Staff para preguntas sobre turnos y roles.
No respondas preguntas sobre pagos.
El estado C significa confirmada, P pendiente y X cancelada.

Para qué sirve el agente y a quién atiende.
Cuándo usar cada ruta.
Qué no debe responder.
Qué significan tus términos y códigos.

Roles

Agentes y rutas

Creas la ruta una vez y la asignas a los agentes que la necesiten. Un agente de soporte y un asistente interno pueden trabajar sobre la misma base y ver datos distintos, porque cada uno tiene rutas distintas.

Agente	Ruta
Decide quién pregunta y qué rutas puede usar	Decide qué datos se pueden usar y cómo leerlos
Contiene nombre, descripción, prompt de negocio, rutas y modo de respuesta	Contiene nombre, descripción, tablas, columnas y una guía
Tiene URL propia: sí	Tiene URL propia: no

Ejemplos

Cómo podrías montar agentes

Son ejemplos de configuración. No son historias de clientes.

Un asistente de RR. HH.
Un agente con una ruta Staff y un prompt que dice que responde sobre roles de empleados. Pregunta: ¿Cuál es el puesto de Marta? Modo: Answer, con respuesta de texto.
Una comprobación de consentimiento para un workflow
Un agente con una ruta Customers que solo incluye name y marketing consent. Pregunta: ¿El cliente Javier Pérez ha aceptado el consentimiento de marketing? Modo: Answer, con true o false para tu workflow.
Un asistente de reservas
Un agente con rutas Bookings y Tables. Pregunta: ¿Cuál es la próxima reserva de Javier Pérez? Modo: Answer, con un objeto de detalle, o Data si tu código monta la respuesta.
Un agente de soporte de pedidos
Un agente con una ruta Orders. Pregunta: ¿Cuántos pedidos se han enviado este mes? Modo: Data, si otro sistema procesará el resultado.

Importante

Conviene saber

Un agente solo puede usar sus rutas asignadas; lo que alcanza lo definen ellas y el rol con el que Claix se conecta a tu base. Usa un rol de solo lectura.
El acceso es por agente, no por usuario final. Un agente puede leer todo lo que incluyen sus rutas, para quien o lo que lo llame.
Mantén la API key en el servidor. Autentica las peticiones ahí. No la pongas en código de navegador o móvil.
Si el dato no está, la respuesta queda vacía. Claix no inventa un valor.
Tú eliges el modelo. En LLM Keys, usa Claix Managed AI o tu propia clave de proveedor.

Preguntas frecuentes

¿Qué es un agente en Claix?: Un endpoint con nombre, prompt de negocio, un conjunto de rutas y un modo de respuesta, que responde preguntas desde tu base de datos.
¿Un agente Claix es lo mismo que mi agente de IA?: No. Tu agente de IA decide qué hacer. Un agente Claix recupera datos para él, y solo desde las rutas asignadas.
¿Cómo llamo a un agente?: Envía tus preguntas a la URL del agente, que es /retrieve/ seguido de su nombre, y autentica con tu API key.
¿Un agente puede usar varias rutas?: Sí. El prompt de negocio le dice cuándo usar cada una.
¿Puedo hacer varias preguntas a la vez?: Sí. Envía una lista de preguntas en una petición y recibe las respuestas en el mismo orden.
¿Cuál es la diferencia entre Data y Answer?: Data devuelve el resultado de la consulta tal cual. Answer devuelve una respuesta razonada en el tipo pedido, y las filas se envían al modelo para producirla.
¿Cómo pruebo un agente?: Usa el Sandbox para hacer preguntas reales y revisa las peticiones en Traces.

Crea tu primer agente

Conecta tu base de datos, prepara tus rutas y da a tus agentes de IA una forma controlada de obtener respuestas.

Crea tu primer agente Pruébalo en el Sandbox

Agentes: un endpoint, un trabajo, solo los datos que permites

¿Qué es un agente?

Qué hace un agente cuando tu aplicación pregunta

Tu aplicación envía preguntas a la URL del agente

Claix elige una ruta

Una consulta de solo lectura

El modo de respuesta decide la forma

Las respuestas vuelven en orden

Por qué usar agentes

Un endpoint por trabajo

Agentes distintos, datos distintos

Tus reglas en lenguaje claro

Datos en bruto o respuesta razonada

Varias preguntas en una petición

Prueba antes de conectar

Cómo crear un agente

Conecta tu base, publica el Data Map y crea tus rutas

Crea el agente

Escribe el prompt de negocio

Asigna rutas

Elige el modo de respuesta

Pruébalo en el Sandbox

Qué recibes de vuelta

Modos de respuesta

Cómo escribir un buen prompt de negocio

Agentes y rutas

Cómo podrías montar agentes

Un asistente de RR. HH.

Una comprobación de consentimiento para un workflow

Un asistente de reservas

Un agente de soporte de pedidos

Conviene saber

Preguntas frecuentes

Crea tu primer agente