Buscar usuarios y sus sesiones

Principio — devuelve un enlace, no una transcripción. Estas herramientas devuelven quién son tus usuarios y cuánto chatean — nunca el texto de la conversación. Cada resultado incluye una console_url; entrégala al usuario para que abra y lea la transcripción en la consola, donde se renderiza correctamente.

Tres herramientas de solo lectura cubren "quién está usando mis agentes y cuánto":

1. El directorio de usuarios

list_end_users(sort="tokens24h")     # busiest first; sort="recent" for newest
list_end_users(q="alex")             # filter by name or external id

Cada usuario se devuelve con el método de inicio de sesión, correo electrónico (si lo hay), recuentos de espacio/sesión/documento, uso de tokens en las últimas 24 horas y una console_url. Caso de uso — "¿quién es mi usuario más activo esta semana?" → sort="tokens24h", y luego entrega la console_url del usuario principal.

2. Detalle de un usuario

get_end_user(uid="…")                # profile: name, contact email/phone, city, timezone, spaces

Solo campos del perfil — sin contenido de conversación. Incluye una console_url a su página de detalle.

3. Sus sesiones — metadatos y luego un enlace

list_user_sessions(uid="…")          # per session: agent, AI-summarised title, message_count, tokens, time

Los mensajes en sí no se devuelven — por diseño. Obtienes la estructura de la sesión (qué agente, cuánto duró, cuándo, un título generado por IA) más dos enlaces: console_url abre esa conversación exacta (la consola salta directamente a ella y muestra la transcripción — sin buscar en una larga lista), y user_console_url abre la página de detalle del usuario. Caso de uso — "¿este cliente ha hablado con nosotros antes, y de qué?" → lista sus sesiones, resume los títulos y entrega la console_url de la relevante para que accedan directamente a esa conversación.

Informa de vuelta. Comienza con la respuesta ("Alex tiene 3 sesiones, todas sobre refinanciamiento, la más reciente ayer"), y luego pega la console_url de la sesión relevante para que el usuario haga clic directamente en esa conversación exacta — o user_console_url para la persona completa.