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
01plazbot 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) |
| 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
01# Quitar un agente (pide confirmación)02plazbot portal remove-agent por_AbcDef123 -a age_AbcDef1230304# Sin confirmación, para scripts y CI05plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes0607# Sin confirmación y con resultado en JSON08plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes --json
Resultado
text
01? Detach agent "Asistente de Ventas" from portal "Help Center"? Yes02✔ Agent "Asistente de Ventas" detached from portal "Help Center"
Si respondes que no, imprime Aborted. y termina con código 1.
Salida JSON
json
01{02 "portalId": "por_AbcDef123",03 "agentId": "age_AbcDef123",04 "removed": true05}
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 |
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 |