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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.getsupervisor.ai/llms.txt

Use this file to discover all available pages before exploring further.

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