Listar agentes

Muestra todos los agentes de IA del workspace activo con su ID, nombre, estado, descripción y fecha de creación.

bash

01plazbot agent list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
JSON	`--json`	No	Imprime los agentes como un arreglo JSON (`id`, `name`, `enable`, `description`, `createdAt`). Por defecto: `false`.

Ejemplos

bash

01# Listar los agentes del workspace activo
02plazbot agent list
03 
04# Obtener los agentes en JSON
05plazbot agent list --json
06 
07# Obtener solo los IDs (para scripts)
08plazbot agent list --json | jq -r '.[].id'

Resultado

text

01Agents (2):
02══════════════════════════════════════════════════
031. ID: age_AbcDef123
04   Name: Sales Plazbot
05   Status: Active
06   Description: Asistente virtual de ventas
07   Created: 6/3/2026, 7:25:21 PM
08──────────────────────────────────────────────────
092. ID: age_XyzUvw456
10   Name: Soporte Técnico
11   Status: Inactive
12   Description: —
13   Created: 6/4/2026, 1:33:45 AM
14──────────────────────────────────────────────────

Si el workspace no tiene agentes:

text

01No agents found in this workspace.
02  Create one with: plazbot agent create

Salida JSON

json

01[
02  {
03    "id": "age_AbcDef123",
04    "name": "Sales Plazbot",
05    "enable": true,
06    "description": "Asistente virtual de ventas",
07    "createdAt": "2026-06-03T19:25:21.000Z"
08  }
09]

Si no hay agentes, imprime [].

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay una sesión activa.	Ejecuta `plazbot login`.
`Your session is invalid or expired.`	La API key guardada ya no es válida.	Vuelve a iniciar sesión con `plazbot login`.