Utiliser des variables d’entrée et de sortie pour transmettre des informations

Utilisez des variables comme paramètres d’entrée et de sortie pour transmettre des informations entre les flux d’assistant et les assistants Copilot Studio.

Important

Un agent peut uniquement recevoir jusqu’à 1 Mo de données d’un flux dans une seule action. Cependant, il n’y a pas de limite au nombre de variables ou à la quantité de données qu’un assistant peut envoyer.

Dans cet exemple, vous créez un flux avec un paramètre d’entrée et le renvoyez à un assistant en tant que paramètre de sortie.

Configuration requise

• Comprendre comment créer un flux à partir du canevas de création Copilot Studio

Types de paramètres pris en charge

Les assistants Copilot Studio prennent en charge les types de paramètres d’entrée et de sortie suivants pour les flux d’assistant :

• Chiffre
• Chaîne
• Booléenne

Les types de données suivants ne sont pas pris en charge :

• Objet
• Date
• Horodateur
• Liste [Chaîne]
• Liste [Nombre]
• Liste [Booléen]
• Liste [Objet]
• Liste [Date]
• Liste [Horodatage]

Créer une rubrique et un flux

1. Accédez à la page Rubriques pour votre agent.

2. Créez un nouveau sujet appelé Message écho.

3. Ajoutez la phrase déclencheur écho.

4. Ajoutez un nœud Question et entrez le message « Dites-moi quelque chose et je vous le redirai. »

5. Pour Identifier, sélectionnez Réponse complète de l’utilisateur.

6. Pour Enregistrer la réponse de l’utilisateur sous, renommez la variable en userResponse.

   

7. Sélectionnez l’icône Ajouter un nœud sous le nœud Question et sélectionnez Ajouter un outil.

8. Dans l’onglet Actions de base, sélectionnez Nouveau flux d’agent. L’onglet Concepteur de flux d’agent s’ouvre avec un modèle de départ pour un flux d’agent appelé par un agent. Le flux inclut deux actions : Quand un agent appelle le flux et Répondre à l’agent.

9. Sélectionnez Publier pour enregistrer le flux avant d’apporter des modifications. Une notification s’affiche lorsque la création du flux est réussie.

10. Sélectionnez Revenir à l’assistant pour revenir à votre rubrique. Un nouveau nœud Action est ajouté à votre rubrique pour le flux.

11. Sélectionnez Enregistrer pour terminer l’ajout du flux en tant qu’outil à votre assistant.

Modifier les détails du flux

1. Sur le nœud Action avec le flux, sélectionnez le lien Afficher les détails du flux pour revenir au flux de l’assistant.

2. Dans l’onglet Vue d’ensemble du flux, modifiez les détails du flux, en remplaçant le nom par Paramètre Echo. Cliquez sur Enregistrer.

3. Revenez à l’onglet Concepteur.

Ajouter un paramètre d’entrée au flux

1. Sélectionnez le déclencheur de flux Quand un agent appelle le flux et sélectionnez Ajouter une entrée.

2. Sélectionnez Texte et entrez le nom String_Input.

   

Ajouter un paramètre de sortie au flux

1. Sélectionnez l’action de réponse Répondre à l’agent et sélectionnez + Ajouter une sortie.

2. Sélectionnez Texte et entrez le nom String_Output.

   

3. Pour la valeur, entrez une barre oblique (/) dans la zone, sélectionnez Insérer du contenu dynamique, puis sélectionnez la variable String_Input.

4. Sélectionnez Enregistrer le brouillon et Publier. Copilot Studio vous informe lorsque le flux de l’assistant est publié.

5. Sélectionnez Revenir à l’agent pour revenir à l’éditeur de rubriques de l’agent. Le nouveau flux d’action est ajouté à la rubrique.

Appeler le flux à partir de la rubrique

1. Sélectionnez le nouveau nœud d’action.

2. Définissez le paramètre d’entrée du flux sur la variable de sortie du nœud Question : String_Input (chaîne) obtient sa valeur de la variable userResponse.

   

3. Ajoutez un nœud Message.

4. Sélectionnez Insérer une variable, puis sélectionnez String_Output.

   

5. Cliquez sur Enregistrer.

6. Testez votre assistant.

   

Contenu associé

• Vue d’ensemble des variables