Créer un flux d’agent en tant qu’outil

Apprenez à utiliser un flux de cloud dans Copilot Studio en donnant à un assistant la capacité de fournir des prévisions météorologiques sur demande. Dans ce premier exemple, vous créez un flux qui récupère une prévision météorologique. Dans l’exemple suivant, vous configurez une rubrique pour appeler le flux en tant qu’action afin que l’agent puisse répondre avec les prévisions lorsqu’un client pose des questions sur la météo.

Pour travailler en tant qu’outil avec des assistants, un flux d’assistant requiert les éléments suivants :

• Disposer du déclencheur Quand un agent appelle le flux et de l’action de réponse Répondre à l’agent.
• Être configuré pour répondre en temps réel, et non de manière asynchrone. Le bouton bascule Réponse asynchrone doit être définie sur Désactivé sous Mise en réseau dans les paramètres de l’action Répondre à l’agent.
• Répondez à l’agent dans la limite d’action de 100 secondes. Optimisez la logique de flux, les requêtes et la quantité de données renvoyées afin qu’une exécution typique soit inférieure à cette limite de 100 secondes. Les actions du flux qui doivent s’exécuter plus longtemps peuvent être placées après l’action Répondre à Copilot pour continuer à s’exécuter jusqu’à la limite de la durée d’exécution du flux de 30 jours. Pour obtenir des conseils sur la façon d’accélérer vos flux, consultez Accélérer l’exécution du flux d’assistant avec le mode express.

Lorsque vous créez un flux d’assistant dans Copilot Studio en tant qu’outil ajouté à un assistant, le déclencheur de flux et l’action de réponse requis sont ajoutés pour vous. Vous pouvez modifier un flux existant pour l’utiliser avec des agents en le mettant à jour pour utiliser ce déclencheur et cette action de réponse.

Configuration requise

• Accès à Copilot Studio avec une licence incluant l’utilisation de flux dans Copilot Studio.

Créer un flux que vous pouvez utiliser avec un assistant

Dans cet exemple, vous créez un flux qui récupère les prévisions météorologiques actuelles depuis MSN Weather. Vous ajoutez le flux en tant qu’outil à une rubrique d’assistant existante.

Ajouter un nouveau flux d’assistant vide à une rubrique et l’enregistrer

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

2. Ouvrez la rubrique à partir de laquelle vous souhaitez appeler un flux.

3. Sélectionnez l’icône Ajouter un nœud sous n’importe quel nœud, puis sélectionnez Ajouter un outil.

4. Dans l’onglet Outils de base, sélectionnez Nouveau flux d’agent.

   La page Flux d’assistant s’ouvre, avec un modèle de flux de démarrage affiché dans le concepteur de flux d’assistant pour modification. Le flux inclut le déclencheur requis Lorsqu’un assistant appelle le flux ainsi que l’action Répondre à l’assistant.

5. 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.

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

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

Ajouter des actions et configurer le flux

Une fois un modèle de base créé pour le flux et celui-ci ajouté au sujet de votre assistant, vous pouvez désormais revenir pour ajouter des actions à votre flux. Dans cet exemple, vous ajoutez une action qui récupère les prévisions actuelles de MSN Météo.

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 la page Vue d’ensemble, sous Détails, renommez le flux avec un nom explicite, par exemple « Obtenir les prévisions météo ».

3. Accédez au concepteur, sélectionnez le déclencheur de flux Quand un assistant appelle le flux et ajoutez les paramètres d’entrée suivants :

   • Ville (Texte)
   • Code postal (numéro)

4. Sélectionnez l’icône Ajouter sous le déclencheur de flux Quand un agent appelle le flux.

5. Dans Ajouter une action, recherchez « Météo MSN » et sélectionnez l’action Obtenir les prévisions du jour.

6. Dans le volet Obtenir les prévisions du jour, dans la zone Emplacement, entrez une barre oblique (/), sélectionnez Insérer du contenu dynamique, puis sélectionnez votre paramètre d’entrée Ville.

7. Procédez de la même manière pour ajouter votre paramètre d’entrée Code postal.

8. Dans l’action Répondre à l’agent, ajoutez les paramètres et variables de sortie suivants :

   Paramètre de sortie	Type	Variable
   day_summary	Texte	Résumé de la journée
   location	Texte	Emplacement
   chance_of_rain	Chiffre	Risque de pluie pendant la journée

   

9. Cliquez sur Publier. Une notification s’affiche lorsque la création du flux est réussie.

Pour continuer, suivez les instructions de la section Appeler un flux d’agent à partir d’un agent.

Gérer les connexions utilisées par le flux

Dans un agent authentifié pris en charge, les flux de cloud peuvent être configurés pour utiliser les informations d’identification de l’utilisateur lorsqu’ils sont exécutés dans le cadre d’un plan d’orchestration générative ou appelés à partir d’une rubrique. L’utilisation du flux dans un canal pris en charge ne nécessite aucune configuration spécifique dans votre assistant. Les clients peuvent gérer leurs connexions tout en utilisant l’agent.

Les flux de cloud dans les environnements utilisant des clés gérées par le client (CMK) ne peuvent pas encore être exécutés avec les informations d’identification du client dans le cadre de plans d’orchestration générative ou à partir de rubriques. Assurez-vous que les paramètres en exécution seule pour les flux de cloud dans les environnements CMK sont définis sur des connexions spécifiques au lieu de Fourni par l’utilisateur en exécution seule.

Contenu associé

• Appeler un flux en tant qu’action
• Utiliser des variables d’entrée et de sortie pour transmettre des informations
• Ajoutez l’authentification de l’utilisateur aux rubriques