Gérer les entrées et les sorties de sujet

Note

Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.

Les rubriques peuvent avoir des paramètres d’entrée et de sortie. Lorsqu’une rubrique redirige vers une autre rubrique, vous pouvez utiliser ces paramètres pour transmettre des informations entre les rubriques.

Si votre agent utilise l’orchestration générative, il peut automatiquement remplir les entrées avant d’exécuter un sujet en utilisant le contexte de la conversation ou générer des questions pour demander les valeurs à l’utilisateur. Ce comportement est similaire à la façon dont le remplissage génératif des emplacements fonctionne pour les outils.

Les agents utilisant l’orchestration générative peuvent générer une réponse contextuelle comme sortie de sujet. Dans ce cas, vous n’avez pas besoin de configurer un message textuel à partir de la rubrique elle-même.

Les entrées et sorties thématiques peuvent partager des valeurs avec d’autres sujets et outils dans le même plan généré.

Ajouter des entrées et des sorties

Pour ajouter des entrées ou sorties pour un sujet, sélectionnez Détails dans la barre d’outils en haut de la toile d’auteur. Sinon, sélectionnez Détails dans le menu contextuel d’un sujet sur la page de la liste des sujets .

Dans le panneau Détails du sujet , vous pouvez sélectionner l’onglet Entrées ou Sorties , puis sélectionner Créer une nouvelle variable pour créer de nouvelles variables d’entrée ou de sortie.

Pour chaque paramètre d’entrée et de sortie, vous devez saisir un nom, sélectionner un type de données et saisir une description pour la variable correspondante.

Si votre agent utilise l’IA générative pour décider comment répondre aux utilisateurs, davantage de propriétés sont disponibles pour les variables d’entrée. Plus précisément, comment l’agent remplira-t-il cette entrée ? Détermine comment l’agent remplit cette variable avec une valeur avant d’exécuter le sujet. Par défaut, chaque entrée est définie sur Remplir dynamiquement avec la meilleure option. L’agent tente d’obtenir la valeur à partir du contexte disponible, comme le message de l’utilisateur ou la conversation précédente. Si aucune valeur appropriée n’est trouvée, l’agent génère une question à poser à l’utilisateur pour obtenir une valeur. Vous pouvez choisir de remplacer une entrée par une valeur au lieu de demander à l’utilisateur. Pour remplacer un paramètre d’entrée, sélectionnez Définir comme valeur, sous Comment l’agent remplira-t-il cette entrée ?, puis entrez la valeur souhaitée. Cette valeur peut être une valeur littérale, une variable existante ou une formule Power Fx.

Pour garantir que votre agent capture le type de valeur correct pour l’entrée, vous devez également spécifier un type d’entité sous Identifier comme.

Capture d’écran du volet Détails avec une nouvelle variable d’entrée ajoutée

Des paramètres supplémentaires peuvent être configurés pour les entrées pour contrôler le comportement de l’agent lorsqu’il demande une valeur ou valide une réponse de l’utilisateur.

L’un de ces paramètres, « Devrait inviter l’utilisateur », n’est disponible que pour les entrées de sujets. Il détermine si l’agent doit essayer de remplir la variable avec une valeur avant d’exécuter la rubrique. Cette propriété est sélectionnée par défaut.