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://api-prod.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"
}
Aprovecha nuestros agentes semilla para acelerar despliegues de voz sin empezar desde cero. Cada plantilla incluye versión, blueprint, stages, triggers e instrucciones alineadas a buenas prácticas operativas.

​
Catálogo disponible (noviembre 2025)

NombreCaso de usoEtiquetasIDSlug
Claudia Ramírez - Agente de Cobranza TempranaRecuperación de cartera 1-30 días en Méxicocobranza, voz, mx, mora-tempranaec9205ec-7c0c-41b7-86da-67cc3c2dd0f2voice-cobranza-temprana-mx
Agente de Prospección B2BProspección y calificación de leads enterpriseprospeccion, ventas, b2b, vozc9a0f94b-ffa8-4527-8b65-ee0ef47f6e3dvoice-prospeccion-b2b-template

​
Claudia Ramírez - Agente de Cobranza Temprana

  • Descripción: Ejecutiva de cobro especializada en mora temprana con guías de cumplimiento CONDUSEF.
  • Blueprint: etapas completas de validación de identidad, negociación y cierres (positivo, reagendado o sin compromiso).
  • Buenas prácticas: lenguaje mexicano natural, manejo de objeciones y registros de promesa de pago.

​
Agente de Prospección B2B

  • Descripción: Voz consultiva que usa SPIN Selling para calificar prospectos y agendar demos.
  • Blueprint: apertura, descubrimiento (situación, problema, implicación, valor), calificación BANT y cierres alternos.
  • Buenas prácticas: reglas de tono profesional, opciones de reagendamiento y manejo de objeciones en 7 pasos.

​
Clonar una plantilla

import { createClient } from '@getsupervisor/agents-studio-sdk';

const client = createClient({
baseUrl: process.env.API_BASE_URL!,
workspaceId: process.env.WORKSPACE_ID!,
apiKey: process.env.API_KEY!,
});

const agent = await client.agents.forkFromTemplate({
templateId: 'c9a0f94b-ffa8-4527-8b65-ee0ef47f6e3d',
name: 'Pipeline Q1 - Prospección',
status: 'inactive',
debounceDelayMs: 0,
});

console.log(agent.agentId, agent.name, agent.versionId);
El campo templateVersionId es opcional; si lo omites se usa la versión publicada más reciente. Requiere scopes catalogs:read y agents:write.

​
Recomendaciones posteriores

  • Activa la tool voice.calls o la integración preferida antes de publicar la nueva versión.
  • Personaliza saludo, reglas críticas y triggers según tus políticas internas.
  • Ajusta horarios (POST /v1/agents/{agentId}/schedule) y credenciales externas antes de pasar a producción.
  • Documenta los cambios en notes al publicar la versión para mantener auditoría.

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

​
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