Clonar un agente - Agents Studio Docs

curl --request POST \ --url https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/clone \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'x-workspace-id: <x-workspace-id>' \ --data ' { "name": "Agente clon - Cobranza", "description": "Copia operativa para ajustes por campaña", "status": "inactive", "versionId": "4c01f8ad-9ae5-4b20-98af-9559a2899a21", "clone": [ "instructions", "tools", "webhooks", "businessHours", "businessHourExceptions", "triggers" ] } '

{ "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "<string>", "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "createdAt": "2023-11-07T05:31:56Z", "updatedAt": "2023-11-07T05:31:56Z", "totalCalls": 1, "totalOperationalDays": 1, "goalAchievedPercentage": 50, "versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "description": "<string>", "avatarUrl": "<string>", "debounceDelayMs": 1, "toneId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "messageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "knowledgeBaseIds": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "tags": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "tools": [ { "identifier": "<string>", "displayName": "<string>", "enabled": true } ], "voiceConfig": { "voiceId": "<string>", "webhookUrl": "<string>", "llmId": "<string>" }, "metadata": {} }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-workspace-id

string<uuid>

required

Identificador del workspace multi-tenant.

Path Parameters

agentId

string<uuid>

required

Identificador del agente

Body

application/json

Datos necesarios para clonar un agente existente dentro del workspace activo.

versionId selecciona la versión origen desde la cual clonar blueprint/instructions.
clone controla qué componentes adicionales se copian.
El workflow (blueprint + stages) se clona siempre; triggers habilita copiar transiciones.
La conexión voice.calls no se clona; se crea una nueva conexión automáticamente.

name

string

required

Nombre del nuevo agente.

Required string length: 1 - 255

versionId

string<uuid>

required

Identificador de la versión origen a clonar.

clone

enum<string>[]

required

Componentes a clonar además del workflow (blueprint + stages).

Minimum array length: 1

Available options:

instructions,

tools,

webhooks,

stages,

triggers,

businessHours,

businessHourExceptions

description

string | null

Descripción operativa opcional para el nuevo agente.

Maximum string length: 1000

status

enum<string> | null

Estado inicial del agente clonado.

Available options:

inactive,

training,

active

Response

Agente clonado

agentId

string<uuid>

required

name

string

required

agentType

enum<string>

required

Available options:

chat,

voice

workspaceId

string<uuid>

required

status

enum<string>

required

Available options:

inactive,

training,

active,

archived

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

totalCalls

integer

required

Total de llamadas realizadas por el agente.

Required range: x >= 0

totalOperationalDays

integer

required

Total de días operativos desde la creación del agente.

Required range: x >= 0

goalAchievedPercentage

number

required

Porcentaje de llamadas donde el objetivo fue alcanzado.

Required range: 0 <= x <= 100

versionId

string<uuid>

description

string | null

avatarUrl

string<uri> | null

URL pública opcional utilizada para representar al agente.

debounceDelayMs

integer | null

Delay opcional antes de enviar respuestas (milisegundos).

Required range: x >= 0

toneId

string<uuid> | null

messageStyleId

string<uuid> | null

ownerUserId

string<uuid> | null

knowledgeBaseIds

string<uuid>[]

Identificadores de knowledge bases asociadas.