Volver al blog
Guía · Agentes

Agentes de IA multi-inquilino: tu agente necesita límites por fila, no solo permisos de tabla

Los permisos de tabla no dicen qué cliente puede leer un agente. La configuración multi-inquilino pone un límite de filas en el agente, para que solo recupere el inquilino, usuario o contexto que le asignas.

Casi todos los equipos que construyen agentes de IA acaban en la misma pregunta:

«¿Cómo dejo que un agente llegue a los datos que necesita sin dejarle llegar a todo lo demás?»

La respuesta habitual es crear un usuario de base con permisos limitados. Puedes permitirle leer ciertas tablas. Puedes excluir columnas sensibles. Puedes dejar la conexión en solo lectura.

Es un buen punto de partida. No es un modelo de acceso completo para un agente de IA.

Un rol de solo lectura responde si el agente puede escribir. No responde sobre qué cliente, organización, proyecto, espacio de trabajo o usuario puede leer.

Esa diferencia se vuelve crítica en el momento en que despliegas un agente en un producto multi-inquilino.

Un agente de soporte puede tener que responder sobre un pedido. Un asistente interno puede tener que revisar fichas de clientes. Un workflow puede tener que comprobar si un usuario aceptó el consentimiento de marketing. En cada caso, el agente no debería tener acceso a «la tabla de clientes» o «la tabla de pedidos».

Solo debería poder recuperar las filas que pertenecen al inquilino, usuario, organización o contexto de negocio al que atiende.

Eso es el acceso multi-inquilino de un agente a la base, y es lo que imponen los agentes de Claix.

Por qué no bastan los permisos de tabla y columna

Los permisos clásicos de una base se diseñan alrededor de roles y objetos.

Puedes dar a un rol permiso para leer una tabla. Puedes restringir columnas. Puedes impedir escrituras. Puedes limitar lo que un usuario de base puede hacer a nivel de base.

Para un agente de IA, esos controles son necesarios, y dejan un hueco. El agente puede tener permiso para leer la tabla de clientes, y eso no dice qué clientes puede recuperar. Puede leer la tabla de pedidos, y eso no dice si puede ver pedidos de otra organización.

Aparece una distancia entre el permiso técnico y la autorización de negocio.

PreguntaQué responde un permiso de tabla o columnaQué no responde
¿Este rol puede leer esta tabla?Sí o noQué filas puede recuperar
¿Este rol puede leer esta columna?Sí o noSi la fila pertenece al inquilino actual
¿Este rol puede escribir en esta tabla?Sí o noSi la escritura encaja con el contexto actual
¿Este agente puede acceder a datos de clientes?Sí o noA qué clientes puede acceder
¿Este agente puede acceder a datos de pedidos?Sí o noA qué pedidos puede acceder

En una herramienta interna de un solo inquilino, esto puede parecer manejable. En un SaaS, un marketplace, un CRM, una plataforma de RR. HH., un sistema de soporte o cualquier aplicación en la que varios clientes comparten la misma base, pasa a ser un requisito de seguridad y de producto.

Un agente que puede recuperar registros de otro inquilino no está devolviendo una respuesta incómoda. Puede estar exponiendo datos de negocio confidenciales, información personal, registros financieros o datos operativos internos.

La capa que falta: límites por fila

Los agentes de Claix ya separan dos responsabilidades.

El agente es el endpoint al que llama tu aplicación o tu agente de IA. Tiene un nombre, una URL, un prompt de negocio, rutas y un modo de respuesta. Decide qué rutas puede usar, y no decide por sí solo a qué datos puede llegar.

La ruta define los datos disponibles para un propósito: las tablas y columnas que puede usar, y una guía para interpretarlos.

Con la configuración multi-inquilino, Claix añade un tercer límite en el agente: qué filas puede recuperar. La ruta sigue decidiendo tablas y columnas. El agente decide las filas.

En vez de decir solo «este agente puede acceder a clientes y pedidos», puedes definir «este agente puede acceder a clientes y pedidos, pero solo a las filas del inquilino X».

El acceso deja de ser una capacidad amplia y pasa a ser una regla de recuperación acotada y determinista.

LímiteQué controlaEjemplo
Acceso a tablasQué tablas puede usar el agentePedidos, clientes, reservas
Acceso a columnasQué campos puede recuperarEstado del pedido, nombre, consentimiento
Acceso a filasQué registros puede recuperarPedidos de un inquilino o un usuario
Prompt de negocioCómo interpreta su trabajo«Responde solo preguntas de reservas»
Modo de respuestaCómo se devuelve el resultadoDatos en bruto o una respuesta razonada

La idea es simple: no hay que fiarse de que el agente deduzca los límites del inquilino a partir de un prompt.

