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.
Por qué es seguro (antes de empezar)
Antes de tocar nada, entendé las garantías de diseño que hacen esto posible:
- El token es efímero. Viaja por la cola de mensajes en memoria y nunca se persiste en la base de datos. No queda en el historial, ni en la configuración, ni en los logs de administración.
- Está redactado de los logs y la auditoría. Lumentia lo enmascara igual que una API key: nunca aparece en claro en trazas ni en la interfaz de diagnóstico.
- Least-privilege. El asistente no tiene un "superacceso": llama a tu API con el token de ese usuario. Quien autoriza es tu backend, no el modelo. Si el usuario no puede ver un recurso, la API devuelve 403 y el asistente no puede inventarlo.
- Sin lector cross-tenant. No hay una credencial maestra que lea a todos. Cada respuesta queda naturalmente acotada al que pregunta.
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ómo | Embebé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 para | Widget 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. |
| Requiere | Que 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)
- Un solo alias y un solo flujo. No multiplicás configuraciones por usuario; la personalización la aporta el token, no el setup.
- Backend sin estado. Tu API valida el token y aplica permisos en cada request. Lumentia no guarda ni indexa el estado de permisos por usuario: tu backend sigue siendo la fuente de verdad.
- Resolución en O(1). El widget se resuelve por un índice dedicado de tokens, no escaneando la base. Subir de cientos a miles de usuarios no degrada la carga.
- Rate limits y debounce. La capa de chat ya agrupa mensajes y limita ráfagas por sesión, para que 200 usuarios concurrentes no disparen costos descontrolados.
Checklist de seguridad
- ☑ El token viaja efímero y redactado; nunca lo persistís ni lo logueás.
- ☑ Los tokens tienen expiración y scopes mínimos (solo los endpoints que el asistente debe tocar).
- ☑ Tu API es la que autoriza: el modelo nunca decide qué puede ver un usuario.
- ☑ No usás una credencial de servicio compartida; cada mensaje usa el token de su dueño.
- ☑ Revisás los endpoints expuestos: solo los de lectura / acciones permitidas, nunca operaciones destructivas sin confirmación.
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.