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 estes inputs para um full editável VoiceAgentDefinition, que é depois criado através de POST /agents. As definições geradas instructions e áudio/voz são armazenadas como campos separados na definição resultante do agente, para que o chamador possa editar ou substituir qualquer uma delas posteriormente através da versão padrão do agente.

Propriedades

description

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

draft

(Pré-visualização) Quando true, o agente de voz gerado é criado como um rascunho — uma versão editável e não publicada que o chamador pode rever e refinar antes de a publicar pelo caminho padrão de criação/versão. O serviço passa por defeito a false 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, gera as instruções geradas.

kind

Do tipo agente. Sempre voice.

model

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

model_type

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

name

O nome único para o agente criar. Deve ser um nome de agente semelhante ao DNS, que não está vazio.

tools

Ferramentas opcionais mantidas literalmente para o agente gerado (ver VoiceAgentTool).

use_case

Um caso de uso opcional de autoria. Aceite-se uma corda vazia.

Detalhes de Propriedade

description

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

description?: string

Valor de Propriedade

string

draft

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

draft?: boolean

Valor de Propriedade

boolean

goal

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

goal?: string

Valor de Propriedade

string

kind

Do tipo agente. Sempre voice.

kind: "voice"

Valor de Propriedade

"voice"

model

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

model?: string

Valor de Propriedade

string

model_type

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

model_type?: VoiceModelType

Valor de Propriedade

name

O nome único para o agente criar. Deve ser um nome de agente semelhante ao DNS, que não está vazio.

name: string

Valor de Propriedade

string

tools

Ferramentas opcionais mantidas literalmente para o agente gerado (ver VoiceAgentTool).

tools?: VoiceAgentToolUnion[]

Valor de Propriedade

use_case

Um caso de uso opcional de autoria. Aceite-se uma corda vazia.

use_case?: string

Valor de Propriedade

string