Exécuter du code Python qui traite des fichiers dans des flux de travail d’agent avec Azure Logic Apps (préversion)

S’applique à : Azure Logic Apps (Standard)

Note

Cette fonctionnalité est en préversion et elle est soumise aux conditions d’utilisation supplémentaires des préversions de Microsoft Azure.

Dans les applications logiques standard, non seulement les flux de travail d’agent peuvent gérer les demandes de langage naturel via des interfaces de conversation à l’aide d’agents, mais également traiter des fichiers lorsque vous créez des outils d’agent avec les opérations de connecteur intégrées de l’interpréteur de code (session Python Container Apps). Ces opérations permettent au workflow de l’agent de générer et d’exécuter du code Python, de charger, de télécharger et de supprimer des fichiers. Du point de vue d’un scénario, l’agent peut recevoir des instructions, accepter des fichiers, générer et exécuter du code dans un environnement isolé et retourner des résultats utilisables, tels que des résumés, des prévisions ou d’autres transformations de données demandées, dans le même flux de travail.

Note

Cet article part du principe que vous utilisez un workflow d’agent et que vous utilisez les opérations Interpréteur de code à l’intérieur des outils d’agent afin que l’agent génère le code Python nécessaire.

L’exemple suivant montre un flux de travail avec une action d’agent nommée Sales Report Agent. L’agent peut utiliser un outil nommé Charger des données de vente pour exécuter les opérations Interpréteur de code nommées Charger le fichier et Exécuter du code Python.

Lorsque le flux de travail reçoit une requête HTTPS pour un fichier spécifié via le déclencheur de requête, l’action HTTP obtient le fichier demandé. L’agent a pour instruction de charger le fichier dans un pool de sessions Container Apps, de générer du code Python pour traiter le fichier et de retourner les résultats en fonction des instructions reçues :

Note

Vous pouvez utiliser les opérations Interpréteur de code (session Python Container Apps) en dehors d’une action d’agent ou dans des flux de travail non-agent dans une application logique Standard. Toutefois, vous devez fournir votre propre code Python pour l’action d’exécution de code Python. Dans ce cas, les opérations Interpréteur de code n’ont pas accès aux fonctionnalités d’agent fournies par le modèle IA lié à l’agent, qui incluent des interactions en langage naturel et du code généré par le modèle.

Votre flux de travail d’agent peut traiter des fichiers qui contiennent des données diverses ou fragmentées et ont des formats tels que CSV, Excel ou JSON, qui peuvent inclure des milliers à des millions de lignes. Toutefois, les données brutes nécessitent souvent un travail supplémentaire avant de pouvoir extraire des informations et des insights utiles, par exemple :

Nettoyage et transformation
Logique personnalisée pour extraire des insights
Visualisations ou résumés qui rendent les données exploitables

Ces tâches nécessitent souvent des étapes effectuées manuellement qui sont sujettes aux erreurs et qui prennent beaucoup de temps, en particulier pour les personnes qui n’ont pas d’expertise en science des données ou en ingénierie. Votre flux de travail peut utiliser les opérations Interpréteur de code (session Python Container Apps) pour automatiser ces tâches et apporter des fonctionnalités d’interpréteur de code en mode natif et directement au runtime Azure Logic Apps. L’opération qui exécute du code Python est alimentée par le pool de sessions Azure Container Apps. Les sessions dynamiques dans Azure Container Apps offrent un accès rapide et évolutif à un interpréteur de code. Chaque session d’interpréteur de code est entièrement isolée par une limite Hyper-V et est conçue pour exécuter du code non approuvé. Lorsque vous activez l’isolation réseau sur votre conteneur d’applications, vos données ne quittent jamais les limites réseau définies.

Ces fonctionnalités rendent possibles des scénarios tels que les exemples suivants :

Scénario	Cas d’utilisation
Exploration des données	Les utilisateurs professionnels peuvent poser des questions sur les données à l’aide du langage naturel et sans écrire une seule ligne de code ou manipuler manuellement des feuilles de calcul et utiliser le langage naturel, par exemple : – « Trouve les 5 premiers produits par chiffre d’affaires ». – « Donne une prévision de la demande pour le trimestre suivant par région ». – « Mets en évidence les segments de clients en fonction des modèles d’achat ».
Operations	Nettoyez les fichiers journaux volumineux, faites ressortir les exceptions et générez des insights pour améliorer la fiabilité.
Finances	Analysez les rapports de dépenses, détectez les anomalies ou générez des répartitions trimestrielles à partir des exportations Excel.
Ventes et marketing	Chargez les données de ventes brutes et obtenez des résumés, des prévisions ou des comparaisons régionales à la demande.

