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 |
| 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 |
| model | Identificador opcional do modelo. Exigido quando |
| model_type | Modo de inferência opcional. Quando omitido, o serviço de autoria usa |
| 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 |
| 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