Chat con agente | Plazbot Docs

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

01plazbot 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

01# Abrir un chat interactivo con el agente
02plazbot agent chat age_AbcDef123
03 
04# Continuar una conversación anterior
05plazbot agent chat age_AbcDef123 -s 3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f
06 
07# Permitir varias respuestas por turno
08plazbot 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

01  ┌──────────────────────────────────────────────────────────┐
02  │  Sales Plazbot [Tool Calling]                            │
03  │  Session: 3f2a9c1e...                                    │
04  │  /help to see commands                                   │
05  └──────────────────────────────────────────────────────────┘
06 
07  Sales Plazbot 10:30 AM
08  ¡Hola! ¿En qué te puedo ayudar?
09 
10  You > ¿Qué planes tienen?
11  ...thinking
12  Tool: list_plans
13 
14  Sales Plazbot 10:30 AM
15  Tenemos tres planes: Básico, Pro y Enterprise...
16 
17  Sources:
18    - Catálogo 2026
19      https://files.example.com/catalogo.pdf
20 
21  You > /exit
22 
23  Session ended.

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

El chat necesita una terminal interactiva. En scripts o CI usa plazbot 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`.