Casos de uso

Ejemplos de punta a punta. Las respuestas de Studio las genera un modelo de IA, así que el texto exacto varía; los pasos (✓ Agent loaded) y los mensajes fijos sí son los que verás.

1. Crear un agente desde cero

text

01 ● You
02   Create a sales agent for WhatsApp that knows my sneaker catalog and answers
03   questions about size, color and stock
04 
05 ● Plazbot
06   I generated the configuration for "Ventas Zapatillas":
07   • Tone: friendly, short answers
08   • Instructions for size, color and stock questions
09   • Channel: WhatsApp
10   Want me to save it?
11   ✓ Configuration generated

La configuración queda en la sesión. Pide ajustes en lenguaje natural y guárdala con /save:

text

01 ● You
02   Save this agent with its current configuration.
03 
04 ● Plazbot
05   Ventas Zapatillas was saved with id age_AbcDef123.
06   ✓ Agent saved

2. Cargar un agente y editarlo

text

01/load age_AbcDef123

text

01 ● Plazbot
02   Loaded Ventas WA (age_AbcDef123): ...
03   ✓ Agent loaded
04 
05 ● You
06   Make the greeting warmer and offer alternatives when something is out of stock
07 
08 ● Plazbot
09   Done. New greeting: "Hi! I'm Vale, how can I help you today?" ...
10   ✓ Configuration updated

Los cambios no se guardan hasta que ejecutas /save (o le pides a Studio que guarde).

3. Diagnosticar y corregir

text

01/load age_AbcDef123
02/diagnose

text

01 ● Plazbot
02   I found 2 points to review in Ventas WA:
03 
04   1. Critical - No timezone configured. Set the agent timezone.
05   2. Warning - The prompt has no fallback instructions.
06 
07   Want me to fix them?
08   ✓ Diagnosis complete
09 
10 ● You
11   Yes, fix both
12 
13 ● Plazbot
14   Done. I set the timezone and added fallback instructions.
15   ✓ Configuration updated

Revisa el resultado y guarda con /save.

4. Conectar WhatsApp

text

01 ● You
02   Connect this agent to WhatsApp Business
03 
04 ● Plazbot
05   Here is your connection link. Open it from the phone with WhatsApp.
06   ✓ WhatsApp connected
07 
08╭────────────────────────────────────────────────────────────────────────╮
09│ ● Connect your WhatsApp   · WhatsApp Business                          │
10│                                                                        │
11│ link: https://plzb.co/AbC123                                           │
12│ expires: Oct 6, 04:30 PM                                               │
13│                                                                        │
14│ Open the link from a phone with WhatsApp installed. We'll keep         │
15│ watching for the new number.                                           │
16│                                                                        │
17│ ⠋ Waiting for connection… (3/60)   · press Esc to cancel               │
18╰────────────────────────────────────────────────────────────────────────╯

✓ WhatsApp connected solo indica que se generó el link; la conexión real se confirma en la tarjeta. Studio revisa cada 5 segundos, hasta 5 minutos. Al detectar el número:

text

01│ ✓ WhatsApp connected                                                   │
02│ Number +51912345678 activated successfully.                            │

Y Studio continúa solo con la configuración del agente. Si pasan los 5 minutos verás No connection detected (pídele a Studio que lo intente de nuevo); con Esc, Connection cancelled. Instagram y Messenger funcionan igual, con su propia tarjeta (Connect your Instagram, Connect your Messenger).

5. Sesión larga con /compact

text

01/compact

Studio escribe un resumen (objetivo, decisiones, estado del agente y su id, pendientes) y, al terminar, ese resumen reemplaza todo el historial. Sigues conversando normalmente con menos contexto acumulado.

6. Exportar la configuración a un archivo

text

01/load age_AbcDef123
02/export

text

01 ● Plazbot
02   Agent configuration exported to /Users/ana/proyecto/ventas-wa.json.
03 
04   Validate it with: plazbot agent validate /Users/ana/proyecto/ventas-wa.json

Luego, desde tu shell:

bash

01plazbot agent validate ./ventas-wa.json

7. Diagnóstico nocturno en un script

bash

01#!/bin/bash
02# diagnose-nightly.sh: imprime los hallazgos de cada agente
03 
04for AGENT in $(plazbot agent list --json | jq -r '.[].id'); do
05  echo "==== $AGENT ===="
06  plazbot studio ask "Diagnose this agent" -a "$AGENT" --json \
07    | jq -r 'select(.type=="tool_result" and .tool_name=="diagnose_agent")
08             | .tool_result.data.issues[] | "\(.severity)\t\(.title)"'
09done

text

01==== age_AbcDef123 ====
02critical	Timezone no configurado
03warning	...

studio ask sale con código 1 si falla la petición o el stream trae un chunk error, y con 130 si lo cancelas con Ctrl+C. Ver Consulta única.

8. Crear un agente desde un brief en archivo

bash

01plazbot studio ask "$(cat brief-soporte.md)"

Donde brief-soporte.md describe lo que necesitas:

markdown

01Create a level 1 support agent for an invoicing SaaS:
02- Channel: webchat
03- Tone: professional and friendly
04- If it doesn't know the answer, it hands over to a human
05- Language: Spanish, fallback English

studio ask no mantiene historial: la configuración generada no queda guardada entre llamadas. Para crear y guardar en un solo paso, pídelo en el mismo mensaje (por ejemplo, termina el brief con "and save it"), o usa la sesión interactiva.