Ajouter la fonctionnalité d’interpréteur de code à votre agent

Vous pouvez améliorer l’expérience utilisateur de vos agents déclaratifs pour Microsoft 365 Copilot en ajoutant la fonctionnalité d’interpréteur de code. L’élément Fonctionnalités dans la référence du manifeste et la section Fonctionnalités dans le générateur d’agent offrent plusieurs options pour vous permettre de déverrouiller des fonctionnalités pour vos utilisateurs.

Code Interpreter est un outil avancé conçu pour résoudre des tâches complexes via du code Python. Il utilise le modèle de raisonnement pour écrire et exécuter du code, ce qui permet aux utilisateurs de résoudre des problèmes mathématiques complexes, d’analyser des données, de générer des visualisations, etc. Une fois le code exécuté, l’interpréteur de code génère les résultats et le code associé. Il peut également produire des images ou des fichiers téléchargeables en fonction du scénario, et accepte les fichiers comme entrée pour la modification et l’analyse.

La fonctionnalité d’interprète de code est disponible pour les utilisateurs disposant d’une licence Microsoft 365 Copilot et les utilisateurs de Copilot Chat sans utilisation mesurée activée.

Remarque

L’interpréteur de code est activé par défaut pour les agents en contexte. Pour modifier ce paramètre, sélectionnez l’icône Paramètres et mettez à jour le paramètre Interprète de code si nécessaire, comme illustré dans la capture d’écran suivante.

Activer l’interpréteur de code dans Microsoft 365 Agents Toolkit

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent et que vous souhaitez activer Code Interpreter, ajoutez la valeur à la propriété capabilities dans votre fichier manifeste, comme illustré dans l’exemple CodeInterpreter suivant.

Remarque

Vous devez utiliser la version 1.2 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter la CodeInterpreter fonctionnalité.

{
  "capabilities": [
    {
      "name": "CodeInterpreter"
    }
  ]
}

Activer l’interpréteur de code dans Agent Builder

L’interpréteur de code est toujours activé dans Agent Builder. Cette fonctionnalité est automatiquement incluse pour tous les agents.

Exemples de fonctionnalités d’interpréteur de code

La fonctionnalité d’interpréteur de code utilise le modèle de raisonnement pour permettre aux agents déclaratifs d’écrire et d’exécuter du code Python dans un environnement bac à sable. Cette fonctionnalité permet aux utilisateurs de résoudre des problèmes mathématiques complexes, d’analyser des données, de générer des visualisations, etc. Une fois le code exécuté, l’interpréteur de code génère les résultats et le code généré. Il peut également produire des images téléchargeables et d’autres fichiers en fonction du scénario et accepte les fichiers comme entrée pour la modification et l’analyse.

L’interpréteur de code fournit des fonctionnalités pour :

Copilot peut également fournir des versions copiables et téléchargeables du code qu’il génère lors de l’exécution de ces tâches.

Créer des graphiques et des diagrammes

Les utilisateurs peuvent utiliser des agents dont l’interpréteur de code est activé pour créer des graphiques et des tableaux. Par exemple, en réponse à l’invite Graphique les 20 premiers nombres d’une suite de Fibonacci, Copilot produit le graphique en courbes suivant.

Capture d’écran d’un graphique en courbes montrant les 20 premiers nombres d’une suite de Fibonacci.

Lorsque l’utilisateur sélectionne le </> Code bouton, l’agent fournit le code Python correspondant.

Capture d’écran du code Python permettant de représenter graphiquement les 20 premiers nombres d’une suite de Fibonacci.

Les utilisateurs peuvent également télécharger des fichiers de données pour générer des graphiques et des diagrammes afin de pouvoir visualiser leurs données. Les formats de fichiers pris en charge sont les suivants : Word, Excel, PowerPoint, PDF, CSV/TSV et TXT/UTF8. Par exemple, un utilisateur peut charger un fichier Excel avec des données de ventes et entrer l’invite : Créer un graphique à barres et un graphique linéaire de mes données de vente chargées. L’agent retourne la réponse suivante.

Graphique à barres d’exemples de données de ventes

Graphique en courbes d’exemples de données de ventes

Créer des codes QR et des visualisations de données

