Producto
CLI

Quitar Agente de Portal

Desvincula un agente de un portal sin eliminar el agente

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ámetroFlagRequeridoDescripció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, --yesNoOmite la confirmación (scripts y CI)
JSON--jsonNoImprime el resultado en JSON (requiere --yes)

Ejemplos

bash
01# Quitar un agente (pide confirmación)
02plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123
03 
04# Sin confirmación, para scripts y CI
05plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes
06 
07# Sin confirmación y con resultado en JSON
08plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes --json

Resultado

text
01? Detach agent "Asistente de Ventas" from portal "Help Center"? Yes
02✔ 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": true
05}

Errores comunes

MensajeCausaSolución
Agent age_... is not attached to portal "..."El agente no está asociado a ese portalRevisa 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 --yesAgrega --yes
Agent ID is required.Falta -aPasa -a, --agent <agentId>
Portal ID is required.Falta el primer argumentoPasa el ID del portal
¿Quieres probar la API en vivo? Abre el Playground.