Agregar Agente a Portal

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

01plazbot 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`)
Agent ID	`-a, --agent <agentId>`	Sí	ID del agente que se asocia (sale en `plazbot agent list`)
JSON	`--json`	No	Imprime el resultado en JSON

Ejemplos

bash

01# Asociar un agente a un portal
02plazbot portal add-agent por_AbcDef123 -a age_AbcDef123
03 
04# Asociar y obtener el resultado en JSON
05plazbot portal add-agent por_AbcDef123 -a age_AbcDef123 --json

Resultado

text

01✔ 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

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

Salida JSON

json

01{
02  "portalId": "por_AbcDef123",
03  "agentId": "age_AbcDef123",
04  "agentName": "Asistente de Ventas",
05  "added": true
06}

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`

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.