Lorsque l’interpréteur de code est activé, les utilisateurs peuvent créer diverses visualisations de données, telles que des codes QR et des nuages de mots. Par exemple, en réponse à l’invite utilisateur Créer un code QR pour le site web d’entreprise de Microsoft, l’agent présente à la fois l’URL correspondante et le code QR correspondant.

Code QR pour Microsoft généré par Copilot

Pour un nuage de mots, l’invite Créer un nuage de mots des principaux noms d’animaux génère une image qui inclut les noms les plus courants, comme illustré dans l’exemple suivant.

Réponse de Word Cloud à l’invite de l’utilisateur

Créer des données synthétiques

Lorsqu’un utilisateur a besoin d’exemples de données, l’intégration de l’interpréteur de code lui permet de créer des données synthétiques à diverses fins. L’agent peut générer les exemples de données demandés, puis les générer sous forme de fichiers Word, Excel, PowerPoint ou PDF. Les utilisateurs peuvent télécharger les fichiers générés directement à partir de la réponse de l’agent. Voici des exemples d’invites et de réponses.

Invite :Créez un tableau de 10 fausses transactions financières, y compris la date, le montant, le commerçant et la catégorie.

Tableau des transactions financières synthétiques.

Requête :Générez 20 transcriptions synthétiques du chat du service client sur les problèmes de facturation.

Tableau des discussions synthétiques du support client.

Résoudre des problèmes mathématiques complexes

Lorsque vous ajoutez un interpréteur de code à votre agent, les utilisateurs peuvent demander à votre agent de résoudre des problèmes mathématiques complexes, comme illustré dans l’exemple suivant.

Invite :Fournissez l’intégrale de l’aire sous la courbe pour la fonction ( f(x) = x^3 - 4x^2 + 6x - 2 ) de ( x = 0 ) à ( x = 3 ).

Calcul intégral de l’aire sous une courbe.

Modifier les images chargées

L’intégration de l’interpréteur de code permet également aux utilisateurs de modifier les images chargées. Les agents disposant de cette fonctionnalité peuvent ajouter des bannières et des légendes aux images et générer des versions en noir et blanc d’images couleur. (L’image suivante a été générée par Copilot.)

Image générée par Copilot d’une voiture Bentley 4 de 1934.

Pour modifier cette image, l’utilisateur peut entrer la requête Donnez-moi une version en noir et blanc de l’image jointe. Ajoutez une bannière indiquant « 1934 Bentley 4 » et une légende indiquant « Image générée par Copilot ». L’agent fournit le résultat suivant.

Image en noir et blanc d’une Bentley 4 de 1934, modifiée par Copilot.

Générer des fichiers téléchargeables

L’interpréteur de code peut générer et héberger des fichiers téléchargeables, ce qui permet à votre agent d’autoriser les utilisateurs à télécharger les fichiers générés par l’agent. Lorsque l’interpréteur de code produit des fichiers de sortie (tels que des images, des graphiques, des feuilles de calcul ou des documents), Copilot présente automatiquement un lien de téléchargement dans la réponse. Les utilisateurs peuvent sélectionner le lien pour enregistrer le fichier localement.

Cette fonctionnalité est utile dans de nombreux scénarios, par exemple :

  • Exportations de données : générez une feuille de calcul Excel de données calculées ou de résultats d’analyse et proposez-la en téléchargement.
  • Rapports : créez un PDF formaté ou Word document résumant les résultats et rendez-le disponible au téléchargement.
  • Visuels générés : produisez un graphique, un code QR ou un nuage de mots sous forme de fichier image téléchargeable.
  • Fichiers traités : appliquez des modifications à une image ou un document téléchargé et retournez le résultat sous forme de fichier téléchargeable.

L’exemple d’invite suivant déclenche la génération de fichiers et la création automatique de liens de téléchargement.

Invite :Créez une feuille de calcul avec une table de multiplication pour les nombres de 1 à 10 et donnez-moi le fichier Excel.

L’agent génère le fichier Excel et présente un lien de téléchargement dans la réponse.

Remarque

Les Files générés par Code Interpreter sont hébergés temporairement et ne peuvent être téléchargés que pendant la session active. Files ne sont pas conservés après la fin de la session.