# Agregar Agente a Portal

> Asocia un agente de IA existente a un portal

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

### Agregar un agente a un portal

Asocia un agente de IA existente a un portal para que los visitantes puedan conversar con él. Un portal puede tener varios agentes.

```bash
plazbot portal add-agent <portalId> -a <agentId>
```

### 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 asocia (sale en [`plazbot agent list`](https://developers.plazbot.com/cli/agent/list)) |
| JSON | `--json` | No | Imprime el resultado en JSON |

### Ejemplos

```bash
# Asociar un agente a un portal
plazbot portal add-agent por_AbcDef123 -a age_AbcDef123

# Asociar y obtener el resultado en JSON
plazbot portal add-agent por_AbcDef123 -a age_AbcDef123 --json
```

### Resultado

```text
✔ Agent "Asistente de Ventas" attached to portal "Help Center"
```

Si el agente ya estaba asociado, no se repite y el comando termina bien (código `0`):

```text
ℹ Agent "Asistente de Ventas" is already attached to portal "Help Center"
```

### Salida JSON

```json
{
"portalId": "por_AbcDef123",
"agentId": "age_AbcDef123",
"agentName": "Asistente de Ventas",
"added": true
}
```

Si ya estaba asociado: `{"portalId","agentId","added": false,"alreadyAttached": true}`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Portal ID is required.` | Falta el primer argumento | Pasa el ID del portal; búscalo con `plazbot portal list` |
| `Agent ID is required.` | Falta `-a` | Pasa `-a, --agent <agentId>`; búscalo con `plazbot agent list` |
| `Resource not found.` | El portal o el agente no existen en el workspace activo | Revisa los IDs y el workspace con [`plazbot whoami`](https://developers.plazbot.com/cli/whoami) |

> **Nota:** El agente debe existir en el workspace activo. La forma anterior `plazbot portal add-agent-portal -p <portalId> -a <agentId>` sigue funcionando.

Para quitar un agente del portal usa [`plazbot portal remove-agent`](https://developers.plazbot.com/cli/portal/remove-agent).