Exécuter des workflows d’automatisation à partir d’actions dans des agents avec Azure AI Foundry et Azure Logic Apps (préversion)

S’applique à : Azure Logic Apps (Consommation)

Lorsque vous disposez d’une application IA dans Azure AI Foundry qui doit automatiser des processus en plusieurs étapes ou s’intégrer à différents services, systèmes, applications et sources de données, vous pouvez ajouter des actions dans des agents pour exécuter des workflows d’automatisation dans Azure Logic Apps.

Dans Azure AI Foundry, un agent utilise une action et un modèle IA pour effectuer de manière autonome ou interactive une tâche. Par exemple, les agents utilisent des actions pour répondre aux questions, obtenir des informations et effectuer d’autres travaux à l’aide de modèles IA.

Dans Azure Logic Apps, un workflow d’application logique automatise les processus et peut intégrer Azure, Microsoft et services, systèmes, applications et sources de données dans d’autres écosystèmes, généralement sans code supplémentaire. Le flux de travail utilise un déclencheur et des actions prédéfinis à partir d’une galerie avec 1 400 connecteurs, ainsi que des opérations natives ou intégrées au runtime.

Le diagramme suivant montre comment une action sur un agent dans Azure AI Foundry est liée à un flux de travail d’application logique dans Azure Logic Apps :

Ce guide explique comment ajouter une action à un agent dans Azure AI Foundry pour que l'agent crée un flux de travail d'application logique Consommation fonctionnant dans les Logic Apps multientité d'Azure. Un assistant vous guide à travers les étapes pour configurer cette action avec un workflow d'application logique prédéfini. Une fois l’action ajoutée, vous pouvez étendre ce flux de travail, en fonction des besoins de votre scénario, à l’aide du concepteur graphique dans Azure Logic Apps.

Pour plus d’informations, consultez la documentation suivante :

• Qu’est-ce qu’Azure AI Foundry ?
• Qu’est-ce qu’Azure Logic Apps ?
• Flux de travail d’application logique de Consommation - Options Hosting

Conditions préalables

• Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.

• Un projet Azure AI Foundry, créé avec un hub par défaut.

  Ce projet organise votre travail et enregistre l’état pendant la génération de vos applications IA. Le hub héberge votre projet et fournit un environnement de collaboration d’équipe.

  Pour créer un projet avec un hub, vous avez besoin de l’un des rôles suivants pour le contrôle d’accès en fonction du rôle Microsoft Entra (RBAC), en fonction du principe du privilège minimum :

  • Contributeur (privilège minimum)

  • Propriétaire

  Si vous avez un autre rôle, il est nécessaire de faire créer le hub pour vous. Pour plus d’informations, consultez la documentation suivante :

  • Rôles par défaut pour les projets

  • Rôles par défaut pour les hubs

• Modèle de service Azure OpenAI déployé pour votre projet.

  Si vous n’avez pas de modèle déployé, consultez Déployer un modèle.

• Agent dans votre projet.

  Cette exigence inclut le déploiement d’un modèle dans Azure OpenAI Service pour que l’agent utilise pendant l’exécution du flux de travail.

Puis-je créer et utiliser mes propres flux de travail en tant qu’actions ?

Oui, pour rendre vos propres flux de travail d’application logique disponibles via la galerie d’actions dans le portail Azure AI Foundry, vos flux de travail doivent répondre aux exigences suivantes :

• La ressource d’application logique qui contient le flux de travail utilise l’option d’hébergement Consommation .

• La ressource d’application logique utilise le même abonnement Azure que celui que vous utilisez avec Azure AI Foundry.

• Le flux de travail commence par le déclencheur nommé Lorsqu’une requête HTTP est reçue.

• Le déclencheur inclut une description, que vous fournissez dans le volet d’informations du déclencheur dans le concepteur de flux de travail.

• Le flux de travail se termine par l’action Réponse.

