Ajustes rápidos | Plazbot Docs

Ajustes rápidos del agente

Cambia rápidamente el saludo, las instrucciones o la persona de un agente sin editar su JSON. Solo se modifican los valores que indicas; el resto de la configuración del agente se mantiene.

bash

01plazbot agent set <greeting|instructions|persona> <agentId> [options]

set greeting

Cambia el saludo del agente (el primer mensaje de una conversación, instructions.greeting).

bash

01plazbot agent set greeting <agentId> "<greeting>" [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
`agentId`	(posicional)	Sí	ID del agente.
`greeting`	(posicional)	Sí	Texto del saludo, entre comillas. No puede estar vacío.
JSON	`--json`	No	Imprime el resultado como JSON (`{"id","updated","greeting"}`). Por defecto: `false`.

Ejemplos

bash

01# Cambiar el saludo
02plazbot agent set greeting age_AbcDef123 "¡Hola! ¿En qué te puedo ayudar hoy?"

Resultado

text

01✔ Greeting updated
02  New greeting: ¡Hola! ¿En qué te puedo ayudar hoy?

Salida JSON

json

01{ "id": "age_AbcDef123", "updated": true, "greeting": "¡Hola! ¿En qué te puedo ayudar hoy?" }

set instructions

Configura tono, estilo, personalidad, objetivo, idioma y uso de emojis. Con flags solo cambian esos valores y no se pregunta nada (funciona en scripts). Sin flags se abre un editor interactivo con los valores actuales por defecto.

bash

01plazbot agent set instructions <agentId> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
`agentId`	(posicional)	Sí	ID del agente.
Tono	`--tone <tone>`	No	`profesional`, `amigable`, `formal`, `casual`, `tecnico`, `empatico` o cualquier valor propio.
Estilo	`--style <style>`	No	`conciso`, `detallado`, `conversacional`, `directo` o cualquier valor propio.
Personalidad	`--personality <text>`	No	Personalidad en una frase.
Objetivo	`--objective <text>`	No	Objetivo principal del agente.
Idioma	`--language <language>`	No	`Espanol`, `English`, `Portugues`, `Frances` o cualquier valor propio.
Emojis	`--emojis <true\|false>`	No	Si usa emojis en las respuestas. Acepta también `yes/no`, `1/0`, `on/off`.
JSON	`--json`	No	Imprime el resultado como JSON (`{"id","updated","fields","instructions"}`). Por defecto: `false`.

Ejemplos

bash

01# Editar todos los valores de forma interactiva
02plazbot agent set instructions age_AbcDef123
03 
04# Cambiar solo el tono y los emojis (sin preguntas)
05plazbot agent set instructions age_AbcDef123 --tone amigable --emojis false
06 
07# Definir un objetivo y el idioma
08plazbot agent set instructions age_AbcDef123 --objective "Agendar demos" --language English

Resultado

text

01✔ Instructions updated
02  tone: amigable
03  emojis: false

Salida JSON

json

01{
02  "id": "age_AbcDef123",
03  "updated": true,
04  "fields": ["tone", "emojis"],
05  "instructions": {
06    "tone": "amigable",
07    "style": "conciso",
08    "language": "Espanol",
09    "emojis": false,
10    "greeting": "¡Hola! ¿En qué te puedo ayudar hoy?"
11  }
12}

instructions es el objeto completo resultante (valores actuales más los cambios).

set persona

Configura la persona del agente: nombre del personaje, rol, si habla en primera persona y si se presenta como humano. Con flags no se pregunta nada; sin flags se abre un editor interactivo.

bash

01plazbot agent set persona <agentId> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
`agentId`	(posicional)	Sí	ID del agente.
Nombre	`--name <name>`	No	Nombre del personaje, por ejemplo `"Sofia"`.
Rol	`--role <role>`	No	Rol, por ejemplo `"Asesora comercial"`.
Primera persona	`--first-person <true\|false>`	No	Si habla en primera persona.
Humano	`--human <true\|false>`	No	Si se presenta como humano en lugar de asistente virtual.
JSON	`--json`	No	Imprime el resultado como JSON (`{"id","updated","fields","persona"}`). Por defecto: `false`.

Ejemplos

bash

01# Editar la persona de forma interactiva
02plazbot agent set persona age_AbcDef123
03 
04# Definir nombre y rol (sin preguntas)
05plazbot agent set persona age_AbcDef123 --name "Sofia" --role "Asesora comercial"
06 
07# Hablar como humano y en primera persona
08plazbot agent set persona age_AbcDef123 --first-person true --human true

Resultado

text

01✔ Persona updated
02  name: Sofia
03  role: Asesora comercial

Salida JSON

json

01{
02  "id": "age_AbcDef123",
03  "updated": true,
04  "fields": ["name", "role"],
05  "persona": {
06    "name": "Sofia",
07    "role": "Asesora comercial",
08    "speaksInFirstPerson": true,
09    "isHuman": false
10  }
11}

Errores comunes

Mensaje	Causa	Solución
`The greeting cannot be empty.`	El saludo está vacío.	Escribe el saludo entre comillas.
`No instruction values were given and there is no interactive terminal.`	`set instructions` sin flags en CI, un pipe o con `--json`.	Pasa al menos un flag, por ejemplo `--tone amigable`.
`No persona values were given and there is no interactive terminal.`	`set persona` sin flags y sin terminal.	Pasa al menos un flag, por ejemplo `--name "Sofia"`.
`Invalid value "<valor>" for --emojis.`	Valor booleano no reconocido (igual para `--first-person` y `--human`).	Usa `true` o `false`.
`Agent age_AbcDef123 was not found in the active workspace.`	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`.