GenerateVoiceAgentRequest interface

Package:

@azure/ai-projects

Les entrées pour générer un agent vocal. Seulement kind et name sont toujours obligatoires. Le service d’auteur développe ces entrées en un fichier complet et modifiable VoiceAgentDefinition, qui est ensuite créé via POST /agents. Les paramètres générés instructions et audio/voix sont stockés comme des champs séparés dans la définition d’agent obtenue, de sorte que l’appelant peut ensuite les modifier ou les remplacer via le versionnement standard de l’agent.

Propriétés

description	Une description optionnelle de l’agent. Le service d’auteur résout son plan de secours lorsqu’il est omis.
draft	(Aperçu) Lorsque true, l’agent vocal généré est créé sous forme de brouillon — une version éditable et non publiée que l’appelant peut consulter et affiner avant de la publier via le chemin standard de création/version. Le service se retrouve false par défaut si une valeur n’est pas spécifiée par l’appelant, auquel cas l’agent est créé et publié normalement.
goal	Une description optionnelle en langage naturel de ce que l’agent doit faire. Lorsqu’il est fourni, il sémente les instructions générées.
kind	Type d’agent. A toujours la valeur voice.
model	Identifiant de modèle optionnel. Obligatoire quand model_type est self_deployed; optionnel quand model_type est managed ou omis. Le service n’invente jamais de nom de déploiement client.
model_type	Mode d’inférence optionnel. Lorsqu’elle est omise, le service d’auteur utilise managed. Lorsqu’elle est fournie, utilisez managed ou self_deployed.
name	Le nom unique que l’agent doit créer. Ça doit être un nom d’agent non vide, de type DNS.
tools	Les outils optionnels sont portés mot pour mot sur l’agent généré (voir VoiceAgentTool).
use_case	Un cas d’utilisation optionnel pour l’authoring. Une chaîne vide est acceptée.

Détails de la propriété

description

Une description optionnelle de l’agent. Le service d’auteur résout son plan de secours lorsqu’il est omis.

description?: string

Valeur de propriété

string

draft

(Aperçu) Lorsque true, l’agent vocal généré est créé sous forme de brouillon — une version éditable et non publiée que l’appelant peut consulter et affiner avant de la publier via le chemin standard de création/version. Le service se retrouve false par défaut si une valeur n’est pas spécifiée par l’appelant, auquel cas l’agent est créé et publié normalement.

draft?: boolean

Valeur de propriété

boolean

goal

Une description optionnelle en langage naturel de ce que l’agent doit faire. Lorsqu’il est fourni, il sémente les instructions générées.

goal?: string

Valeur de propriété

string

kind

Type d’agent. A toujours la valeur voice.

kind: "voice"

Valeur de propriété

"voice"

model

Identifiant de modèle optionnel. Obligatoire quand model_type est self_deployed; optionnel quand model_type est managed ou omis. Le service n’invente jamais de nom de déploiement client.

model?: string

Valeur de propriété

string

model_type

Mode d’inférence optionnel. Lorsqu’elle est omise, le service d’auteur utilise managed. Lorsqu’elle est fournie, utilisez managed ou self_deployed.

model_type?: VoiceModelType

Valeur de propriété

VoiceModelType

name

Le nom unique que l’agent doit créer. Ça doit être un nom d’agent non vide, de type DNS.

name: string

Valeur de propriété

string

tools

Les outils optionnels sont portés mot pour mot sur l’agent généré (voir VoiceAgentTool).

tools?: VoiceAgentToolUnion[]

Valeur de propriété

VoiceAgentToolUnion[]

use_case

Un cas d’utilisation optionnel pour l’authoring. Une chaîne vide est acceptée.

use_case?: string

Valeur de propriété

string