← Volver al blog
Agentes · Seguridad

Un asistente para cada usuario, sin exponer lo de los demás

9 min de lectura · Agentes

Imaginá que tu plataforma tiene 200 usuarios y querés que cada uno tenga su propio asistente. Uno que responda sobre sus pedidos, su estado de cuenta, sus permisos. La tentación es crear 200 asistentes distintos —o peor, darle a un solo asistente acceso a todo—. Ninguna de las dos es la respuesta.

La respuesta es un solo asistente que se adapta a cada usuario: compartís el flujo y el conocimiento, pero cada mensaje viaja con el token de quien está hablando. El asistente actúa como ese usuario, ni más ni menos. En este post te mostramos cómo hacerlo, de forma segura y escalable.

La idea en una frase

Un alias (el asistente) + un Agent Worker (el flujo con herramientas) compartidos por todos. Lo único que cambia entre usuarios es el token de sesión que llega con cada mensaje. Tus herramientas lo usan para llamar a tu API, y tu API decide qué puede ver ese usuario. El asistente hereda esos límites automáticamente.

# Lo que cambia entre usuarios: solo su token Mismo alias → mismo flujo → mismas herramientas Distinto {{user_token}} → la respuesta se acota a lo que ese usuario puede ver

Por qué es seguro (antes de empezar)

Antes de tocar nada, entendé las garantías de diseño que hacen esto posible:

Regla de oro: la IA no decide los permisos. Tu API los decide. El asistente solo ejecuta con el token del usuario y tu backend hace de portero. Eso convierte a Lumentia en un cliente más de tu propia API, con las mismas restricciones que cualquier otro.

Paso a paso

Paso 1 — Herramientas que hablan con tu API

En Agent Workers → Herramientas creá herramientas de tipo rest_api que apunten a tu backend. La clave está en la cabecera Authorization: usá la variable {{user_token}} para que el motor la reemplace por el token del usuario que está hablando.

{
  "type": "rest_api",
  "name": "mis-pedidos",
  "description": "Pedidos del usuario autenticado",
  "config": {
    "base_url": "https://api.miempresa.com/v1/pedidos",
    "method": "GET",
    "headers": {
      "Authorization": "{{user_token}}",
      "Accept": "application/json"
    }
  }
}

Creá una herramienta por recurso (pedidos, estado de cuenta, facturas, tickets). Todas comparten el mismo patrón: Authorization: {{user_token}}. Si necesitás la identidad además del token, también tenés {{user_id}}.

Paso 2 — El Agent Worker que las orquesta

Creá un Agent Worker con un paso de tipo agent_loop: el loop recibe la pregunta, decide qué herramienta usar y ejecuta. En tool_ids listá las herramientas del paso 1.

{
  "type": "agent_loop",
  "config": {
    "query": "{{query}}",
    "tool_ids": ["mis-pedidos", "estado-cuenta", "facturas"],
    "max_iterations": 6
  }
}

Dentro del flujo, el token queda disponible además como {{_user_token}} para cualquier paso personalizado, y se propaga automáticamente a las herramientas que invoca el loop.

Paso 3 — El alias y el widget

Creá el alias (Configuración → Aliases), ponelo en modo agente, conectalo al flujo del paso 2 y activá el widget público. Ese alias es único para los 200 usuarios: lo que personaliza la experiencia no es el alias, sino el token que llega con cada mensaje.

Paso 4 — Inyectar el token del usuario (dos vías)

Acá está el único punto de integración real. Tu token tiene que llegar al mensaje. Tenés dos caminos, y podés elegir el que mejor encaje con tu arquitectura:

Vía A · Widget (same-origin)Vía B · API (server-to-server)
CómoEmbebés el widget en tu dominio y guardás la sesión del usuario en una cookie Authorization. El navegador la envía en el handshake del WebSocket.Tu backend (que ya conoce la sesión) llama al chat de Lumentia pasando user_token en el payload.
Ideal paraWidget embebido en tu app web, con el usuario ya logueado en tu dominio.Integraciones cross-origin, apps móviles, o cuando no querés depender de cookies.
RequiereQue tu dominio comparta la cookie con el widget (same-origin).Una llamada extra desde tu backend; vos controlás el flujo.

En ambos casos, lo único que viaja es un token de sesión de corto alcance y acotado a tu API. Nunca una credencial de servicio compartida.

# Vía B: tu backend inyecta el token del usuario en el payload del chat
{
  "client_id": "mi-empresa",
  "thread_id": "…",
  "message_id": "…",
  "content": "¿Dónde está mi pedido #8892?",
  "user_token": "Bearer ",
  "user_id": "u-123"
}

Paso 5 — Probar con 2 usuarios y escalar

Probá con dos usuarios que tengan permisos distintos (uno admin, uno básico) y verificá que cada uno recibe respuestas distintas ante la misma pregunta: el que no puede ver facturas, no las ve. Después, escalar es simplemente sumar usuarios: no hay configuración extra por usuario.

Cómo escala a 200 (y a 20.000)

Checklist de seguridad

Evitá: persistir el token en la configuración del alias o en el historial, usar un token maquinón compartido entre todos, o confiar en que el prompt "limite" al asistente. Los límites se imponen en la API, no en las instrucciones.

Conclusión

Personalizar Lumentia para cada usuario no significa duplicar asistentes ni abrir un acceso global. Es un asistente, un flujo y un token por usuario, con tu API como portero. Es el mismo principio least-privilege que ya usamos internamente para nuestro propio soporte: el agente accede exactamente a lo que ese usuario puede ver.

¿Querés verlo andando? Mirá cómo armar un Agent Worker o qué herramientas podés conectar, y empezá por el paso 1 con una sola herramienta.