# Quitar Agente de Portal

> Desvincula un agente de un portal sin eliminar el agente

Fuente: https://developers.plazbot.com/cli/portal/remove-agent/

### Quitar un agente de un portal

Desvincula un agente de un portal: deja de aparecer en el portal, pero el agente no se elimina. Pide confirmación antes de hacerlo.

```bash
plazbot portal remove-agent <portalId> -a <agentId> [--yes]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Portal ID | `<portalId>` | Sí | ID del portal (sale en [`plazbot portal list`](https://developers.plazbot.com/cli/portal/list)) |
| Agent ID | `-a, --agent <agentId>` | Sí | ID del agente que se desvincula |
| Confirmar | `-y, --yes` | No | Omite la confirmación (scripts y CI) |
| JSON | `--json` | No | Imprime el resultado en JSON (requiere `--yes`) |

### Ejemplos

```bash
# Quitar un agente (pide confirmación)
plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123

# Sin confirmación, para scripts y CI
plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes

# Sin confirmación y con resultado en JSON
plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes --json
```

### Resultado

```text
? Detach agent "Asistente de Ventas" from portal "Help Center"? Yes
✔ Agent "Asistente de Ventas" detached from portal "Help Center"
```

Si respondes que no, imprime `Aborted.` y termina con código `1`.

### Salida JSON

```json
{
"portalId": "por_AbcDef123",
"agentId": "age_AbcDef123",
"removed": true
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Agent age_... is not attached to portal "..."` | El agente no está asociado a ese portal | Revisa los agentes asociados con [`plazbot portal get`](https://developers.plazbot.com/cli/portal/get) |
| `This action needs confirmation and there is no interactive terminal.` | Sin terminal interactiva (CI, pipes o `--json`) y sin `--yes` | Agrega `--yes` |
| `Agent ID is required.` | Falta `-a` | Pasa `-a, --agent <agentId>` |
| `Portal ID is required.` | Falta el primer argumento | Pasa el ID del portal |