Votre application IA offre des options presque infinies pour l’exécution de flux de travail qui interagissent avec Azure, Microsoft et d’autres services ou produits, ainsi que des opérations qui vous aident à gérer, à mettre en forme, convertir et transformer des données. Si aucun connecteur prédéfini n’existe pour ce que vous souhaitez faire, vous pouvez également créer votre propre connecteur.

Pour plus d’informations, consultez la documentation suivante :

• Démarrage rapide : Créer un exemple de flux de travail d’application logique Consommation à l’aide du portail Azure
• Qu’est-ce que des connecteurs dans Azure Logic Apps
• Connecteurs managés qui s’exécutent dans Azure global et multitenant
• Informations de référence techniques sur les connecteurs managés pour Azure Logic Apps
• Opérations intégrées qui s’exécutent avec le runtime Azure Logic Apps
• Connecteurs personnalisés dans Azure Logic Apps

Limitations et problèmes connus

Cette version présente les limitations suivantes ou les problèmes connus :

Ajoutez une action à votre agent

Suivez ces étapes pour configurer une action pour que votre agent crée et exécute un flux de travail d’application logique.

1. Connectez-vous au portail Azure AI Foundry et ouvrez votre projet.

2. Dans la vue d’ensemble de votre projet, dans le menu de navigation du portail, sous Générer et personnaliser, sélectionnez Agents. Dans la page Agents , sous Mes agents, sélectionnez votre agent.

   

3. Dans la section Configuration en regard de la liste des agents, faites défiler vers le bas jusqu’à la section Actions , puis sélectionnez Ajouter.

   

4. Dans la fenêtre Ajouter une action , sélectionnez Azure Logic Apps.

   

5. Sous Sélectionner une action, sélectionnez une action prédéfinie avec l’une des étiquettes suivantes :

   Étiquette d’action	Descriptif
   Écrit par Microsoft	Cette action utilise un modèle créé par Microsoft pour créer le flux de travail de l’action.
   Flux de travail	Cette action utilise un flux de travail d’application logique éligible dans votre abonnement Azure comme modèle pour créer le flux de travail pour l’action. Remarque : Si vous sélectionnez cette option, passez à la section intitulée Détails de l’action Confirmer. Si vos flux de travail n’apparaissent pas comme prévu dans la galerie d’actions, vérifiez les exigences.

   L’exemple suivant utilise l’action créée par Microsoft nommée Get Weather forecast for today via MSN Weather :

   

6. Dans la fenêtre d’action Ajouter une application logique , sous Entrer des informations de base, fournissez les informations suivantes :

   Paramètre	Obligatoire	Valeur	Descriptif
   Nom de votre action	Oui	< action-name>	Nom d’action convivial, axé sur la tâche, commençant par un verbe. Ce nom est également utilisé pour la ressource d’application logique et le flux de travail dans Azure Logic Apps. Remarque : - Le nom de l’action ne peut utiliser que des lettres, des chiffres et les caractères spéciaux suivants : -, (, ), _ou '. - Vous ne pouvez pas utiliser d’espaces blancs ou d’autres caractères spéciaux. - Une ressource d’application logique de consommation et un flux de travail sont combinés et ont une relation 1:1, de sorte qu’ils utilisent le même nom. Par comparaison, une ressource d’application logique standard peut avoir plusieurs flux de travail qui utilisent différents noms. Cet exemple utilise Get-weather-forecast-today.
   Description de votre action	Oui	< action-description>	Description qui décrit clairement l’objectif de l’action. Cet exemple utilise Cette action crée un flux de travail d’application logique de Consommation joignable qui récupère les prévisions météorologiques du jour et s’exécute dans Azure Logic Apps multilocataire global.
   Abonnement	Oui	< abonnement-Azure>	L’abonnement Azure à utiliser, probablement identique à votre projet et à votre modèle.
   Groupe de ressources	Oui	< Groupe de ressources Azure>	Groupe de ressources Azure à utiliser.
   Lieu	Oui	< Région Azure>	Région Azure où héberger la ressource et le flux de travail de l’application logique.

   La capture d’écran suivante montre les exemples de détails de l’exemple d’action Get-weather-forecast-today :

   