Un prompt puede orientar el comportamiento. Puede explicar el papel del agente. Puede decir qué ruta usar y qué significa un código de estado. Un prompt no es un límite de seguridad.

Una regla multi-inquilino sí lo es.

Qué significa multi-inquilino para un agente de IA

Multi-inquilino no significa solo que varios clientes usen la misma aplicación.

Significa que la misma infraestructura de datos sirve a contextos aislados, y que cada contexto solo debe ver los registros que le pertenecen.

Ese contexto puede ser:

  • Una cuenta de cliente
  • Una organización
  • Una empresa
  • Un espacio de trabajo
  • Un proyecto
  • Un equipo
  • Una tienda
  • Un usuario
  • Una unidad de negocio
  • Una región o una entidad legal

El modelo exacto depende de tu producto. El principio, no.

El agente debe trabajar dentro del contexto de la petición.

Si un usuario pregunta «¿cuáles son mis pedidos recientes?», el agente debe recuperar los pedidos de ese usuario. Si una organización pregunta «¿cuántas suscripciones activas tenemos?», el agente debe recuperar los registros de esa organización.

No debe recuperar registros de otra organización porque el modelo eligió otro filtro, malinterpretó una relación o generó una petición demasiado amplia.

Por qué importa a quien construye agentes

Los agentes de IA introducen un patrón de acceso distinto.

Una aplicación tradicional suele tener una interfaz definida. Alguien pulsa un botón, abre una página o envía un formulario. La aplicación decide qué datos cargar.

Un agente de IA recibe lenguaje natural, interpreta la intención y puede decidir qué información necesita para completar la tarea.

Esa flexibilidad es potente. También es la razón por la que el control de acceso pesa más.

No puedes confiar solo en el modelo para saber qué datos son apropiados. No puedes asumir que un prompt de sistema bien escrito impedirá siempre una petición demasiado amplia. Y no puedes tratar una consulta generada como sustituto de una decisión de autorización.

Una arquitectura sólida separa el trabajo:

ResponsabilidadQuién debe asumirla
Entender la intención del usuarioEl agente de IA
Decidir qué capacidad invocarEl agente de IA o la aplicación
Definir las capacidades disponiblesEl equipo de producto o de desarrollo
Imponer los límites de datosLa capa de recuperación
Registrar qué ocurrióLa capa de observabilidad
Devolver un resultado usableEl endpoint del agente

El modelo no debería ser el único componente que decide qué datos pueden salir de la base.

El problema de aislar solo con un prompt

Un enfoque habitual es incluir instrucciones como «recupera solo datos del inquilino actual».

Esa instrucción puede ayudar. No basta por sí sola.

Un prompt es una guía para un sistema probabilístico. Se puede malinterpretar, olvidar, anular por el contexto o combinar con otras instrucciones hasta producir un resultado no deseado.

Además, un prompt no establece un límite técnico.

Si la capacidad de recuperación puede llegar a todos los inquilinos, el agente tiene la capacidad técnica de recuperar datos fuera de su contexto. El prompt puede reducir la probabilidad de que ocurra. No elimina la capacidad.

Un límite multi-inquilino cambia la situación.

En vez de esperar a que el agente elija el inquilino correcto, la capa de recuperación restringe de antemano lo que puede recuperar.

Es la diferencia entre «por favor, no accedas a otros inquilinos» y «este agente no puede recuperar filas fuera del inquilino X».

Cómo funcionan los agentes de Claix

Un agente de Claix no es el agente de IA que tú construyes. La página de producto es agentes de Claix.

Tu agente de IA decide qué hacer. Un agente de Claix recupera datos para él, dentro de los límites que defines.

Cada agente de Claix tiene un nombre, que se convierte en su URL, una descripción, un prompt de negocio, rutas, un modo de respuesta y límites de llamadas opcionales. También puedes darle una configuración multi-inquilino.

Cuando tu aplicación envía una pregunta, Claix elige una ruta asignada a ese agente. Si ninguna encaja, no adivina. Después ejecuta una consulta de solo lectura usando solo las tablas y columnas de esa ruta.

La respuesta puede ser el dato en bruto o una respuesta razonada, según el modo que elijas.

La ruta define qué tablas y columnas están disponibles. La configuración multi-inquilino del agente define qué filas pueden devolver esas tablas.

ComponentePapel en la arquitectura
Data MapDescribe tablas, significados y relaciones
RutaDefine las tablas y columnas disponibles, y una guía para leerlas
AgenteDefine quién pregunta, qué rutas puede usar, qué filas puede recuperar y cómo responde
Modo de respuestaDetermina si recibes datos en bruto o una respuesta razonada
TrazasSirven para inspeccionar qué ocurrió

