Producto
CLI

Copiar entre workspaces

Copia un agente de un workspace a otro, incluso entre zonas.

Copiar un agente a otro workspace

Lee un agente del workspace de origen, limpia su configuración y lo crea en el workspace de destino (también entre zonas LA y EU). Por defecto no copia los canales ni la configuración de IA, y la copia queda con el widget desactivado. Pide confirmación antes de crear.

bash
01plazbot agent cross-copy <agentId> --from-workspace <id> --to-workspace <id> [options]

Parámetros

ParámetroFlagRequeridoDescripción
agentId(posicional)SíID del agente a copiar.
Origen--from-workspace <id>SíWorkspace de origen.
Destino--to-workspace <id>SíWorkspace de destino.
Zona de origen--from-zone <zone>NoLA o EU. Por defecto: LA.
Zona de destino--to-zone <zone>NoLA o EU. Por defecto: LA.
Canales--channelsNoTambién copia los canales (normalmente incorrecto: los canales pertenecen al workspace de origen). Por defecto: false.
IA--aiNoTambién copia la configuración de IA propia (aiProviders) y la clave del avatar (avatarApiKey). Contiene API keys de terceros. Por defecto: false.
JSON--jsonNoImprime el resultado como JSON. Por defecto: false.
Confirmar-y, --yesNoOmite la confirmación (scripts y CI). Alias: --confirm. Por defecto: false.

Tu sesión debe tener acceso a los dos workspaces.

Qué se copia

  • La configuración limpia del agente (la misma que produce export), con zone ajustada a la zona de destino.
  • Sin --channels: channels queda vacío.
  • Sin --ai: customAIConfig queda en false y no se copian aiProviders ni avatarApiKey; el agente copiado usa la IA por defecto de la plataforma.
  • enableWidget siempre queda en false. Actívalo con plazbot agent enable-widget.

Ejemplos

bash
01# Copiar entre dos workspaces de LA (sin canales ni IA)
02plazbot agent cross-copy age_AbcDef123 --from-workspace wok_Source123 --to-workspace wok_Target456
03 
04# Copiar entre zonas (LA a EU)
05plazbot agent cross-copy age_AbcDef123 --from-workspace wok_Source123 --from-zone LA --to-workspace wok_Target456 --to-zone EU
06 
07# Copiar sin confirmación (scripts y CI)
08plazbot agent cross-copy age_AbcDef123 --from-workspace wok_Source123 --to-workspace wok_Target456 --yes --json
09 
10# Copiar conservando canales y proveedores de IA
11plazbot agent cross-copy age_AbcDef123 --from-workspace wok_Source123 --to-workspace wok_Target456 --channels --ai

Resultado

text
01 ┌──────────────────────────────────────────────────────────┐
02 │ Copy agent between workspaces │
03 └──────────────────────────────────────────────────────────┘
04 
05 Source: wok_Source123 (LA)
06 Target: wok_Target456 (LA)
07 Agent: age_AbcDef123
08 
09✔ Agent fetched: Sales Plazbot
10 
11 Configuration to copy:
12 Name: Sales Plazbot
13 Target zone: LA
14 Channels: 0
15 Services: 2
16 Actions: 3
17 Custom AI: No
18 
19? Create "Sales Plazbot" in workspace wok_Target456 (LA)? (y/N) y
20✔ Agent created successfully
21 
22 New ID: age_XyzUvw456
23 Widget disabled by default.
24 Channels were not copied: connect them in the target workspace.

Si respondes que no, se imprime Aborted. y el comando termina con código 1.

Salida JSON

Con --json, stdout solo lleva el resultado; el resumen va a stderr.

json
01{
02 "id": "age_XyzUvw456",
03 "sourceId": "age_AbcDef123",
04 "name": "Sales Plazbot",
05 "fromWorkspace": "wok_Source123",
06 "toWorkspace": "wok_Target456",
07 "fromZone": "LA",
08 "toZone": "LA"
09}

Los canales son específicos de cada workspace. Después de la copia, conecta el número en el destino con plazbot whatsapp assign -p <número> -a <agentId> o desde la plataforma.

Errores comunes

MensajeCausaSolución
error: required option '--from-workspace <id>' not specifiedFalta --from-workspace (o --to-workspace).Pasa los dos workspaces.
--from-zone must be LA or EU (got "<valor>").Zona inválida (igual para --to-zone).Usa LA o EU.
Agent age_AbcDef123 was not found in workspace wok_Source123 (LA).El agente no está en el origen o la zona no es la correcta.Revisa --from-workspace y --from-zone.
This action needs confirmation and there is no interactive terminal.Sin terminal (o con --json) y sin --yes.Agrega --yes.
The API rejected the agent configuration.La API de destino rechazó la configuración.Exporta el agente y revísalo con plazbot agent validate.
You are not signed in.No hay sesión activa.Ejecuta plazbot login.
¿Quieres probar la API en vivo? Abre el Playground.