Acceso multi-inquilino de agentes de IA a la base de datos: cómo aislar los datos de cada cliente
Aprende a dar a los agentes de IA acceso multi-inquilino a la base de datos sin exponer datos de clientes. Aislamiento de inquilinos, recuperación acotada, guardrails de escritura y auditoría con Claix.
Claix · Actualizado noviembre 2026. Guías relacionadas: permisos de acceso a base de datos para agentes de IA (/es/blog/ai-agents-database-access-permissions), guardrails de base de datos para agentes de IA (/es/blog/database-guardrails-for-ai-agents), por qué el acceso SQL directo es peligroso (/es/blog/why-ai-agent-direct-sql-access-is-dangerous) y la guía existente de recuperación multi-tenant (/es/blog/multi-tenant-ai-agent-database-access). Productos: Claix Retrieve y Claix Guard.
Cuando un agente de IA atiende a varios clientes, el acceso a la base de datos deja de ser un detalle de seguridad menor.
Un agente de soporte puede necesitar responder preguntas sobre los pedidos de un cliente. Un agente de operaciones puede necesitar comprobar el inventario de un restaurante. Un asistente de ventas puede necesitar actualizar un deal de una organización.
En cada caso, el agente solo debería alcanzar los datos que pertenecen al cliente o tenant que hace la petición.
Este es el reto central de los agentes de IA multi-tenant: «¿Cómo dejas que un agente use datos de negocio en tiempo real sin dejarle acceder a los datos de otro tenant?»
Esta guía explica cómo diseñar el acceso multi-tenant a la base de datos para agentes de IA, por qué el acceso de solo lectura no basta, y cómo Claix ayuda a los equipos a controlar lo que los agentes pueden recuperar y cambiar.
¿Qué es el acceso multi-tenant de agentes de IA?
El acceso multi-tenant de agentes de IA significa que un sistema de agentes puede atender a varios clientes, organizaciones o usuarios manteniendo sus datos separados.
Un tenant puede ser:
- Una cuenta de cliente en un producto SaaS.
- Una organización que usa tu plataforma.
- Un restaurante, tienda o ubicación.
- Un equipo dentro de una empresa.
- Un usuario final individual.
El objetivo es simple: cuando el Tenant A hace una pregunta, el agente no debería poder recuperar ni modificar los datos del Tenant B.
Eso aplica tanto a lecturas como a escrituras.
Un agente puede tener permitido consultar una base de datos. Incluso puede tener un rol de solo lectura. Pero si puede recuperar registros de todos los tenants, sigue pudiendo exponer datos que nunca debería ver.
Por qué el acceso de solo lectura no basta
El acceso de solo lectura impide que un agente cree, actualice o elimine registros a través de esa conexión.
No define qué registros puede leer el agente.
Un rol de solo lectura aún puede acceder a:
- Pedidos que pertenecen a otro cliente.
- Datos de contacto de clientes fuera del tenant actual.
- Notas internas o datos operativos.
- Información financiera que un usuario concreto no debería ver.
- Conjuntos de resultados grandes que no deberían entrar en el contexto del modelo.
Por ejemplo, un agente de soporte puede necesitar responder: «¿Cuál es el estado de mi último pedido?» No debería necesitar acceso a todos los pedidos de la base de datos.
El límite de permisos debe incluir el contexto del tenant, no solo el rol de la base de datos.
Las cuatro capas del acceso multi-tenant de agentes de IA
Una configuración multi-tenant segura necesita varias capas trabajando juntas.
| Capa | Qué controla | Por qué importa |
|---|---|---|
| Identidad del tenant | Qué cliente o usuario hace la petición | Establece el alcance de la petición |
| Privilegios de base de datos | Qué puede hacer el rol de la base | Impide escrituras no autorizadas a nivel de base |
| Row-level security | A qué filas puede acceder un rol | Ayuda a aislar registros entre tenants |
| Alcance de recuperación | Qué tablas y columnas puede usar un agente | Limita la superficie de datos del agente |
| Guardrails de escritura | Qué cambios puede proponer un agente | Impide escrituras inseguras o no conformes |
| Rastros de auditoría | Qué se pidió, se permitió y se ejecutó | Hace revisable la actividad |
Ninguna capa basta por sí sola.
Los privilegios de base de datos son la base. El row-level security ayuda a aislar registros. El alcance de recuperación limita a qué puede acceder un agente. Los guardrails controlan las escrituras. Los rastros de auditoría hacen revisable el sistema.
Empieza por la identidad del tenant
Cada petición necesita una identidad de tenant de confianza.
No confíes en que el agente decida a qué tenant está atendiendo. La aplicación debe establecer ese contexto antes de llamar al agente.
Una petición debería llevar información como:
- El usuario autenticado.
- El ID del tenant o de la organización.
- El rol o nivel de permiso.
- La tarea que el agente tiene permitido realizar.
Ese contexto debe venir de tu sistema de autenticación y autorización, no de un prompt ni de una respuesta del modelo.
Una vez conocido el tenant, cada consulta y cada escritura a la base de datos deben evaluarse dentro de ese límite.
Usa row-level security para el aislamiento entre tenants
El row-level security es uno de los controles de base de datos más importantes en sistemas multi-tenant.
Te permite definir reglas a nivel de base de datos para que un rol solo pueda acceder a las filas que pertenecen a un tenant concreto.
Por ejemplo, si los pedidos contienen un tenant_id, una política de row-level security puede asegurar que un rol de base de datos solo vea las filas en las que ese ID de tenant coincida con el contexto actual.
Esto importa porque crea una defensa que no depende de que el agente se comporte correctamente.
Claix recomienda explícitamente mantener el row-level security cuando distintas personas o tenants comparten una tabla.
Una capa de recuperación puede restringir a qué tablas y columnas puede acceder un agente. Pero el row-level security sigue siendo esencial cuando varios tenants comparten las mismas tablas.
Controla lo que los agentes pueden recuperar
Incluso con row-level security, los agentes no deberían tener automáticamente acceso a todas las tablas y columnas.
Un agente de soporte puede necesitar el estado de pedidos y la información de contacto del cliente. Puede que no necesite detalles de pago, notas internas o datos operativos.
Un agente de operaciones puede necesitar inventario y datos de turnos. Puede que no necesite registros de clientes.
Aquí es donde ayuda Claix Retrieve.
Claix se conecta a una base de datos relacional y permite que cada agente recupere solo las tablas y columnas que tú permites, guiado por tus propias reglas y devolviendo resultados validados o respuestas tipadas.
Las rutas definen el límite de recuperación
En Claix, una ruta define una capacidad de recuperación.
Una ruta especifica:
- A qué tablas puede acceder un agente.
- Qué columnas puede recuperar.
- Una guía con tus reglas y tu vocabulario.
Creas una ruta una vez y la asocias a tantos agentes como necesites.
Por ejemplo:
- Un agente de soporte puede usar una ruta que incluye pedidos y clientes.
- Un agente de operaciones puede usar una ruta que incluye inventario y turnos.
- Un agente interno de analítica puede usar una ruta distinta con un acceso más amplio.
La ruta define lo que el agente puede recuperar. No sustituye el aislamiento entre tenants.
Los agentes definen el límite de acceso
En Claix, un agente es la identidad que usa una o más rutas.
Cada agente tiene:
- Su propio endpoint.
- Su propio prompt de negocio.
- Sus propias rutas asociadas.
- Su propio modo de respuesta.
Esto significa que un bot de soporte y un asistente interno pueden compartir la misma base de datos viendo datos distintos.
En sistemas multi-tenant, esto es útil porque distintos agentes pueden tener distintos límites de recuperación.
Un agente orientado al cliente debería tener una superficie más estrecha que un agente interno de operaciones.
Valida las consultas antes de ejecutarlas
Claix valida las consultas antes de ejecutarlas. Cada petición debe permanecer dentro de las tablas y columnas permitidas por las rutas del agente.
Esto significa que un agente no puede consultar libremente todo el esquema de la base de datos.
Si una pregunta requiere información fuera del perímetro permitido, el campo vuelve vacío en lugar de una conjetura. Las consultas solo se ejecutan dentro de las rutas asociadas al agente.
Esto es útil en sistemas multi-tenant porque reduce la posibilidad de que un agente alcance datos fuera de su alcance previsto.
Devuelve respuestas tipadas, no texto libre
En sistemas multi-tenant, los agentes a menudo necesitan tomar decisiones a partir de datos.
Por ejemplo:
- ¿Este artículo está en stock?
- ¿Cuántos pedidos están pendientes?
- ¿Qué clientes necesitan seguimiento?
- ¿Cuál es el estado actual de esta reserva?
Claix Retrieve puede devolver valores tipados como booleanos, números, listas y objetos JSON. Esto facilita construir flujos fiables porque tu código puede ramificarse sobre un valor claro en lugar de interpretar texto libre.
Las respuestas tipadas también reducen la ambigüedad. El agente recibe un valor que puede usar directamente.
Controla lo que los agentes pueden escribir
Los sistemas multi-tenant no solo tratan de lecturas.
Un agente puede necesitar crear, actualizar o eliminar registros. Eso crea un riesgo mayor porque un error puede afectar a datos de clientes.
Claix Guard es un comprobador de reglas para los cambios de base de datos que propone un agente de IA. Antes de que un agente ejecute un INSERT, UPDATE o DELETE, Guard lo comprueba contra reglas que tú aprobaste.
El resultado es simple:
- Allow: tu código puede ejecutar la sentencia.
- Deny: tu código no debe ejecutarla, y el agente recibe el motivo.
No hay un tercer veredicto. Si un cambio debe ser revisado por una persona, Guard lo deniega y tu propio flujo encamina esa denegación para su revisión.
Claix Guard no ejecuta la sentencia. Tu propio código sí, con sus propias credenciales de base de datos.
Qué puede aplicar Guard
Claix Guard te permite definir reglas en lenguaje llano, revisar las reglas exactas propuestas y aprobarlas antes de aplicarlas.
Ejemplos:
- Los agentes pueden crear y actualizar pedidos, pero nunca eliminarlos.
- Los agentes pueden actualizar el estado de un pedido, pero nunca su precio.
- Los descuentos no pueden superar el 20 por ciento.
- Los reembolsos por encima de un umbral se deniegan para que tu flujo los envíe a una persona.
- Una actualización o un borrado debe dirigirse a un registro concreto.
- Ciertas transiciones de estado no están permitidas.
- El número de reembolsos por hora está limitado.
Estas son reglas de negocio. Van más allá de lo que un rol de base de datos o una restricción de esquema suelen expresar.
Por qué Guard importa en sistemas multi-tenant
En un sistema multi-tenant, una escritura puede afectar a más de un cliente si el límite es incorrecto.
Por ejemplo, un agente puede tener permitido actualizar un pedido. Pero si puede actualizar cualquier pedido, podría cambiar un registro que pertenece a otro tenant.
Guard ayuda a controlar el cambio propuesto. Puede exigir que una actualización o un borrado se dirija a un registro concreto.
Pero Guard no sustituye el row-level security. Sigue haciendo falta el aislamiento entre tenants a nivel de base de datos para asegurar que un rol no pueda acceder a las filas de otro tenant.
Mantén las credenciales fuera del agente
Un error habitual es dar al agente credenciales de escritura directas.
Si un agente tiene credenciales de escritura, puede saltarse los controles a nivel de aplicación. Puede llamar a la base de datos directamente y omitir Guard.
El patrón recomendado es:
- No dar al agente credenciales de escritura.
- Mantener las credenciales de escritura en una sola función ejecutora de tu código.
- Hacer que ese ejecutor llame a Guard antes de cada escritura.
- Ejecutar la sentencia solo si Guard devuelve allowed.
- Devolver el motivo de denegación al agente cuando la respuesta sea denied.
Claix Guard puede comprobar la acción, pero tu arquitectura debe asegurar que el ejecutor sea la única ruta hacia la base de datos.
Audita cada petición
En sistemas multi-tenant, los rastros de auditoría son esenciales.
Necesitas saber:
- Qué tenant hizo la petición.
- Qué agente la gestionó.
- Qué datos intentó recuperar.
- Qué ruta respondió.
- Qué se devolvió.
- Qué escrituras se propusieron.
- Qué reglas se aplicaron.
- Qué se permitió o se denegó.
Claix traza cada petición. Puedes revisar qué se preguntó, qué ruta respondió y qué se devolvió.
Para escrituras, cada decisión de Guard queda registrada. Puedes revisar qué se propuso y por qué se permitió o se denegó.
Esto crea un rastro de auditoría útil cuando necesitas investigar un incidente o mejorar el comportamiento de un agente.
Errores habituales en sistemas multi-tenant de agentes de IA
Confiar solo en prompts
Un prompt puede guiar el comportamiento, pero no es un sistema de permisos. Los controles técnicos deben decidir qué puede hacer un agente.
Dar al agente acceso completo a la base de datos
Aunque el agente tenga un rol de solo lectura, no debería acceder automáticamente a todas las tablas y columnas.
Ignorar los límites entre tenants
Si varios clientes comparten la misma base de datos, el aislamiento a nivel de fila y las reglas de recuperación conscientes del tenant son esenciales.
Dejar que el agente conserve credenciales de escritura
Si el agente puede llegar a la base de datos directamente, puede saltarse Guard y otros controles a nivel de aplicación.
Omitir los rastros de auditoría
Cuando algo falla, necesitas saber qué pidió el agente, qué regla se aplicó y qué hizo el sistema.
Cómo encaja Claix en una arquitectura multi-tenant
Claix no sustituye los permisos de la base de datos. Añade una capa de control encima de ellos.
| Control | Propósito |
|---|---|
| Identidad del tenant | Establece qué cliente o usuario hace la petición |
| Row-level security | Aísla registros entre tenants a nivel de base de datos |
| Rutas de Claix Retrieve | Definen qué tablas y columnas puede leer cada agente |
| Reglas de Claix Guard | Definen qué escrituras están permitidas y por qué |
| Registros de auditoría y trazas | Registran peticiones, decisiones y resultados |
Para lecturas, Claix Retrieve define el límite de recuperación. Para escrituras, Claix Guard comprueba los cambios propuestos antes de que tu código los ejecute.
Juntos ayudan a los equipos a construir agentes de IA multi-tenant sin dar a los agentes acceso sin restricciones a la base de datos.
Cómo empezar con Claix
Claix Retrieve admite Postgres, incluidas configuraciones compatibles con Postgres como Supabase. Conectas una base de datos con un rol de solo lectura, revisas el Data Map generado, defines rutas y agentes, y luego llamas a un endpoint desde tu stack existente.
Claix está disponible a través de REST, MCP y A2A. Eso significa que puedes usarlo con frameworks de agentes, clientes compatibles con MCP, herramientas de automatización y sistemas que puedan enviar peticiones HTTP.
Para equipos que necesitan controlar escrituras, Claix Guard admite PostgreSQL, MySQL y MariaDB.
Preguntas frecuentes
- ¿Qué es el acceso multi-tenant de agentes de IA a la base de datos?
- Significa que un sistema de agentes puede atender a varios clientes, organizaciones o usuarios manteniendo sus datos separados tanto en lecturas como en escrituras.
- ¿Basta un rol de solo lectura para agentes de IA multi-tenant?
- No. Un rol de solo lectura impide escrituras a través de esa conexión, pero no decide a las filas de qué tenant puede leer el agente. Sigue haciendo falta identidad de tenant, row-level security y recuperación acotada.
- ¿Claix sustituye el row-level security?
- No. Claix Retrieve acota tablas y columnas por agente. El row-level security sigue siendo esencial cuando varios tenants comparten las mismas tablas.
- ¿Cómo ayuda Claix Guard en sistemas multi-tenant?
- Guard comprueba las sentencias INSERT, UPDATE y DELETE propuestas contra reglas aprobadas y puede exigir un registro concreto como objetivo. Solo devuelve allow o deny. No ejecuta SQL y no sustituye el aislamiento entre tenants a nivel de base de datos.
- ¿De dónde debería venir la identidad del tenant?
- De tu sistema de autenticación y autorización. No confíes en el agente ni en un prompt para decidir a qué tenant está atendiendo.
- ¿Puede un agente conservar credenciales de escritura en una configuración multi-tenant?
- No debería. Mantén las credenciales de escritura en un ejecutor de confianza, llama a Guard antes de cada escritura y ejecuta solo cuando Guard devuelva allow.
- ¿Qué bases de datos admite Claix para agentes multi-tenant?
- Claix Retrieve se conecta con un rol de solo lectura a Postgres, incluidas configuraciones compatibles con Postgres como Supabase. Claix Guard admite PostgreSQL, MySQL y MariaDB.
Conclusión
El acceso multi-tenant de agentes de IA a la base de datos requiere más que un usuario y una contraseña.
Necesitas controlar:
- Qué tenant hace la petición.
- A qué registros puede acceder el agente.
- Qué tablas y columnas puede recuperar.
- Qué escrituras puede proponer.
- Qué reglas de negocio aplican.
- Qué ocurrió después de la ejecución.
Claix ayuda a los equipos a controlar ambos lados:
- Retrieve limita y estructura lo que los agentes pueden leer.
- Guard comprueba las escrituras propuestas antes de que se ejecuten.
- Las trazas hacen revisables las peticiones y las decisiones.
Si estás construyendo agentes de IA que atienden a varios clientes, diseña el aislamiento entre tenants como un sistema, no como una ocurrencia tardía. Empieza con Claix Retrieve y Claix Guard.
También te podría interesar…
Guía · Agentes
Agentes de IA multi-inquilino: tu agente necesita límites por fila, no solo permisos de tabla
Guía · Seguridad
Permisos de acceso a la base de datos para agentes de IA: cómo controlar qué pueden leer y escribir
Guía · Guard
Guardrails de base de datos para agentes de IA: cómo impedir escrituras inseguras antes de que se ejecuten
Seguridad · Postgres
Rol Postgres de solo lectura para agentes de IA: configuración paso a paso