7. Lorsque vous avez terminé, sélectionnez Suivant.

Créer et authentifier des connexions

Suivez ces étapes pour créer toutes les connexions dont l’action a besoin et authentifier l’accès aux services, systèmes, applications ou sources de données appropriés. Le modèle sous-jacent spécifie les connecteurs à utiliser pour cette action et le flux de travail de l’application logique.

1. Dans la fenêtre d’action Ajouter une application logique , sous Authentifier, passez en revue les connexions que vous devez créer et authentifier.

2. Dans la colonne Connexion , sélectionnez Se connecter pour le service ou la source de données associé.

   La capture d’écran suivante montre l’exemple de connexion à créer et à authentifier pour le service MSN Weather :

   

   Certaines connexions nécessitent plus de détails. Suivez les invites pour fournir les informations demandées.

3. Pour chaque connexion requise, répétez ces étapes.

4. Lorsque vous avez terminé, sélectionnez Suivant.

Confirmer les détails de l’action

Vérifiez que toutes les informations d’action s’affichent correctement. Si vous avez sélectionné une action créée par Microsoft, passez en revue et consentez à la déclaration de reconnaissance.

1. Dans la fenêtre d’action Ajouter une application logique , sous Ressource, vérifiez toutes les informations d’action fournies.

2. Pour une action créée par Microsoft sélectionnée, procédez comme suit :

   1. Vérifiez l’instruction que vous acceptez et prenez connaissance des événements suivants qui se produisent après avoir quitté la page Ressource en sélectionnant Suivant :

      • Vous ne pouvez pas revenir aux étapes précédentes.

      • L’action crée une ressource d’application logique de Consommation.

      • La connexion à Azure Logic Apps entraîne des frais dans votre compte Azure.

        Pour plus d’informations sur le modèle de facturation des flux de travail d’application logique Consommation, consultez la documentation suivante :

        • Contrôle, facturation et tarification de l’utilisation

        • Tarification d’Azure Logic Apps (Plan de consommation - Multilocataire)

   2. Pour donner votre consentement, sélectionnez la zone de confirmation, par exemple :

      

3. Lorsque vous êtes prêt, sélectionnez Suivant

Terminer la création de l’action

Pour la dernière étape, passez en revue les informations générées par le portail sur l’outil utilisé par l’agent pour exécuter votre action et authentifier l’accès à n’importe quel service ou ressources Azure, Microsoft et non-Microsoft appropriés.

1. Dans la fenêtre d’action Ajouter une application logique , dans la page Schéma , passez en revue les informations suivantes et veillez à fournir une description des circonstances pour appeler l’outil :

   Paramètre	Descriptif
   Nom de l’outil	Nom modifiable de l’outil utilisé par l’agent pour exécuter votre action et accéder à Azure, Microsoft, services externes, sources de données ou modèles IA spécialisés afin que l’agent puisse obtenir des données, exécuter des tâches et interagir avec d’autres plateformes. Remarque : - Le nom de l’action ne peut utiliser que des lettres, des chiffres et le caractère de soulignement (_). - Vous ne pouvez pas utiliser d’espaces blancs ou d’autres caractères spéciaux.
   Connexion pour l’authentification	Nom en lecture seule de la connexion utilisée par l’agent pour accéder aux ressources Azure, Microsoft et externes sans avoir à demander des informations d’identification à chaque fois. Pour plus d’informations, consultez Connexions dans le portail Azure AI Foundry.
   Décrire comment appeler l’outil	Description qui spécifie les circonstances pour lesquelles l’agent appelle l’outil.
   Schéma	Schéma du flux de travail de l’application logique au format JSON (JavaScript Object Notation).

   

2. Quand vous êtes prêt, sélectionnez Créer.

   Le portail vous renvoie à la page Agents de votre agent sélectionné. Dans la section Configuration , la section Actions affiche maintenant le nom de l’outil qui exécute votre action et affiche l’icône d’Azure Logic Apps en regard du nom de l’outil, par exemple :

   

