Skip to main content

​
1. Crear un agente de ventas desde cero

> 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

> /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

> /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

> /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.
La conexion WhatsApp usa polling interno. Si tardas en escanear, Studio espera hasta 90 segundos antes de timeout.

​
5. Sesion larga con compactacion

Despues de 30+ mensajes el contexto se hace pesado. Compacta: 
> /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: 
#!/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: 
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

plazbot studio ask "$(cat brief-bot-soporte.md)"
Donde brief-bot-soporte.md es: 
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

> /export
✓ Exportado a ./plazbot-studio-2026-06-13.md
Puedes compartir el archivo con un colega. Si lo abren en su propio Studio: 
plazbot studio ask "$(cat plazbot-studio-2026-06-13.md)\n\ncontinua desde aqui"
Continua la conversacion con todo el contexto del archivo.