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 |
| 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 |
| model | Identificador de modelo opcional. Obrigatório quando |
| model_type | Modo de inferência opcional. Quando omitido, o serviço de autoria utiliza |
| 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 |
| 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