Tester l’action de l’agent

Pour essayer la nouvelle action de votre agent à l’aide du terrain de jeu Agents, procédez comme suit :

1. Dans la page Agents , en haut de la section Configuration , sélectionnez Essayer dans le terrain de jeu.

2. Sur la page Terrain de jeu des agents, dans la zone de conversation de requête de l’utilisateur, posez une question sur la météo, par exemple :

   Quelle est la météo à Londres ? Affichez les résultats au format de liste à puces.

   L’agent retourne une réponse similaire à l’exemple suivant :

   

Passer en revue l’application logique sous-jacente et le flux de travail

Une fois l’action exécutée, vous pouvez afficher la ressource d’application logique sous-jacente et le flux de travail dans le portail Azure. Vous pouvez consulter l’historique des exécutions du flux de travail, que vous pouvez utiliser pour déboguer ou résoudre les problèmes que le flux de travail peut rencontrer.

1. Connectez-vous au portail Azure. Dans la zone de recherche de la barre de titre du portail, entrez le nom de l’action que vous avez créée.

2. Dans la liste des résultats, sous Ressources, sélectionnez la ressource d’application logique.

   

3. Pour afficher l’historique des exécutions du flux de travail, les entrées, les sorties et d’autres informations, dans le menu de l’application logique, sous Outils de développement, sélectionnez Historique des exécutions.

4. Dans la liste de l’historique des exécutions, sélectionnez la dernière exécution du flux de travail, par exemple :

   

5. Une fois l’affichage de surveillance ouvert et affiche l’état de chaque opération dans le flux de travail, sélectionnez une opération pour ouvrir le volet d’informations et examiner les entrées et sorties de l’opération.

   Cet exemple sélectionne l’action nommée Obtenir la prévision pour aujourd’hui, par exemple :

   

   Pour plus d’informations sur l’historique des exécutions de flux de travail, consultez Afficher l’état du flux de travail et l’historique des exécutions.

Ouvrir le flux de travail dans le concepteur

Suivez ces étapes pour passer en revue la définition et les opérations de flux de travail, ou modifiez le flux de travail en ouvrant le concepteur de flux de travail.

1. Dans le menu de l’application logique, sous Outils de développement, sélectionnez le concepteur.

   Le flux de travail s’ouvre dans le concepteur. Vous pouvez maintenant passer en revue les opérations du flux de travail, qui font référence au déclencheur et aux actions, par exemple :

   

2. Pour afficher les paramètres et les réglages d’une opération, dans le concepteur, sélectionnez l’opération, par exemple :

   

3. Pour développer le comportement du flux de travail, vous pouvez ajouter d’autres actions en suivant les étapes décrites dans Générer un flux de travail avec un déclencheur ou une action.

   Pour que ce flux de travail ou tout autre flux de travail s’affiche dans la galerie d’actions et s’exécute en tant qu’action dans un agent, le flux de travail doit toujours répondre aux exigences suivantes :

   • La ressource d’application logique qui contient le flux de travail doit utiliser l’option d’hébergement Consommation.

   • La ressource d’application logique doit utiliser le même abonnement Azure que celui que vous utilisez avec Azure AI Foundry.

   • Le flux de travail doit commencer par le déclencheur Lorsqu’une requête HTTP est reçue.

   • Le déclencheur nécessite une description, que vous pouvez trouver dans le volet d’informations du déclencheur dans le concepteur.

   • Le flux de travail doit se terminer par l’action Réponse.

   Avertissement

   Bien que vous puissiez ajouter des actions et modifier le flux de travail, ne modifiez pas le déclencheur d’origine et les actions pour éviter de rompre la relation entre le flux de travail, l’agent et l’action. Leurs paramètres sont configurés pour fonctionner ensemble, de sorte que les modifications apportées à ces opérations présentent le risque de rupture de l’action dans l’agent. Au lieu de cela, envisagez de créer une version personnalisée ou un autre flux de travail que vous pouvez ajouter en tant qu’action à un agent.

   Par exemple, le déclencheur utilise les paramètres suivants, qui sont nécessaires pour appeler le déclencheur :

   Paramètre	Descriptif
   Nom	Ce nom fait partie de l’URL HTTPS du déclencheur. Les appelants externes, tels que d’autres services, en dehors du flux de travail envoient une requête HTTPS à cette URL, ce qui déclenche le déclencheur et démarre le flux de travail. Le déclencheur est toujours la première étape d’un flux de travail et spécifie la condition à respecter pour que le déclencheur s’exécute.
   HTTPS URL	Lorsque le flux de travail est enregistré pour la première fois, cette URL est générée et utilisée pour appeler un point de terminaison que le déclencheur crée pour le flux de travail.
   Méthode	Ce paramètre spécifie si le déclencheur accepte toutes ou uniquement les méthodes HTTPS spécifiques.
   Schéma JSON du corps de la demande	Si vous souhaitez valider l’entrée que le déclencheur s’attend à recevoir dans la requête HTTPS envoyée par des appelants externes, ce schéma spécifie le schéma JSON à utiliser pour valider cette entrée.

