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.

bash

01plazbot 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

bash

01plazbot agent monitor -a age_TZiOY...

text

01  ┌──────────────────────────────────────────────────────────────┐
02  │  Monitor  ● En vivo                                         │
03  │  Agente: Mi Asistente                                       │
04  │  Ctrl+C salir | /filter <tipo> | /clear | /help             │
05  └──────────────────────────────────────────────────────────────┘
06 
07  ● Conectado al monitor en tiempo real
08 
09  14:32:05  ● msg_in         Hola, necesito ayuda
10  14:32:05       | contacto: Juan Perez
11  14:32:06  ● model          gpt-4o
12  14:32:06  ● rag            Buscando en base de conocimiento...
13  14:32:07  ● msg_out        Hola Juan! En que puedo ayudarte?
14  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:

bash

01plazbot agent monitor -a age_TZiOY... -f msg_in,msg_out

O usar el comando interactivo durante la sesion:

text

01/filter error
02  ● Filtro agregado: error
03  Activos: error
04 
05/filter msg_in
06  ● Filtro agregado: msg_in
07  Activos: error, msg_in
08 
09/filter clear
10  Todos los filtros removidos (mostrando todos)

Modo JSON

Para integrar con otras herramientas o guardar logs:

bash

01plazbot agent monitor -a age_TZiOY... --json > logs.jsonl

Cada linea es un objeto JSON con la estructura completa del evento.

Usa Ctrl+C para detener el monitor y cerrar la conexion de forma limpia.