GenerateVoiceAgentRequest interface

As entradas para gerar um agente de voz. Apenas kind e name são sempre obrigatórios. O serviço de autoria expande essas entradas em um , completo e editável VoiceAgentDefinition, que é então criado por meio de POST /agents. As configurações geradas instructions e de áudio/voz são armazenadas como campos separados na definição resultante do agente, para que o chamador possa editar ou sobrescrever qualquer uma delas posteriormente via versionamento padrão do agente.

Propriedades

description

Uma descrição opcional do agente. O serviço de autoria resolve seu recurso de retenção quando é omitido.

draft

(Prévia) Quando true, o agente de voz gerado é criado como um rascunho — uma versão editável e não publicada que o chamador pode revisar e refinar antes de publicá-la pelo caminho padrão de criação/versão. O serviço se false aplica por padrão se um valor não for especificado pelo chamador, caso em que o agente é criado e publicado normalmente.

goal

Uma descrição opcional em linguagem natural do que o agente deve fazer. Quando fornecido, ele gera as instruções geradas.

kind

O tipo de agente. Sempre voice.

model

Identificador opcional do modelo. Exigido quando model_type é self_deployed; opcional quando model_type é managed ou omitido. O serviço nunca inventa um nome de implantação do cliente.

model_type

Modo de inferência opcional. Quando omitido, o serviço de autoria usa managed. Quando fornecido, use managed ou self_deployed.

name

O nome único para o agente criar. Deve ser um nome de agente não vazio, parecido com DNS.

tools

Ferramentas opcionais foram transmitidas literalmente para o agente gerado (veja VoiceAgentTool).

use_case

Um caso de uso opcional de autoria. Uma corda vazia é aceita.

Detalhes da propriedade

description

Uma descrição opcional do agente. O serviço de autoria resolve seu recurso de retenção quando é omitido.

description?: string

Valor da propriedade

string

draft

(Prévia) Quando true, o agente de voz gerado é criado como um rascunho — uma versão editável e não publicada que o chamador pode revisar e refinar antes de publicá-la pelo caminho padrão de criação/versão. O serviço se false aplica por padrão se um valor não for especificado pelo chamador, caso em que o agente é criado e publicado normalmente.

draft?: boolean

Valor da propriedade

boolean

goal

Uma descrição opcional em linguagem natural do que o agente deve fazer. Quando fornecido, ele gera as instruções geradas.

goal?: string

Valor da propriedade

string

kind

O tipo de agente. Sempre voice.

kind: "voice"

Valor da propriedade

"voice"

model

Identificador opcional do modelo. Exigido quando model_type é self_deployed; opcional quando model_type é managed ou omitido. O serviço nunca inventa um nome de implantação do cliente.

model?: string

Valor da propriedade

string

model_type

Modo de inferência opcional. Quando omitido, o serviço de autoria usa managed. Quando fornecido, use managed ou self_deployed.

model_type?: VoiceModelType

Valor da propriedade

name

O nome único para o agente criar. Deve ser um nome de agente não vazio, parecido com DNS.

name: string

Valor da propriedade

string

tools

Ferramentas opcionais foram transmitidas literalmente para o agente gerado (veja VoiceAgentTool).

tools?: VoiceAgentToolUnion[]

Valor da propriedade

use_case

Um caso de uso opcional de autoria. Uma corda vazia é aceita.

use_case?: string

Valor da propriedade

string