Skip to main content
POST
/
v1
/
agents
/
from-template
Crear agente a partir de una plantilla (fork de agent_version)
curl --request POST \
  --url https://agents.studio.getsupervisor.ai/v1/agents/from-template \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "templateId": "0f92c4f0-62f7-4337-82c2-7d9b19c5b6a2",
  "name": "Campaña de cobranza",
  "status": "inactive",
  "debounceDelayMs": 500
}
'
{
  "agentId": "8e7a9b94-2d5f-4d26-a2d5-6ff5f08fc81f",
  "workspaceId": "a44bb95e-9f01-4d19-8b62-1f6f2b8e8363",
  "name": "Cobranza Outbound Baseline",
  "agentType": "voice",
  "status": "inactive",
  "versionId": "4c01f8ad-9ae5-4b20-98af-9559a2899a21",
  "knowledgeBaseIds": [],
  "tools": [],
  "createdAt": "2025-10-15T09:21:45.000Z",
  "updatedAt": "2025-10-15T09:21:45.000Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Datos necesarios para clonar una plantilla del catálogo y crear un nuevo agente en el workspace activo. Permite sobrescribir metadatos básicos del agente generado.

​
templateId
string<uuid>
required

Identificador de la plantilla a clonar.

​
templateVersionId
string<uuid>

Opcional. Si no se especifica, se usa el agent_version_id configurado como predeterminado en la tabla catalog_templates.

​
name
string | null

Opcional. Nombre a asignar al nuevo agente.

Maximum string length: 255
​
description
string | null

Opcional. Descripción operativa del agente.

Maximum string length: 1000
​
status
enum<string> | null

Opcional. Estado inicial del agente generado.

Available options:
inactive,
training,
active
​
debounceDelayMs
integer | null

Opcional. Delay antes de procesar eventos (milisegundos).

Required range: x >= 0

Response

Agente creado a partir de plantilla

​
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
​
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.

​
tags
string<uuid>[]

Tags de negocio asignados al agente. Se administran mediante /v1/agents/{agentId}/tags.

​
tools
object[]

Tools habilitadas para el agente.

​
voiceConfig
object

Configuración de voz activa cuando el agente es de tipo voice.

​
metadata
object