Crear agente

Crea un agente de IA de dos formas: sin argumentos abre un asistente interactivo de 8 pasos; con la ruta de un archivo JSON crea el agente directamente desde esa configuración (ideal para scripts y CI).

bash

01plazbot agent create [configPath] [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
`configPath`	(posicional)	No	Ruta a un archivo JSON con la configuración. Si se omite, se abre el asistente interactivo.
JSON	`--json`	No	Imprime el agente creado como JSON (`{"id","name"}`). Por defecto: `false`.

Ejemplos

bash

01# Abrir el asistente interactivo
02plazbot agent create
03 
04# Crear desde un archivo JSON
05plazbot agent create ./agent.json
06 
07# Crear desde un archivo y capturar el nuevo ID (scripts)
08plazbot agent create ./agent.json --json | jq -r '.id'

Asistente interactivo

El asistente necesita una terminal interactiva. Cada paso propone valores por defecto que aceptas con Enter.

Paso	Qué pregunta
1/8 Basic information	Nombre (obligatorio), descripción, system prompt (por defecto `You are a friendly and professional virtual assistant.`), memoria de conversación: cuántos mensajes anteriores lee el agente, de 3 a 20 (por defecto 5), y color (`blue`, `green`, `orange`, `gray`, `white`).
2/8 Personality and instructions	Tono (Professional, Friendly, Formal, Casual, Technical, Empathetic), estilo (Concise, Detailed, Conversational, Direct), personalidad, objetivo, idioma de respuesta (Spanish, English, Portuguese, French) y si usa emojis.
3/8 Agent identity	Nombre del personaje (por defecto el nombre del agente), rol (por defecto `Virtual assistant`) y si habla en primera persona.
4/8 Fallback messages	Mensajes para cuando no tiene respuesta, cuando falla un servicio externo y cuando no entiende. Los valores por defecto están en el idioma elegido en el paso 2.
5/8 Tool Calling	Si activa Tool Calling (por defecto sí). Si lo activas, puedes agregar servicios (llamadas a APIs) y acciones con las mismas preguntas que `plazbot agent tools`.
6/8 AI provider	Si usa tu propio proveedor de IA. Si respondes que sí: proveedor (OpenAI, Anthropic (Claude), Google (Gemini)), modelo y API token. Se guarda con temperatura 0.7 y 4096 tokens máximos; ajústalos luego con `plazbot agent ai-config`. Si respondes que no, usa la IA por defecto de la plataforma.
7/8 Connect a channel	Si conectas un canal ahora (WhatsApp, WhatsApp Business, Instagram, Messenger, Telegram). Puedes elegir una integración existente del workspace o generar un enlace de conexión; el CLI espera la conexión (Enter para omitir) y activa la integración.
8/8 Conversation examples	Ejemplos de conversación (mensaje del cliente y respuesta del agente) para guiar al agente.

Al final muestra una vista previa y pide confirmación:

text

01  Configuration preview
02  ────────────────────────────────────────
03  Name: Sofia
04  Prompt: Eres una asesora comercial de Acme...
05  Memory: 5 messages
06  Language: Spanish
07  Tool Calling: Enabled
08  Services: 1
09  Actions: 2
10  AI provider: Platform default (Plazbot)
11  Channels: Not connected
12 
13? Create the agent with this configuration? (Y/n)

Si respondes que no, se imprime Aborted. y el comando termina con código 1.

Los modelos disponibles en el paso 6 son los mismos de ai-config. Modelo por defecto: gpt-4o (OpenAI), claude-sonnet-4-6 (Claude), gemini-2.5-pro (Gemini).

Desde un archivo JSON

El archivo debe contener un objeto JSON con la configuración del agente. Los campos obligatorios del schema son name, prompt, zone y buffer (entero de 3 a 20).

json

01{
02  "name": "Sofia",
03  "description": "Asistente de atención al cliente",
04  "prompt": "Eres una asistente amable que ayuda a los clientes de Acme.",
05  "zone": "LA",
06  "buffer": 5,
07  "color": "blue",
08  "question": "¿Cómo te podemos ayudar?",
09  "timezone": "America/Lima",
10  "person": {
11    "name": "Sofia",
12    "role": "Asistente de atención al cliente",
13    "speaksInFirstPerson": true,
14    "isHuman": false
15  },
16  "instructions": {
17    "tone": "amigable",
18    "style": "conversacional",
19    "language": "Espanol",
20    "emojis": true
21  },
22  "useToolCalling": false
23}

Valida el archivo antes de crearlo con plazbot agent validate ./agent.json. Para partir de un agente existente, usa plazbot agent export; para partir de una plantilla, plazbot agent templates --json.

Resultado

text

01  Creating agent from file
02  ────────────────────────────────────────
03  { ...contenido del archivo... }
04✔ Agent created successfully
05 
06  Agent details
07  ────────────────────────────────────────
08  ID: age_AbcDef123
09  Name: Sofia
10  Tool Calling: Disabled
11 
12  Next steps:
13    plazbot agent chat age_AbcDef123       # test it in the terminal
14    plazbot agent get age_AbcDef123        # review the configuration

Salida JSON

json

01{
02  "id": "age_AbcDef123",
03  "name": "Sofia"
04}

Errores comunes

Mensaje	Causa	Solución
`The agent wizard needs an interactive terminal.`	Se ejecutó sin archivo en CI, un pipe o con `--json`.	Pasa un archivo: `plazbot agent create ./agent.json`.
`Could not read the config file: ...`	La ruta no existe o no se puede leer.	Revisa la ruta del archivo.
`The config file is not valid JSON: ...`	El archivo tiene un error de sintaxis.	Revísalo con `plazbot agent validate ./agent.json`.
`The config file must contain a JSON object.`	El archivo contiene un arreglo u otro valor.	El archivo debe ser un objeto `{ ... }`.
`The API rejected the agent configuration:` seguido de una lista numerada	La API validó el schema y encontró errores (uno por línea).	Corrige los campos indicados; revisa con `plazbot agent validate`.
`You are not signed in.`	No hay sesión activa.	Ejecuta `plazbot login`.