> ## 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.

# Casos de uso

> Ejemplos reales end-to-end de tareas comunes en Studio

## 1. Crear un agente de ventas desde cero

```text theme={null}
> Crea un agente de ventas para WhatsApp que conozca mi catalogo de zapatillas
  y responda dudas de talla, color y stock. Si no hay stock, ofrece alternativas.

✓ Generando config · 1.2s
✓ Conectando catalogo (RAG) · 2.1s
✓ Creando agente · 0.6s

Listo. Cree "Ventas WA" con:
- Prompt enfocado en talla, color y stock
- Tool: search_catalog (conectado a tu catalogo activo)
- Tool: suggest_alternatives (fallback cuando no hay stock)
- Canal: WhatsApp
- Saludo: "¡Hola! Soy Vale, te ayudo con zapatillas 👟"

¿Quieres que conecte un numero WhatsApp ahora?
```

El panel JSON se puebla automaticamente con la config generada. Puedes revisar y ajustar antes de hacer `/save`.

***

## 2. Cargar un agente existente y editarlo

```text theme={null}
> /load age_TZiOY8xKn2...

✓ Cargado: Catalogo WA

> Cambia el saludo a algo mas cercano y agrega un fallback si no hay stock

✓ Actualizando prompt · 0.7s
✓ Agregando fallback · 0.4s

Listo. El nuevo saludo es "¡Hola! Soy Cata 👋" y si no hay stock
ofrezco alternativas de la misma categoria.

> /save

✓ Guardado. Version 15 publicada.
```

***

## 3. Diagnosticar un agente

```text theme={null}
> /load age_PROD123
✓ Cargado: Soporte L1

> /diagnose

✓ Diagnosticando · 1.8s

Encontre 4 issues:

[crit] Sin fallback para preguntas fuera de scope
[crit] Tool "create_ticket" sin descripcion (LLM no la usara bien)
[warn] Prompt mezcla tu/usted en 6 lugares
[info] Sin ejemplos few-shot

¿Quieres que arregle los criticos automaticamente?

> Si, arregla los dos criticos

✓ Agregando fallback · 0.8s
✓ Actualizando descripcion de tool · 0.4s

Listo. Te recomiendo /save para publicar.
```

***

## 4. Conectar WhatsApp a un agente

```text theme={null}
> /load age_VENTAS456
✓ Cargado: Ventas WA

> conectame un numero whatsapp a este agente

✓ Iniciando conexion WhatsApp · 0.5s

Escanea este QR con tu WhatsApp Business:

[QR card en el chat]

Esperando escaneo... ▍

✓ Conectado · numero +51 999 888 777

Listo. Tu agente Ventas WA ya recibe mensajes.
```

<Tip>
  La conexion WhatsApp usa polling interno. Si tardas en escanear, Studio espera hasta 90 segundos antes de timeout.
</Tip>

***

## 5. Sesion larga con compactacion

Despues de 30+ mensajes el contexto se hace pesado. Compacta:

```text theme={null}
> /compact

✓ Compactando · 1.1s

Resumen guardado de 32 mensajes:
- Creaste agente "Reservas"
- Configuraste 6 herramientas (search_availability, book_slot, ...)
- Probaste 4 escenarios de booking
- Pendiente: conectar canal Telegram

Tokens liberados: ~12k. Sigue conversando normalmente.
```

El siguiente mensaje arranca con el resumen como contexto, no con los 32 mensajes individuales.

***

## 6. One-shot en un script

Validar todos los agentes en un cron job nocturno:

```bash theme={null}
#!/bin/bash
# diagnose-nightly.sh

set -e

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

Envia un mail si hay issues criticos:

```bash theme={null}
plazbot studio ask "lista agentes con issues criticos" --json \
  | jq -r 'select(.type=="text") | .content' \
  | mail -s "Plazbot diagnose nightly" team@acme.com
```

***

## 7. Crear desde un brief en archivo

```bash theme={null}
plazbot studio ask "$(cat brief-bot-soporte.md)"
```

Donde `brief-bot-soporte.md` es:

```markdown theme={null}
Necesito un agente de soporte L1 para SaaS de facturacion:
- Canal: webchat
- Tono: profesional, cercano
- Fuentes: knowledge base en /docs
- Si no sabe: crear ticket en TickOS
- Idioma: ES, fallback EN
```

Studio interpreta el markdown como un solo mensaje y genera el agente completo.

***

## 8. Export y handoff entre humanos

```text theme={null}
> /export
✓ Exportado a ./plazbot-studio-2026-06-13.md
```

Puedes compartir el archivo con un colega. Si lo abren en su propio Studio:

```bash theme={null}
plazbot studio ask "$(cat plazbot-studio-2026-06-13.md)\n\ncontinua desde aqui"
```

Continua la conversacion con todo el contexto del archivo.