# Listar agentes

> Lista todos los agentes de IA del workspace activo.

Fuente: https://developers.plazbot.com/cli/agent/list/

### Listar agentes

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

```bash
plazbot 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
# Listar los agentes del workspace activo
plazbot agent list

# Obtener los agentes en JSON
plazbot agent list --json

# Obtener solo los IDs (para scripts)
plazbot agent list --json | jq -r '.[].id'
```

### Resultado

```text
Agents (2):
══════════════════════════════════════════════════
1. ID: age_AbcDef123
 Name: Sales Plazbot
 Status: Active
 Description: Asistente virtual de ventas
 Created: 6/3/2026, 7:25:21 PM
──────────────────────────────────────────────────
2. ID: age_XyzUvw456
 Name: Soporte Técnico
 Status: Inactive
 Description: —
 Created: 6/4/2026, 1:33:45 AM
──────────────────────────────────────────────────
```

Si el workspace no tiene agentes:

```text
No agents found in this workspace.
Create one with: plazbot agent create
```

### Salida JSON

```json
[
{
  "id": "age_AbcDef123",
  "name": "Sales Plazbot",
  "enable": true,
  "description": "Asistente virtual de ventas",
  "createdAt": "2026-06-03T19:25:21.000Z"
}
]
```

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`](https://developers.plazbot.com/cli/login). |
| `Your session is invalid or expired.` | La API key guardada ya no es válida. | Vuelve a iniciar sesión con `plazbot login`. |