El Data Map da a Claix el significado de negocio de tu base: qué representa cada tabla y cómo se relacionan. Las rutas se apoyan en ese mapa. Los agentes usan rutas, y el límite de filas vive en el agente. El modelo de acceso se puede leer y revisar, en vez de quedar escondido en el código de la aplicación.

Cómo se escribe un límite de filas

Se guarda en el agente. Cada regla nombra las tablas que cubre y los valores que esas tablas pueden cumplir. Un valor suelto tiene que coincidir exactamente. Una lista admite cualquiera de esos valores. Varias condiciones sobre las mismas tablas se combinan con O: basta con que la fila cumpla una.

El mismo dato no tiene que llamarse igual. En este ejemplo, el cliente 42 es id en clientes y customer_id en pedidos y facturas. Esos pedidos también se pueden leer cuando team_id es 7 u 8. Una tabla que no aparece en ninguna regla no se puede consultar, y una fila que no cumple ninguna condición no se devuelve. Puedes crear hasta 20 reglas.

{
  "rules": [
    {
      "tables": ["customers"],
      "any_of": [{ "id": 42 }]
    },
    {
      "tables": ["orders", "invoices"],
      "any_of": [
        { "customer_id": 42 },
        { "team_id": [7, 8] }
      ]
    }
  ]
}

El recorrido completo, y cómo encaja esto con las rutas y los modos de respuesta, está en agentes de Claix.

Cómo se ve un agente multi-inquilino

Imagina un SaaS con una base compartida de clientes, pedidos y tickets de soporte.

Puedes crear tres agentes:

AgenteRutasLímite de filasPara qué sirve
Agente de soportePedidos, ticketsCliente actualResponder sobre una cuenta de cliente
Agente interno de operacionesPedidos, clientes, ticketsAlcance del equipo internoAyudar al equipo a investigar incidencias
Agente de consentimientoClientesUsuario actualDevolver un booleano de consentimiento a un workflow

El primero puede leer el estado del pedido, el envío y los tickets, pero solo del cliente al que atiende.

El segundo puede tener un acceso más amplio porque atiende a un equipo interno.

El tercero puede necesitar un solo campo de una sola tabla, y aun así necesita un límite de filas para comprobar solo el consentimiento del usuario que toca.

Ese es el valor práctico de la configuración multi-inquilino: dar a un agente el acceso justo para hacer su trabajo, sin darle todos los registros de la base.

La fuerza de un límite determinista

La palabra importante es determinista.

Una regla multi-inquilino no debería depender de que el modelo decida, después, si un resultado es aceptable.

Debe definirse antes de la recuperación y aplicarse siempre igual.

El límite forma parte de la configuración de recuperación, no es una sugerencia dentro del prompt.

EnfoqueQué decide el accesoRiesgo
Credenciales amplias de baseRol y permisos sobre objetosEl agente puede llegar a más filas de las previstas
Aislamiento solo con promptLa interpretación del modeloEl límite se malinterpreta o se salta en la práctica
Filtrado en la aplicaciónLa lógica de la aplicaciónEs fácil olvidarlo en un endpoint o un workflow nuevo
Reglas multi-inquilino en la recuperaciónUn límite configurado de forma explícitaEl agente solo recupera filas dentro de su alcance

El último enfoque es el que permite la configuración multi-inquilino de Claix.

Da a quien desarrolla una forma de expresar el límite de negocio dentro de la arquitectura del agente:

  • Este agente atiende a este inquilino.
  • Este agente puede usar estas rutas.
  • Esas rutas exponen estas tablas y columnas.
  • El agente solo puede recuperar filas de su contexto.

Es un modelo mucho más sólido que pedirle al modelo que tenga cuidado.

Por qué mejora la fiabilidad del agente

La configuración multi-inquilino no es solo una función de seguridad. También mejora la fiabilidad y la calidad de las respuestas.

Cuando un agente tiene acceso a demasiados datos, puede producir respuestas técnicamente plausibles y operativamente erróneas. Puede mezclar registros de distintos inquilinos. Puede recuperar historial que no toca. Puede devolver más información de la que el workflow necesita.

Un límite de filas más estrecho reduce esa ambigüedad.

Si un agente está configurado para un inquilino, no tiene que deducir qué datos usar. El límite ya está definido.

Eso tiene consecuencias prácticas:

  • Menos respuestas en el contexto equivocado
  • Menos riesgo de mezclar registros de distintos inquilinos
  • Un comportamiento más previsible entre peticiones
  • Pruebas más fáciles del comportamiento del agente
  • Depuración más clara cuando algo falla
  • Una separación más nítida entre capacidades y alcance de datos

La configuración multi-inquilino no solo evita un acceso indebido. Hace que los agentes sean más fáciles de operar.

Un mejor punto de partida para producción

Muchos equipos empiezan con una conexión amplia porque es rápido.

Conectas la base, das al agente acceso a unas tablas y empiezas a probar. Durante un prototipo, se entiende.

