# Chat con agente

> Abre una conversación interactiva con un agente en la terminal.

Fuente: https://developers.plazbot.com/cli/agent/chat/

### Chat con un agente

Abre una sesión de chat interactiva con un agente para probarlo desde la terminal. Muestra el saludo del agente, sus respuestas con formato básico de markdown, las herramientas que ejecutó y las fuentes que usó.

```bash
plazbot agent chat <agentId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| `agentId` | (posicional) | Sí | ID del agente. |
| Sesión | `-s, --session-id <id>` | No | Reutiliza un ID de sesión para continuar una conversación. Por defecto: un ID aleatorio nuevo. |
| Varias respuestas | `-m, --multiple-answers` | No | Permite que el agente envíe varias respuestas por turno. Por defecto: `false`. |

### Ejemplos

```bash
# Abrir un chat interactivo con el agente
plazbot agent chat age_AbcDef123

# Continuar una conversación anterior
plazbot agent chat age_AbcDef123 -s 3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f

# Permitir varias respuestas por turno
plazbot agent chat age_AbcDef123 -m
```

### Comandos dentro del chat

| Comando | Descripción |
|---------|-------------|
| `/exit` | Termina la conversación. |
| `/clear` | Limpia la pantalla. |
| `/info` | Muestra la información de la sesión (agente, sesión, Tool Calling, proveedor de IA). |
| `/sources` | Muestra u oculta las fuentes de las respuestas. |
| `/help` | Muestra los comandos disponibles. |

### Resultado

```text
┌──────────────────────────────────────────────────────────┐
│  Sales Plazbot [Tool Calling]                            │
│  Session: 3f2a9c1e...                                    │
│  /help to see commands                                   │
└──────────────────────────────────────────────────────────┘

Sales Plazbot 10:30 AM
¡Hola! ¿En qué te puedo ayudar?

You > ¿Qué planes tienen?
...thinking
Tool: list_plans

Sales Plazbot 10:30 AM
Tenemos tres planes: Básico, Pro y Enterprise...

Sources:
  - Catálogo 2026
    https://files.example.com/catalogo.pdf

You > /exit

Session ended.
```

Si un mensaje falla, el error se muestra y la sesión sigue abierta.

> **Nota:** El chat necesita una terminal interactiva. En scripts o CI usa [`plazbot agent message`](https://developers.plazbot.com/cli/agent/message): `plazbot agent message age_AbcDef123 -q "Hola" --json`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `The interactive chat needs an interactive terminal.` | Se ejecutó sin terminal (CI, pipes). | Usa `plazbot agent message <agentId> -q "..." --json`. |
| `Agent "age_AbcDef123" was not found in workspace wok_AbcDef123 (zone LA).` | El ID no existe en el workspace o zona activa. | Revisa con `plazbot whoami` y `plazbot agent list`. |
| `You are not signed in.` | No hay sesión activa. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |