# Clonar agente

> Crea una copia de un agente dentro del workspace activo.

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

### Clonar agente

Crea una copia de un agente en el mismo workspace. La copia se crea con el widget web desactivado. Para copiar un agente a otro workspace usa [`plazbot agent cross-copy`](https://developers.plazbot.com/cli/agent/cross-copy).

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

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| `agentId` | (posicional) | Sí | ID del agente a clonar. |
| JSON | `--json` | No | Imprime el resultado como JSON (`{"sourceId","id","name"}`). Por defecto: `false`. |

### Ejemplos

```bash
# Clonar un agente
plazbot agent copy age_AbcDef123

# Clonar y capturar el nuevo ID (scripts)
plazbot agent copy age_AbcDef123 --json | jq -r '.id'
```

### Resultado

```text
✔ Agent cloned as "Sales Plazbot - Copy"

Cloned agent
────────────────────────────────────────
Source ID: age_AbcDef123
New ID: age_XyzUvw456
Name: Sales Plazbot - Copy

The cloned agent has the widget disabled.
Test it with: plazbot agent chat age_XyzUvw456
```

La API nombra la copia con el nombre original seguido de ` - Copy`.

### Salida JSON

```json
{
"sourceId": "age_AbcDef123",
"id": "age_XyzUvw456",
"name": "Sales Plazbot - Copy"
}
```

`id` y `name` pueden ser `null` si la API no los devuelve.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `The API rejected the copy.` | La API respondió sin éxito y sin un mensaje propio. | Revisa que el agente exista con `plazbot agent get age_AbcDef123`. |
| `Resource not found.` | 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`](https://developers.plazbot.com/cli/login). |