Producción pide otra actitud.

En producción, un agente no es una demo. Es un componente que puede recuperar datos reales de negocio, a veces de forma repetida, a veces de forma autónoma y a veces como respuesta a un usuario.

Ahí, un acceso amplio se convierte en un riesgo.

Un mejor punto de partida es:

  • Empezar con un rol de base de solo lectura
  • Publicar un Data Map revisado
  • Crear rutas para propósitos concretos
  • Asignar a cada agente solo las rutas que necesita
  • Definir límites de fila para el inquilino o el usuario
  • Usar respuestas tipadas cuando el resultado alimenta un workflow
  • Revisar las trazas para ver qué pidió y qué recibió

No hace falta montar un sistema de seguridad complejo antes de probar nada. El camino del prototipo a producción sí debería incluir un modelo de acceso claro.

Qué gana quien desarrolla

Para quien construye agentes de IA, la configuración multi-inquilino da una forma más clara de razonar el acceso.

En vez de preguntar «¿puede mi agente acceder a la base?», puedes preguntar:

  • ¿A qué inquilino, usuario o contexto de negocio atiende este agente?
  • ¿Qué tablas necesita?
  • ¿Qué columnas necesita?
  • ¿Qué filas debería poder recuperar?
  • ¿Qué debe pasar si ninguna ruta encaja?
  • ¿Qué recuperó el agente?

Son preguntas mucho más útiles.

Convierten la seguridad del agente en un conjunto de decisiones de diseño explícitas.

Cómo encaja en Claix

Claix está pensado para la recuperación controlada de bases de datos por agentes de IA. Los agentes de Claix son el endpoint al que llama tu aplicación.

El Data Map describe tu base. Las rutas definen qué datos se pueden usar para un propósito. Los agentes definen quién pregunta, qué rutas pueden usar, qué filas pueden recuperar y cómo se devuelven las respuestas.

La configuración multi-inquilino lleva ese modelo hasta la fila.

Puedes definir no solo qué puede leer un agente, sino también qué registros puede leer.

Para los equipos que construyen productos de IA, es un cambio de peso.

Ya no hay que elegir entre dar un acceso amplio y filtrar a mano cada resultado en el código. Puedes definir el límite una vez, guardarlo en el agente y dejar que el agente trabaje dentro de él.

Esa es la promesa de los agentes multi-inquilino en Claix: un endpoint, un trabajo, solo las filas que tú permites.

Preguntas frecuentes

¿Qué es la configuración multi-inquilino de un agente?
Es la forma de definir qué filas puede recuperar un agente de IA, además de qué tablas y columnas puede usar. Está pensada para productos en los que varios inquilinos, usuarios u organizaciones comparten la misma base. Se configura en el agente. La página de producto es agentes de Claix.
¿Por qué un agente de IA necesita límites por fila?
Porque los permisos de tabla y columna no establecen qué registros pertenecen al inquilino o al usuario actual. Sin un límite de filas, un agente puede recuperar datos de otro contexto aunque su rol de base sea de solo lectura.
¿Basta un prompt de sistema para aislar los datos de un inquilino?
No. Un prompt de sistema puede orientar el comportamiento, y no es un límite técnico de acceso. Las reglas multi-inquilino las tiene que imponer la capa de recuperación.
¿Pueden dos agentes usar la misma base y ver datos distintos?
Sí. Dos agentes pueden compartir la base e incluso las rutas, y devolver filas distintas. Cada agente elige sus rutas, que fijan tablas y columnas, y su propio límite de filas, que fija los registros.
¿La configuración multi-inquilino sustituye a los permisos de la base?
No. Los complementa. Sigue haciendo falta un rol de solo lectura con los privilegios justos. La configuración multi-inquilino añade, encima, un límite de recuperación de negocio.
¿Cuál es la diferencia entre una ruta y un agente?
Una ruta define qué datos se pueden usar para un propósito: las tablas, las columnas y una guía para leerlos. Un agente define quién pregunta, qué rutas puede usar, qué filas puede recuperar, cómo responde y con qué frecuencia se le puede llamar.
¿Dónde se configura el límite de filas?
En el agente, al crearlo o editarlo. Está separado del rol de la base y del prompt. Véase agentes de Claix.
¿El mismo cliente puede usar un nombre de columna distinto en cada tabla?
Sí. Una regla puede coincidir con id en clientes y otra con customer_id en pedidos. Un valor suelto tiene que coincidir exactamente. Una lista admite cualquiera de esos valores. Varias condiciones sobre las mismas tablas se combinan con O.
¿Qué pasa si una tabla no está incluida?
El agente no puede consultarla, aunque una ruta pudiera llegar a ella. Una fila que no cumple ninguna condición de su tabla no se devuelve.