Skip to main content
POST
Crear blueprint para una versión del agente

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>

Identificador del workspace multi-tenant. Obligatorio al autenticar con Authorization: Bearer, donde su ausencia devuelve 400 Workspace context is required. Con x-api-key es opcional: la llave ya identifica a su workspace y lo que mandes aquí se ignora.

Path Parameters

agentId
string<uuid>
required

Identificador del agente

versionId
string<uuid>
required

Identificador de la versión del agente

Body

application/json

Campos necesarios para crear el blueprint de una versión del agente.

languageId
string<uuid>
required
personalityName
string
required
Minimum string length: 1
personalityRole
string
required
Minimum string length: 1
targetAudience
string
required
Minimum string length: 1
mainGoal
string
required
Minimum string length: 1
personalityInitialGreeting
string
required
Minimum string length: 1
personalityMessageStyleId
string<uuid>
required
personalityToneStyleId
string<uuid>
required
startSpeaker
enum<string>
required
Available options:
user,
agent
voiceId
string<uuid> | null

Identificador de catálogo (catalog_items) para la voz seleccionada.

requiredData
string[]
criticalRules
string[]
topicsAllowed
string[]
topicsForbidden
string[]
outputVariables
object[]

Variables que el agente debe extraer de la conversación.

Response

Blueprint creado

Blueprint (personalidad) asociado a una versión específica del agente.

version
object
required
blueprintId
string<uuid>
required
agentId
string<uuid>
required
languageId
string<uuid>
required
personalityName
string
required
Minimum string length: 1
personalityRole
string
required
Minimum string length: 1
targetAudience
string
required
Minimum string length: 1
mainGoal
string
required
Minimum string length: 1
personalityInitialGreeting
string
required
Minimum string length: 1
personalityMessageStyleId
string<uuid>
required
personalityToneStyleId
string<uuid>
required
startSpeaker
enum<string>
required
Available options:
user,
agent
requiredData
string[]
required
contentVariables
string[]
required

Variables detectadas en los prompts del blueprint al último cálculo.

variables
string[]
required

Unión deduplicada de variables del blueprint y sus stages activos.

outputVariables
object[]
required

Variables que el agente extrae de la conversación. El tipo viaja ya normalizado: un text enviado en el request se devuelve como string, y choices sólo aparece en las variables de tipo enum.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
voiceId
string<uuid> | null

Identificador de catálogo (catalog_items) para la voz seleccionada.

criticalRules
string[]
topicsAllowed
string[]
topicsForbidden
string[]