4. Pour enregistrer les modifications que vous apportez, dans la barre d’outils du concepteur, sélectionnez Enregistrer.

Tester un flux de travail dans le concepteur

Si vous avez apporté des modifications au flux de travail météo ou pour tester un autre flux de travail, procédez comme suit :

1. Dans la barre d’outils du concepteur, sélectionnez Exécuter>avec la charge utile.

2. Une fois le volet Exécuter avec charge utile ouvert, dans le champ Corps , fournissez les entrées de déclencheur attendues au format JSON, par exemple :

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. Lorsque vous êtes prêt, sélectionnez Exécuter.

   Sous l’onglet Sortie , le corps de la réponse contient les résultats et la réponse du flux de travail.

4. Si votre exécution de flux de travail génère des erreurs ou nécessite une résolution des problèmes, ouvrez l’historique des exécutions du flux de travail afin de pouvoir examiner les entrées et sorties de chaque opération en suivant les étapes pertinentes de l’application logique et du flux de travail sous-jacents.

Facturation et tarification

Les flux de travail d’application logique de Consommation entraînent des frais basés sur le modèle de facturation de l’« utilisateur-payeur ». Pour plus d’informations sur ce modèle, consultez les ressources suivantes :

• Contrôle, facturation et tarification de l’utilisation
• Tarification d’Azure Logic Apps (Plan de consommation - Multilocataire)

Pour Azure AI Foundry, consultez les ressources suivantes :

• Planifiez et gérez les coûts pour Azure AI Foundry
• Tarification d’Azure AI Foundry

Nettoyer les ressources

Si vous n’avez pas besoin des ressources que vous avez créées pour ce guide, supprimez les ressources afin de ne pas continuer à être facturées. Vous pouvez suivre ces étapes pour supprimer le groupe de ressources qui contient ces ressources, ou supprimer chaque ressource individuellement.

1. Dans le portail Azure AI Foundry, pour supprimer l’action de l’agent, à côté du nom de l’action, sélectionnez le bouton des points de suspension (...), puis Supprimer.

2. Dans la zone de recherche dans la barre de titre du portail Azure , entrez des groupes de ressources et sélectionnez Groupes de ressources.

3. Recherchez le groupe de ressources qui contient vos ressources hub déployées.

4. Dans la barre d’outils de la page Vue d’ensemble, sélectionnez Supprimer un groupe de ressources.

5. Dans le volet de confirmation, entrez le nom du groupe de ressources, puis sélectionnez Supprimer.

Contenu connexe

• Qu’est-ce que les connecteurs dans Azure Logic Apps ?
• Qu’est-ce qu’Azure AI Foundry ?
• Qu’est-ce qu’Azure Logic Apps ?