# Obtener agente

> Muestra la configuración completa de un agente.

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

### Obtener agente

Muestra la configuración de un agente en un formato legible: información básica, prompt, ejemplos, instrucciones, persona, fallbacks, reglas, servicios, acciones, canales y modelo de IA. Con `--json` imprime el documento completo del agente.

```bash
plazbot agent get <agentId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| `agentId` | (posicional) | Sí | ID del agente, por ejemplo `age_AbcDef123`. |
| JSON | `--json` | No | Imprime el agente completo como JSON. Por defecto: `false`. |

### Ejemplos

```bash
# Ver el agente en formato legible
plazbot agent get age_AbcDef123

# Obtener el JSON completo (útil con jq)
plazbot agent get age_AbcDef123 --json

```

### Resultado

```text
┌──────────────────────────────────────────────────────────┐
│  Sales Plazbot                                           │
│  age_AbcDef123                                           │
└──────────────────────────────────────────────────────────┘

Basic Information
────────────────────────────────────────
ID: age_AbcDef123
Name: Sales Plazbot
Description: Asistente virtual de ventas
Status: Active
Zone: LA
Buffer: 5
Color: blue
Initial question: ¿En qué te puedo ayudar?
Timezone: America/Lima
Show in chat: Yes
Tool Calling: Enabled

Prompt
────────────────────────────────────────
Eres un asesor comercial que ayuda a los clientes...

Instructions
────────────────────────────────────────
Tone: amigable
Style: conciso
...

Services (1)
────────────────────────────────────────
1. check_order_status
  Reference: Cuando el cliente pregunta por su pedido
  Enabled: Yes
  Method: GET
  Endpoint: https://api.example.com/orders/{{orderId}}

Use --json to see the full JSON
```

### Salida JSON

Con `--json` se imprime el documento del agente tal como lo devuelve la API (todos sus campos: `name`, `prompt`, `instructions`, `person`, `services`, `actions`, `channels`, `aiProviders`, etc.). Para obtener un JSON limpio y listo para `create` o `update`, usa [`plazbot agent export`](https://developers.plazbot.com/cli/agent/export).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Agent "age_AbcDef123" was not found in workspace wok_AbcDef123 (zone LA).` | El ID no existe en el workspace o la zona activa. | Revisa con `plazbot whoami` y `plazbot agent list`; cambia de workspace con `plazbot workspace use <workspaceId>`. |
| `Invalid zone "XX".` | `-z` no es `LA` ni `EU`. | Usa `-z LA` o `-z EU`. |
| `You do not have permission to access agent "age_AbcDef123" in workspace wok_AbcDef123.` | Tu sesión no tiene acceso a ese workspace. | Cambia al workspace correcto. |
| `You are not signed in.` | No hay sesión activa. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |