Sesión interactiva

plazbot studio abre un chat en la terminal donde conversas con Studio en varios turnos. Cada respuesta llega en streaming y, cuando Studio usa una herramienta (listar, cargar, diagnosticar o guardar agentes), verás el paso con su estado.

bash

01plazbot studio [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Agente	`-a, --agent-id <id>`	No	Deja un agente como contexto desde el inicio (aparece en el encabezado como `agent`)
Mensaje	`-m, --message <text>`	No	Alias de `studio ask`: ejecuta una sola consulta y sale, sin abrir el chat
JSON	`--json`	No	Solo junto con `-m`: imprime los chunks como NDJSON (un objeto JSON por línea)

Ejemplos

bash

01# Abrir Studio
02plazbot studio
03 
04# Abrir Studio con un agente como contexto
05plazbot studio -a age_AbcDef123
06 
07# Una sola consulta y salir (igual que `studio ask`)
08plazbot studio -m "Diagnose this agent" -a age_AbcDef123

-a solo fija el id del agente como contexto. Para traer su configuración a la sesión (y poder usar /save o /export), cárgalo con /load age_AbcDef123 o pídele a Studio que lo cargue.

Resultado

Pantalla al iniciar con -a:

text

01 ● Plazbot Studio v0.6.0                workspace wok_AbcDef123  zone LA  agent age_AbcDef12
02 
03  Try one of these to get started:
04 
05    ▸ List my agents  /agents
06    ▸ Load an agent  /load <id>
07    ▸ Diagnose the current agent  /diagnose
08    ▸ Create a new agent  Create a sales agent for WhatsApp
09 
10╭──────────────────────────────────────────────────────────────────────────────╮
11│ › Type a message or /help                                                    │
12╰──────────────────────────────────────────────────────────────────────────────╯
13 tokens: 0 in / 0 out    /help · ↑↓ history · Tab/→ accept suggestion · Esc cancel · Ctrl+C exit

Después de una consulta:

text

01 ● You
02   List my agents
03 
04 ● Plazbot
05   You have 3 agents in this workspace:
06 
07   • Ventas WA (age_AbcDef123) - active, WhatsApp
08   • Soporte L1 (age_GhiJkl456) - active, Webchat
09   • Reservas (age_MnoPqr789) - inactive
10   ✓ Agents listed
11 
12╭──────────────────────────────────────────────────────────────────────────────╮
13│ › Type a message or /help                                                    │
14╰──────────────────────────────────────────────────────────────────────────────╯
15 tokens: 3.4k in / 156 out    /help · ↑↓ history · Tab/→ accept suggestion · Esc cancel · Ctrl+C exit

Pantalla

Zona	Qué muestra
Encabezado	`● Plazbot Studio`, versión, `workspace`, `zone` (LA o EU) y, si hay uno, `agent` (primeros 12 caracteres del id)
Conversación	Tus mensajes (`● You`), las respuestas (`● Plazbot`, con markdown) y los pasos de cada herramienta. Al inicio, en lugar de la conversación, aparecen las sugerencias
Cuadro de texto	`› Type a message or /help`. Mientras llega una respuesta se bloquea y muestra `Waiting for response… (press Esc to cancel)`
Pie	Tokens acumulados de la sesión (`tokens: 3.4k in / 156 out`), `streaming…` mientras llega la respuesta y los atajos disponibles

La conversación se escribe en el scrollback normal de la terminal, así que puedes subir para revisar mensajes anteriores.

Flujo de una respuesta

Escribes un mensaje (o un slash command) y presionas Enter.
Aparece ● Plazbot con un spinner y una frase rotativa (Thinking…, Reasoning…) hasta que llega el primer texto.
El texto se escribe en tiempo real con un cursor al final.
Cada herramienta que usa Studio aparece como un paso: spinner mientras corre y luego ✓ (éxito), ✗ en rojo (error) o ○ (no encontrado, que Studio explica en el texto).
Al terminar, el pie actualiza el contador de tokens y el cuadro de texto vuelve a estar disponible.

Pasos que puedes ver:

Herramienta	En curso	Al terminar
`list_agents`	`Listing agents…`	`✓ Agents listed`
`load_agent`	`Loading agent…`	`✓ Agent loaded`
`diagnose_agent`	`Diagnosing agent…`	`✓ Diagnosis complete`
`create_agent_config`	`Generating agent configuration…`	`✓ Configuration generated`
`update_agent_config`	`Updating agent configuration…`	`✓ Configuration updated`
`save_agent`	`Saving agent…`	`✓ Agent saved`
`delete_agent`	`Deleting agent…`	`✓ Agent deleted`
`connect_whatsapp`	`Connecting WhatsApp…`	`✓ WhatsApp connected`
otras	`Running <tool>…`	`✓ Ran <tool>`

Cuando una herramienta devuelve la configuración de un agente (al crearlo, cargarlo, editarlo o diagnosticarlo), Studio la guarda en la sesión y la envía como contexto en los siguientes mensajes. Esa es la configuración que guardan /save y /export.

Conectar un canal

Si le pides a Studio conectar WhatsApp, Instagram o Messenger, aparece una tarjeta con el link de conexión (link:), su vencimiento (expires:) y el estado. Studio revisa cada 5 segundos durante 5 minutos si la conexión quedó activa; al detectarla muestra el número, cuenta o página conectada y sigue con la configuración del agente. Presiona Esc para cancelar la espera. Ver el caso de uso.

Salir

Ctrl+C sale de inmediato (si hay una respuesta en curso, la cancela). También puedes escribir /quit, /exit o /q. Ver atajos de teclado.

Errores comunes

Mensaje	Causa	Solución
`The Studio REPL needs an interactive terminal.`	Ejecutaste `plazbot studio` sin TTY (CI, pipe, redirección)	Usa `plazbot studio ask "..."`
`--json only works with a one-shot prompt.`	Usaste `--json` sin `-m`	`plazbot studio ask "List my agents" --json`
`You are not signed in.`	No hay sesión ni variables de entorno	`plazbot login`, o define `PLAZBOT_API_KEY` y `PLAZBOT_WORKSPACE_ID`

Errores dentro de la conversación (401, 403, 429, red): ver Errores comunes.