Utiliser l’interpréteur de code dans une invite pour générer et exécuter du code Python

L’interpréteur de code dans Microsoft Copilot Studio et les invites générées par le constructeur donnent la possibilité aux créateurs de développer des agents IA qui :

• Exécuter du code Python pour l’analyse des données, le traitement des fichiers Word, Excel, PowerPoint et PDF, et la création de visualisations.
• Utilisent des modèles de langage pour les réponses génératives

Cette fonctionnalité est adaptée aux développeurs, aux analystes d’entreprise et aux développeurs low code. La génération et l’exécution du code s’intègrent en toute transparence à l’écosystème Copilot Studio pour créer des solutions puissantes basées sur l’IA.

Les développeurs doivent lire l’interpréteur Code pour les développeurs et passer en revue l’exemple de composant interpréteur Code Power Apps component Framework (PCF pour comprendre comment ils peuvent utiliser le message Dataverse Predict pour appeler des invites et traiter les réponses retournées.

Spécifications

• Licensing : Microsoft Copilot Studio facturation et licence. Nombre de génération et d’exécution de code en tant que fonctionnalités d’outils d’IA de texte et d’IA générative (Premium).

• Régions prises en charge : disponible pour tous les clouds publics. Les clouds souverains ne sont pas pris en charge actuellement.

Fonctionnalités de l’interpréteur de code

Les agents utilisant l’interpréteur de code peuvent écrire et exécuter Python code pour les tâches avancées. Les cas d’usage sont les suivants :

• Excel traitement des fichiers : créez, copiez et mettez à jour des feuilles de calcul Excel dans un classeur, lisez et appliquez des styles de cellule, copiez la mise en forme entre les cellules, copiez et mettez à jour les formules entre les cellules, etc.
• Traitement des fichiers Word et PowerPoint.
• Traitement des fichiers PDF : créez et copiez des fichiers PDF, lisez des tableaux et des paragraphes de texte.
• Traitement des données de table Dataverse.
• Calculs mathématiques et statistiques complexes.
• Analyse, manipulation et visualisation des données (par exemple, tableaux et graphiques).

L’interpréteur de code ajoute les fonctionnalités suivantes aux prompts :

• Prise en charge des fichiers en tant que type de sortie dans les invites.
• Prise en charge des fichiers Excel comme formats d'entrée et de sortie pour les invites.

Créez des invites de deux façons :

• Dans Power Apps : utilisez l’option Build your own prompt dans AI Hub.
• Dans Copilot Studio : ajoutez une invite en tant qu’outil au niveau de l’agent ou de la rubrique.

En savoir plus sur les invites dans l’aperçu des invites.

Vous pouvez également utiliser l’interpréteur de code dans la conversation de l’agent dans Copilot Studio.

Démarrez une nouvelle invite dans Power Apps AI Hub et activez l’interpréteur de code

Vous pouvez démarrer une nouvelle invite dans AI Hub dans Power Apps et activer l’interpréteur de code dans les paramètres de l’invite.

1. Accédez à Power Apps.

2. Sélectionnez AI Hub dans le volet gauche.

3. Sélectionnez Prompts.

   

4. Sélectionnez Créer votre propre invite.

   

5. Entrez un nom pour votre invite.

6. Dans la section Instructions , sélectionnez les trois points (...), puis sélectionnez Paramètres.

   

7. Dans Paramètres, activez l’interpréteur de code.

8. Fermez les paramètres pour revenir à l'éditeur de commandes.

L’éditeur d’invite est ouvert avec l’interpréteur de code activé. Ensuite, écrivez des instructions pour votre invite.

Lancez une nouvelle invite en tant qu’outil dans un agent et activez l’interpréteur de code.

Vous pouvez démarrer une nouvelle invite en tant qu’outil au sein d’un agent dans Copilot Studio et activer l’interpréteur de code pour cette invite.

1. Dans Copilot Studio, accédez à l’agent où vous souhaitez utiliser l’interpréteur de code.

2. Ajoutez une nouvelle invite à l’agent en tant qu’outil, soit au niveau de l’agent, soit au niveau de la rubrique.

   • Ajoutez une invite au niveau de l’agent :

     1. Accédez à la page Outils .

     2. Sélectionnez Ajouter un outil>Invite.

   • Ajoutez une invite au niveau de la rubrique :

     1. Accédez à la page Rubriques et sélectionnez la rubrique dans laquelle vous souhaitez ajouter l’invite.

     2. Sélectionnez Ajouter un nœud à la position de la rubrique dans laquelle vous souhaitez ajouter l’invite.

     3. Sélectionnez Ajouter un outil>Nouvelle invite.

   L’interface de création d’invite intégrée s’ouvre.

3. Dans la barre d’informations, sélectionnez les trois points (...), puis sélectionnez Paramètres.

   

4. Sur la page Paramètres, sélectionnez Activer l'interpréteur de code.

5. Fermez les paramètres pour revenir à l'éditeur de commandes.

L’éditeur d’invite est ouvert avec l’interpréteur de code activé. Ensuite, écrivez des instructions pour votre invite.

Écrire des instructions pour votre requête

Ensuite, vous pouvez écrire les instructions d’invite, configurer l’invite en fonction des besoins et enregistrer pour créer l’invite.

Apprenez-en davantage sur l’utilisation de l’interpréteur de code dans des invites dans des exemples d’invites d’interpréteur de code.

Meilleures pratiques pour l’interpréteur de code dans les invites

• Utilisez d’autres outils IA comme Copilot pour obtenir l’invite optimisée à démarrer.
• Utilisez des prompts précis avec des exemples (prompt à quelques captures).
• Spécifiez les sorties (par exemple, « Retour au format JSON » ou « Excel » ou « PDF »).

Limites

• L’analyse de plusieurs fichiers téléchargés dans une seule requête n’est pas prise en charge.
• Le renvoi de plusieurs sorties de fichier dans une seule invite n’est pas pris en charge.
• Le fait de poser des questions sur un fichier chargé en plusieurs étapes n'est pas supporté.
• Pour utiliser l’interpréteur de code, vous devez configurer votre agent, dans les paramètres de l’agent, pour utiliser l’authentification utilisateur. Par exemple, l'utilisation de Direct Line avec No authentication sélectionné ne fonctionne pas pour les scénarios utilisant l'interpréteur de code.

Résolution des problèmes

Si vous rencontrez des erreurs lors de l’utilisation de l’interpréteur de code, procédez comme suit :

1. Vérifiez que toutes les autorisations requises sont accordées. Vérifiez que le compte d’utilisateur et l’agent disposent des autorisations nécessaires pour exécuter des invites d’interpréteur de code.
2. Vérifiez la configuration des paramètres. Vérifiez que l’interpréteur de code est activé dans les paramètres d’invite et que votre agent est configuré pour utiliser l’authentification utilisateur.
3. Pour plus d’informations, consultez les journaux d’erreurs. Passez en revue les journaux d’erreurs dans Copilot Studio ou l’environnement Power Platform associé pour identifier la cause racine du problème et prendre des mesures correctives.

Informations connexes

• Utilisez un interpréteur de code pour analyser les données structurées
• Interpréteur de code pour les développeurs
• Exemple de composant PCF de l’interpréteur de code