# Plazbot Studio

> Asistente conversacional en la terminal para crear, diagnosticar y gestionar agentes de IA

Fuente: https://developers.plazbot.com/cli/studio/introduccion/

### Plazbot Studio

Plazbot Studio es un asistente conversacional dentro del CLI: le pides en lenguaje natural lo que necesitas ("lista mis agentes", "crea un agente de ventas para WhatsApp") y Studio lo resuelve con herramientas internas, mostrando cada paso en tiempo real. Es la misma experiencia del Agent Studio del producto web, pero en tu terminal.

```bash
plazbot studio [options]
plazbot studio ask <message> [options]
```

### Para qué sirve

- **Crear agentes** describiendo lo que necesitas, sin formularios.
- **Cargar y editar** la configuración de un agente existente con una frase.
- **Diagnosticar** un agente y recibir un reporte de puntos a revisar.
- **Guardar** los cambios en tu workspace y **exportar** la configuración a un archivo JSON.
- **Conectar WhatsApp, Instagram o Messenger** sin salir de la terminal.
- **Compactar** la conversación en sesiones largas.

### Dos modos de uso

- [Sesión interactiva](https://developers.plazbot.com/cli/studio/repl): `plazbot studio` abre un chat en la terminal con historial y slash commands.
- [Consulta única](https://developers.plazbot.com/cli/studio/ask): `plazbot studio ask "..."` ejecuta una consulta y sale. Ideal para scripts (soporta NDJSON).

### Inicio rápido

```bash
# 1. Inicia sesión (una sola vez)
plazbot login

# 2. Abre Studio
plazbot studio

# 3. Escribe en el cuadro de texto, por ejemplo:
#    Create a sales agent for WhatsApp
```

Al abrir Studio verás algo así:

```text
● Plazbot Studio v0.6.0                          workspace wok_AbcDef123  zone LA

Try one of these to get started:

  ▸ List my agents  /agents
  ▸ Load an agent  /load <id>
  ▸ Diagnose the current agent  /diagnose
  ▸ Create a new agent  Create a sales agent for WhatsApp

╭──────────────────────────────────────────────────────────────────────────────╮
│ › Type a message or /help                                                    │
╰──────────────────────────────────────────────────────────────────────────────╯
tokens: 0 in / 0 out    /help · ↑↓ history · Tab/→ accept suggestion · Esc cancel · Ctrl+C exit
```

> **Tip:** Puedes escribirle a Studio en español o en inglés. Las sugerencias y los textos fijos de la interfaz están en inglés.

### Índice de Studio

- [Sesión interactiva](https://developers.plazbot.com/cli/studio/repl): Opciones, pantalla y flujo de una respuesta.
- [Consulta única](https://developers.plazbot.com/cli/studio/ask): `studio ask`, salida NDJSON y códigos de salida.
- [Slash commands](https://developers.plazbot.com/cli/studio/slash-commands): Todos los comandos `/...` con sus alias.
- [Atajos de teclado](https://developers.plazbot.com/cli/studio/atajos): Enter, historial, sugerencias, Esc y Ctrl+C.
- [Casos de uso](https://developers.plazbot.com/cli/studio/casos-de-uso): Crear, editar, diagnosticar, conectar canales y scripts.
- [Errores comunes](https://developers.plazbot.com/cli/studio/errores): Sesión, permisos, límites, red y cómo resolverlos.

### Requisitos

- **Node.js** >= 18.17.0
- Una sesión activa con [`plazbot login`](https://developers.plazbot.com/cli/login), o las variables de entorno `PLAZBOT_API_KEY` y `PLAZBOT_WORKSPACE_ID` (opcionales: `PLAZBOT_ZONE`, `LA` por defecto, y `PLAZBOT_USER_ID`).
- Para la sesión interactiva, una terminal interactiva (TTY). Sin terminal, usa [`plazbot studio ask`](https://developers.plazbot.com/cli/studio/ask).