GenerateVoiceAgentRequest interface

Pacchetto:

@azure/ai-projects

Gli input per generare un agente vocale. Solo kind e name sono sempre necessari. Il servizio di authoring espande questi input in un completo e modificabile VoiceAgentDefinition, che viene poi creato tramite POST /agents. Le impostazioni generate instructions e audio/voce sono memorizzate come campi separati nella definizione risultante dell'agente, così il chiamante può modificarle o sovrascrivere una qualsiasi di esse successivamente tramite il versioning standard dell'agente.

Proprietà

description	Una descrizione opzionale dell'agente. Il servizio di authoring risolve il suo fallback quando viene omesso.
draft	(Anteprima) Quando true, l'agente vocale generato viene creato come bozza — una versione modificabile e non pubblicata che il chiamante può esaminare e perfezionare prima di pubblicarla tramite il percorso standard di creazione/versione. Il servizio si attiva false di default se un valore non è specificato dal chiamante, nel qual caso l'agente viene creato e pubblicato normalmente.
goal	Una descrizione opzionale in linguaggio naturale di ciò che l'agente dovrebbe fare. Quando viene fornita, genera le istruzioni generate.
kind	Tipo di agente. Sempre voice.
model	Identificatore di modello opzionale. Obbligatorio quando model_type è self_deployed; opzionale quando model_type è managed o omesso. Il servizio non inventa mai un nome di distribuzione del cliente.
model_type	Modalità inferenza opzionale. Quando viene omesso, il servizio di authoring utilizza managed. Quando fornito, usa managed oppure self_deployed.
name	Il nome unico che l'agente deve creare. Deve essere un nome di agente non vuoto simile al DNS.
tools	Gli strumenti opzionali sono stati portati letteralmente sull'agente generato (vedi VoiceAgentTool).
use_case	Un caso d'uso opzionale per l'authoring. Una stringa vuota è accettata.

Dettagli proprietà

description

Una descrizione opzionale dell'agente. Il servizio di authoring risolve il suo fallback quando viene omesso.

description?: string

Valore della proprietà

string

draft

(Anteprima) Quando true, l'agente vocale generato viene creato come bozza — una versione modificabile e non pubblicata che il chiamante può esaminare e perfezionare prima di pubblicarla tramite il percorso standard di creazione/versione. Il servizio si attiva false di default se un valore non è specificato dal chiamante, nel qual caso l'agente viene creato e pubblicato normalmente.

draft?: boolean

Valore della proprietà

boolean

goal

Una descrizione opzionale in linguaggio naturale di ciò che l'agente dovrebbe fare. Quando viene fornita, genera le istruzioni generate.

goal?: string

Valore della proprietà

string

kind

Tipo di agente. Sempre voice.

kind: "voice"

Valore della proprietà

"voice"

model

Identificatore di modello opzionale. Obbligatorio quando model_type è self_deployed; opzionale quando model_type è managed o omesso. Il servizio non inventa mai un nome di distribuzione del cliente.

model?: string

Valore della proprietà

string

model_type

Modalità inferenza opzionale. Quando viene omesso, il servizio di authoring utilizza managed. Quando fornito, usa managed oppure self_deployed.

model_type?: VoiceModelType

Valore della proprietà

VoiceModelType

name

Il nome unico che l'agente deve creare. Deve essere un nome di agente non vuoto simile al DNS.

name: string

Valore della proprietà

string

tools

Gli strumenti opzionali sono stati portati letteralmente sull'agente generato (vedi VoiceAgentTool).

tools?: VoiceAgentToolUnion[]

Valore della proprietà

VoiceAgentToolUnion[]

use_case

Un caso d'uso opzionale per l'authoring. Una stringa vuota è accettata.

use_case?: string

Valore della proprietà

string