Cet article explique comment configurer et utiliser différentes opérations Interpréteur de code (session Python Container Apps) dans votre workflow d’agent.

Prerequisites

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.
Une application conteneur et un pool de sessions d’interpréteur de code dans Azure Container Apps.
- Pour créer l’application, consultez Démarrage rapide : Déployer votre première application conteneur à l’aide du portail Azure. Pour vous assurer que vos données ne quittent jamais votre réseau, activez l’isolation réseau sur votre application conteneur.
  
  Pour plus d’informations, consultez les articles suivants :
  - Environnements d’applications Azure Container
  - Mise en réseau dans un environnement Azure Container Apps
- Pour créer le pool de sessions, consultez Créer des pools de sessions dans Azure Container Apps. Vous pouvez utiliser le portail Azure ou Azure CLI.
  
  Important
  
  Pour le type de pool de sessions, veillez à sélectionner Interpréteur de code Python.
- Facultatif : vous pouvez charger le fichier dans la session à l’aide du portail Azure ou envoyer une requête HTTPS. Vous pouvez ensuite référencer le fichier en tant que source de données dans le code Python. Pour plus d’informations, consultez Charger un fichier – Sessions d’interpréteur de code serverless dans Azure Container Apps. Sinon, vous pouvez utiliser l’action Charger le fichier à partir du connecteur Interpréteur de code (session Python Container Apps).
  
  Note
  
  Pour gérer des fichiers ou exécuter du code dans le pool de sessions, vérifiez que vous disposez du rôle intégré Azure nommé Exécuteur de session Azure ContainerApps sur le pool de sessions. Pour cette tâche, consultez Donner à l’identité l’accès aux ressources.
  
  Pour charger le fichier via le portail Azure, procédez de la manière suivante :
  1. Dans le portail Azure, ouvrez votre ressource de pool de sessions d’interpréteur de code.
  2. Dans la barre latérale des ressources, sélectionnez Terrain de jeu.
  3. Dans la barre d’outils Terrain de jeu, sélectionnez Gérer les fichiers.
    
    L’exemple suivant montre la commande Gérer les fichiers dans la barre d’outils Terrain de jeu :
  4. Dans le volet Gérer les fichiers, sélectionnez Charger un fichier et indiquez le fichier à charger.
Ressource d’application logique standard et flux de travail d’agent. Veillez à configurer une connexion entre l’action Agent par défaut et un modèle IA à utiliser pour la génération de code.

Pour créer ce flux de travail, consultez Créer des flux de travail qui utilisent des agents et des modèles IA pour effectuer des tâches dans Azure Logic Apps.

Note

Les flux de travail de l’agent doivent commencer par le déclencheur de requête. Le connecteur Interpréteur de code (session Python Container Apps) fournit des actions, mais pas des déclencheurs.

Référence technique du connecteur

Pour obtenir des informations techniques sur les opérations de ce déclencheur, consultez la documentation de référence du connecteur.

Charger un fichier

Dans le portail Azure, ouvrez votre ressource d’application logique Standard.
Dans la barre latérale des ressources, sous Flux de travail, sélectionnez Flux de travail, puis sélectionnez votre flux de travail d’agent.
Dans la barre latérale du flux de travail, sous Outils, sélectionnez le concepteur pour ouvrir le flux de travail.
Dans l’action Agent par défaut, suivez les étapes générales pour créer un outil et ajouter l’action Interpréteur de code (session Python Container Apps) nommée Charger le fichier.
Si vous êtes invité à créer une connexion, dans le volet Créer une connexion, fournissez les informations de connexion pour le pool de sessions.

Dans le volet d’informations d’action, développez Fichiers d’entrée à charger et fournissez les valeurs suivantes :

Paramètre	Valeur	Descriptif
Nom du fichier d’entrée	< nom de fichier>	Nom à attribuer pour le fichier.
Contenu du fichier d’entrée	< fichier-contenu>	Chemin d’accès pour le chargement du contenu du fichier.

Dans l’exemple suivant, le flux de travail utilise une action HTTP, qui effectue un appel REST pour obtenir le fichier à partir de son emplacement source. L’action de l’agent a un outil qui utilise l’action Charger le fichier avec le nom de fichier et le contenu en tant que paramètres. Le nom de fichier est une entrée manuelle, tandis que le contenu du fichier fait référence à la sortie de l’action HTTP précédente :

Si vous avez plus de fichiers à charger, sélectionnez Ajouter un nouvel élément.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.