Casos de uso | Plazbot Docs

1. Crear un agente de ventas desde cero

text

01> Crea un agente de ventas para WhatsApp que conozca mi catalogo de zapatillas
02  y responda dudas de talla, color y stock. Si no hay stock, ofrece alternativas.
03 
04 Generando config · 1.2s
05 Conectando catalogo (RAG) · 2.1s
06 Creando agente · 0.6s
07 
08Listo. Cree "Ventas WA" con:
09- Prompt enfocado en talla, color y stock
10- Tool: search_catalog (conectado a tu catalogo activo)
11- Tool: suggest_alternatives (fallback cuando no hay stock)
12- Canal: WhatsApp
13- Saludo: "¡Hola! Soy Vale, te ayudo con zapatillas "
14 
15¿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

01> /load age_TZiOY8xKn2...
02 
03 Cargado: Catalogo WA
04 
05> Cambia el saludo a algo mas cercano y agrega un fallback si no hay stock
06 
07 Actualizando prompt · 0.7s
08 Agregando fallback · 0.4s
09 
10Listo. El nuevo saludo es "¡Hola! Soy Cata " y si no hay stock
11ofrezco alternativas de la misma categoria.
12 
13> /save
14 
15 Guardado. Version 15 publicada.

3. Diagnosticar un agente

text

01> /load age_PROD123
02 Cargado: Soporte L1
03 
04> /diagnose
05 
06 Diagnosticando · 1.8s
07 
08Encontre 4 issues:
09 
10[crit] Sin fallback para preguntas fuera de scope
11[crit] Tool "create_ticket" sin descripcion (LLM no la usara bien)
12[warn] Prompt mezcla tu/usted en 6 lugares
13[info] Sin ejemplos few-shot
14 
15¿Quieres que arregle los criticos automaticamente?
16 
17> Si, arregla los dos criticos
18 
19 Agregando fallback · 0.8s
20 Actualizando descripcion de tool · 0.4s
21 
22Listo. Te recomiendo /save para publicar.

4. Conectar WhatsApp a un agente

text

01> /load age_VENTAS456
02 Cargado: Ventas WA
03 
04> conectame un numero whatsapp a este agente
05 
06 Iniciando conexion WhatsApp · 0.5s
07 
08Escanea este QR con tu WhatsApp Business:
09 
10[QR card en el chat]
11 
12Esperando escaneo... ▍
13 
14 Conectado · numero +51 999 888 777
15 
16Listo. 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:

text

01> /compact
02 
03 Compactando · 1.1s
04 
05Resumen guardado de 32 mensajes:
06- Creaste agente "Reservas"
07- Configuraste 6 herramientas (search_availability, book_slot, ...)
08- Probaste 4 escenarios de booking
09- Pendiente: conectar canal Telegram
10 
11Tokens 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

01#!/bin/bash
02# diagnose-nightly.sh
03 
04set -e
05 
06for AGENT in $(plazbot agent list --json | jq -r '.[].id'); do
07  echo "==== $AGENT ===="
08  plazbot studio ask "diagnostica este agente" -a "$AGENT" --json \
09    | jq 'select(.type=="tool_result" and .tool_name=="diagnose_agent") | .data'
10done

Envia un mail si hay issues criticos:

bash

01plazbot studio ask "lista agentes con issues criticos" --json \
02  | jq -r 'select(.type=="text") | .content' \
03  | mail -s "Plazbot diagnose nightly" team@acme.com

7. Crear desde un brief en archivo

bash

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

Donde brief-bot-soporte.md es:

markdown

01Necesito un agente de soporte L1 para SaaS de facturacion:
02- Canal: webchat
03- Tono: profesional, cercano
04- Fuentes: knowledge base en /docs
05- Si no sabe: crear ticket en TickOS
06- Idioma: ES, fallback EN

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

8. Export y handoff entre humanos

text

01> /export
02 Exportado a ./plazbot-studio-2026-06-13.md

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

bash

01plazbot studio ask "$(cat plazbot-studio-2026-06-13.md)\n\ncontinua desde aqui"

Continua la conversacion con todo el contexto del archivo.