Monitor en tiempo real
Conecta a un agente via SignalR y muestra los eventos en tiempo real directamente en la terminal, con colores por tipo de evento.
plazbot agent monitor -a <agentId>
Opciones
| Opcion | Descripcion |
|---|
-a, --agent-id <id> | (Requerido) ID del agente a monitorear |
-f, --filter <tipos> | Filtrar por tipos separados por coma |
--no-session | Ocultar el ID de sesion |
--json | Modo JSON crudo (ideal para piping) |
--dev | Usar ambiente de desarrollo |
Ejemplo
plazbot agent monitor -a age_TZiOY...
┌──────────────────────────────────────────────────────────────┐
│ Monitor ● En vivo │
│ Agente: Mi Asistente │
│ Ctrl+C salir | /filter <tipo> | /clear | /help │
└──────────────────────────────────────────────────────────────┘
● Conectado al monitor en tiempo real
14:32:05 ● msg_in Hola, necesito ayuda
14:32:05 | contacto: Juan Perez
14:32:06 ● model gpt-4o
14:32:06 ● rag Buscando en base de conocimiento...
14:32:07 ● msg_out Hola Juan! En que puedo ayudarte?
14:32:07 ● tokens 150 tokens
Tipos de evento
Los eventos se muestran con colores diferenciados segun su tipo:
| Tipo | Color | Descripcion |
|---|
msg_in | Cyan | Mensaje entrante del contacto |
msg_out | Verde | Respuesta del agente |
tool_call | Morado | Ejecucion de herramienta |
api_req | Amarillo | Peticion a API externa |
api_res | Amarillo | Respuesta de API externa |
action | Naranja | Accion ejecutada |
rag | Azul | Consulta a base de conocimiento |
tokens | Gris | Conteo de tokens |
error | Rojo | Error en el procesamiento |
model | Morado claro | Modelo de IA utilizado |
intent | Morado claro | Intent detectado |
bot_off | Naranja | Bot desactivado |
Comandos interactivos
Mientras el monitor esta activo puedes escribir comandos directamente:
| Comando | Descripcion |
|---|
/filter <tipo> | Activar/desactivar filtro por tipo de evento |
/filter clear | Quitar todos los filtros |
/filters | Mostrar filtros activos |
/clear | Limpiar pantalla |
/json | Alternar modo JSON expandido |
/help | Mostrar comandos disponibles |
Filtrar eventos
Puedes filtrar desde el inicio con la opcion -f:
plazbot agent monitor -a age_TZiOY... -f msg_in,msg_out
/filter error
● Filtro agregado: error
Activos: error
/filter msg_in
● Filtro agregado: msg_in
Activos: error, msg_in
/filter clear
Todos los filtros removidos (mostrando todos)
Modo JSON
Para integrar con otras herramientas o guardar logs:
plazbot agent monitor -a age_TZiOY... --json > logs.jsonl
Usa Ctrl+C para detener el monitor y cerrar la conexion de forma limpia.
