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

O usar el comando interactivo durante la sesion:

/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

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.

CLI Plazbot

Módulos

Monitor en Tiempo Real