# Casos de uso

> Ejemplos completos de tareas comunes con Plazbot Studio

Fuente: https://developers.plazbot.com/cli/studio/casos-de-uso/

### 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
● You
 Create a sales agent for WhatsApp that knows my sneaker catalog and answers
 questions about size, color and stock

● Plazbot
 I generated the configuration for "Ventas Zapatillas":
 • Tone: friendly, short answers
 • Instructions for size, color and stock questions
 • Channel: WhatsApp
 Want me to save it?
 ✓ Configuration generated
```

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

```text
● You
 Save this agent with its current configuration.

● Plazbot
 Ventas Zapatillas was saved with id age_AbcDef123.
 ✓ Agent saved
```

## 2. Cargar un agente y editarlo

```text
/load age_AbcDef123
```

```text
● Plazbot
 Loaded Ventas WA (age_AbcDef123): ...
 ✓ Agent loaded

● You
 Make the greeting warmer and offer alternatives when something is out of stock

● Plazbot
 Done. New greeting: "Hi! I'm Vale, how can I help you today?" ...
 ✓ Configuration updated
```

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

## 3. Diagnosticar y corregir

```text
/load age_AbcDef123
/diagnose
```

```text
● Plazbot
 I found 2 points to review in Ventas WA:

 1. Critical - No timezone configured. Set the agent timezone.
 2. Warning - The prompt has no fallback instructions.

 Want me to fix them?
 ✓ Diagnosis complete

● You
 Yes, fix both

● Plazbot
 Done. I set the timezone and added fallback instructions.
 ✓ Configuration updated
```

Revisa el resultado y guarda con `/save`.

## 4. Conectar WhatsApp

```text
● You
 Connect this agent to WhatsApp Business

● Plazbot
 Here is your connection link. Open it from the phone with WhatsApp.
 ✓ WhatsApp connected

╭────────────────────────────────────────────────────────────────────────╮
│ ● Connect your WhatsApp   · WhatsApp Business                          │
│                                                                        │
│ link: https://plzb.co/AbC123                                           │
│ expires: Oct 6, 04:30 PM                                               │
│                                                                        │
│ Open the link from a phone with WhatsApp installed. We'll keep         │
│ watching for the new number.                                           │
│                                                                        │
│ ⠋ Waiting for connection… (3/60)   · press Esc to cancel               │
╰────────────────────────────────────────────────────────────────────────╯
```

`✓ 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
│ ✓ WhatsApp connected                                                   │
│ 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
/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
/load age_AbcDef123
/export
```

```text
● Plazbot
 Agent configuration exported to /Users/ana/proyecto/ventas-wa.json.

 Validate it with: plazbot agent validate /Users/ana/proyecto/ventas-wa.json
```

Luego, desde tu shell:

```bash
plazbot agent validate ./ventas-wa.json
```

## 7. Diagnóstico nocturno en un script

```bash
#!/bin/bash
# diagnose-nightly.sh: imprime los hallazgos de cada agente

for AGENT in $(plazbot agent list --json | jq -r '.[].id'); do
echo "==== $AGENT ===="
plazbot studio ask "Diagnose this agent" -a "$AGENT" --json \
  | jq -r 'select(.type=="tool_result" and .tool_name=="diagnose_agent")
           | .tool_result.data.issues[] | "\(.severity)\t\(.title)"'
done
```

```text
==== age_AbcDef123 ====
critical	Timezone no configurado
warning	...
```

> **Nota:** `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](https://developers.plazbot.com/cli/studio/ask).

## 8. Crear un agente desde un brief en archivo

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

Donde `brief-soporte.md` describe lo que necesitas:

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

> **Importante:** `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](https://developers.plazbot.com/cli/studio/repl).