GenerateVoiceAgentRequest interface

Las entradas para generar un agente de voz. Solo kind y name siempre son obligatorios. El servicio de autoría amplía estas entradas en un , completo y editable VoiceAgentDefinition, que luego se crea mediante POST /agents. Los ajustes generados instructions y de audio/voz se almacenan como campos separados en la definición resultante del agente, por lo que el llamante puede editar o anular cualquiera de ellos posteriormente mediante el versionado estándar del agente.

Propiedades

description

Una descripción opcional del agente. El servicio de autoría resuelve su respaldo cuando se omite.

draft

(Vista previa) Cuando true, el agente de voz generado se crea como un borrador — una versión editable y no publicada que el llamante puede revisar y refinar antes de publicarla a través de la ruta estándar de creación/versión. El servicio se establece por defecto false en si el llamador no especifica un valor, en cuyo caso el agente se crea y publica de forma normal.

goal

Una descripción opcional en lenguaje natural de lo que debe hacer el agente. Cuando se suministra, siembra las instrucciones generadas.

kind

Tipo de agente. Siempre voice.

model

Identificador de modelo opcional. Obligatorio cuando model_type es self_deployed; opcional cuando model_type se está managed o se omite. El servicio nunca inventa un nombre de despliegue para el cliente.

model_type

Modo de inferencia opcional. Cuando se omite, el servicio de autoría utiliza managed. Cuando se suministre, utilice managed o self_deployed.

name

El nombre único que el agente debe crear. Debe ser un nombre de agente no vacío tipo DNS.

tools

Las herramientas opcionales se trasladaron literalmente al agente generado (véase VoiceAgentTool).

use_case

Un caso de uso opcional de autoría. Se acepta una cadena vacía.

Detalles de las propiedades

description

Una descripción opcional del agente. El servicio de autoría resuelve su respaldo cuando se omite.

description?: string

Valor de propiedad

string

draft

(Vista previa) Cuando true, el agente de voz generado se crea como un borrador — una versión editable y no publicada que el llamante puede revisar y refinar antes de publicarla a través de la ruta estándar de creación/versión. El servicio se establece por defecto false en si el llamador no especifica un valor, en cuyo caso el agente se crea y publica de forma normal.

draft?: boolean

Valor de propiedad

boolean

goal

Una descripción opcional en lenguaje natural de lo que debe hacer el agente. Cuando se suministra, siembra las instrucciones generadas.

goal?: string

Valor de propiedad

string

kind

Tipo de agente. Siempre voice.

kind: "voice"

Valor de propiedad

"voice"

model

Identificador de modelo opcional. Obligatorio cuando model_type es self_deployed; opcional cuando model_type se está managed o se omite. El servicio nunca inventa un nombre de despliegue para el cliente.

model?: string

Valor de propiedad

string

model_type

Modo de inferencia opcional. Cuando se omite, el servicio de autoría utiliza managed. Cuando se suministre, utilice managed o self_deployed.

model_type?: VoiceModelType

Valor de propiedad

name

El nombre único que el agente debe crear. Debe ser un nombre de agente no vacío tipo DNS.

name: string

Valor de propiedad

string

tools

Las herramientas opcionales se trasladaron literalmente al agente generado (véase VoiceAgentTool).

tools?: VoiceAgentToolUnion[]

Valor de propiedad

use_case

Un caso de uso opcional de autoría. Se acepta una cadena vacía.

use_case?: string

Valor de propiedad

string