> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitor en Tiempo Real

> Visualiza los eventos de un agente en tiempo real desde la terminal

### 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 theme={null}
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

```bash theme={null}
plazbot agent monitor -a age_TZiOY...
```

```text theme={null}
  ┌──────────────────────────────────────────────────────────────┐
  │  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`:

```bash theme={null}
plazbot agent monitor -a age_TZiOY... -f msg_in,msg_out
```

O usar el comando interactivo durante la sesion:

```text theme={null}
/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:

```bash theme={null}
plazbot agent monitor -a age_TZiOY... --json > logs.jsonl
```

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

<Tip>
  Usa `Ctrl+C` para detener el monitor y cerrar la conexion de forma limpia.
</Tip>