Enviar mensaje | Plazbot Docs

Enviar un mensaje

Envía un solo mensaje a un agente e imprime la respuesta. Es la alternativa no interactiva a chat, pensada para scripts, pruebas automatizadas y CI.

bash

01plazbot agent message <agentId> -q "<text>" [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
`agentId`	(posicional)	Sí	ID del agente.
Pregunta	`-q, --question <text>`	Sí	Mensaje o pregunta para el agente. No puede estar vacío.
Sesión	`-s, --session-id <id>`	No	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`.
JSON	`--json`	No	Imprime la respuesta como JSON (`{"answer","sessionId","sources"}`). Por defecto: `false`.

Ejemplos

bash

01# Enviar una pregunta
02plazbot agent message age_AbcDef123 -q "¿Qué planes ofrecen?"
03 
04# Continuar una sesión existente
05plazbot agent message age_AbcDef123 -q "¿Y el precio?" -s 3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f
06 
07# Obtener solo el texto de la respuesta (scripts)
08plazbot agent message age_AbcDef123 -q "Hola" --json | jq -r '.answer'
09 
10# Guardar la sesión y reutilizarla en el siguiente mensaje
11SESSION=$(plazbot agent message age_AbcDef123 -q "Hola" --json | jq -r '.sessionId')
12plazbot agent message age_AbcDef123 -q "Quiero el plan Pro" -s "$SESSION"

Resultado

text

01  Answer
02  ────────────────────────────────────────
03Tenemos tres planes: Básico, Pro y Enterprise...
04 
05  Sources
06  ────────────────────────────────────────
07  Title: Catálogo 2026
08  URL: https://files.example.com/catalogo.pdf
09 
10  Session: 3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f
11  Continue it with: plazbot agent message age_AbcDef123 -s 3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f -q "..."

Salida JSON

json

01{
02  "answer": "Tenemos tres planes: Básico, Pro y Enterprise...",
03  "sessionId": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
04  "sources": [
05    { "title": "Catálogo 2026", "url": "https://files.example.com/catalogo.pdf" }
06  ]
07}

sources solo aparece cuando la respuesta tiene fuentes; title y url pueden ser null.

Cada llamada sin -s inicia una conversación nueva. Reutiliza el sessionId impreso para mantener el contexto.

Errores comunes

Mensaje	Causa	Solución
`error: required option '-q, --question <text>' not specified`	Falta `-q`.	Pasa la pregunta con `-q "<texto>"`.
`The question cannot be empty.`	`-q` vacío o solo espacios.	Escribe un mensaje.
`Resource not found.`	El ID no existe en el workspace activo.	Revisa el ID con `plazbot agent list`.
`You are not signed in.`	No hay sesión activa.	Ejecuta `plazbot login`.