Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Les éléments indiqués comme (aperçu) dans cet article sont en aperçu public. Cette préversion est fournie sans contrat de niveau de service. Nous vous déconseillons donc de l’utiliser dans des charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités contraintes. Pour plus d’informations, consultez Conditions d'utilisation supplémentaires pour les versions préliminaires de Microsoft Azure.
Utilisez l'Optimiseur de Prompts dans Microsoft Foundry pour améliorer automatiquement les instructions système de votre agent. Prompt Optimizer applique les meilleures pratiques d’ingénierie rapide pour restructurer, clarifier et améliorer vos instructions. Il fournit un raisonnement transparent au niveau du paragraphe pour chaque changement. Vous pouvez affiner de manière itérative les résultats en ajoutant des suggestions et en réoptimisant jusqu’à ce que vous soyez satisfait, puis appliquer la sortie finale en un seul clic.
Cet article explique comment utiliser Prompt Optimizer dans l'espace interactif du portail Foundry.
Conditions préalables
- Projet Foundry avec au moins un agent de commande ou un agent de workflow.
- Un déploiement de modèle dans une région prise en charge. La région de votre projet Foundry détermine la disponibilité des fonctionnalités.
- Accès au panneau de configuration de l’agent dans le portail Foundry.
Fonctionnement de Prompt Optimizer
Prompt Optimizer utilise un processus multistep qui combine votre entrée avec l’optimisation basée sur LLM :
Collection d’entrée : vous fournissez une description initiale de ce que votre agent doit faire (pour les nouveaux agents) ou ouvrir l’optimiseur avec des instructions existantes déjà en place. Si vous le souhaitez, vous pouvez fournir des suggestions supplémentaires pour guider l’optimisation (par exemple, « Avoir un ton professionnel » ou « Rendre l’enfant convivial »).
Optimisation basée sur LLM : un LLM reçoit vos instructions et toutes les suggestions. Il applique les meilleures pratiques d’ingénierie rapide pour restructurer, clarifier et améliorer les instructions.
Génération de raisonnement : pour chaque paragraphe modifié, le LLM génère une explication de la raison pour laquelle la modification a été apportée. Ce raisonnement s’affiche en même temps que le texte optimisé pour une transparence totale.
Affinement itératif : après l’optimisation initiale, vous pouvez fournir des suggestions supplémentaires et optimiser. Chaque optimisation suivante utilise le texte optimisé le plus récent comme nouvelle ligne de base, combinée à votre nouvelle suggestion. Répétez cette boucle jusqu’à ce que vous soyez satisfait du résultat.
Ouvrir l’optimiseur de prompt
Pour ouvrir l’optimiseur d'invite de commande dans le portail Foundry :
- Connectez-vous à Microsoft Foundry. Vérifiez que le commutateur New Foundry est activé.
- Accédez à Build>Agents, puis sélectionnez l’agent que vous souhaitez optimiser.
- Dans le panneau de configuration de l’agent, recherchez la section Instructions .
- Sélectionnez le crayon avec l’icône d'étincelle (✏️✨) à côté de l’en-tête Instructions. La boîte de dialogue "Optimiseur d'invite" s'ouvre avec cette action.
Conseil
Vous pouvez utiliser Prompt Optimizer à l’intérieur du model playground, où il y a un champ d’instructions système.
Optimiser les instructions d’un nouvel agent
Si votre agent n’a pas encore d’instructions :
- Ouvrir l’optimiseur de prompt La boîte de dialogue affiche un état vide vous invitant à décrire ce que votre agent doit faire.
- Dans la zone de texte, entrez une description de l’objectif et du comportement de votre agent. Par exemple : « Assistant planification de voyage qui aide les utilisateurs à planifier des voyages multi-journées avec des recommandations budgétaires ».
- Sélectionnez Optimiser. L’optimiseur génère un ensemble complet d’instructions système structurées en fonction de votre description.
- Passez en revue les instructions optimisées. Les paragraphes modifiés sont mis en surbrillance en violet avec une bordure violette gauche.
- Sélectionnez Utiliser l’invite pour appliquer les instructions optimisées à votre agent. La boîte de dialogue se ferme et le champ Instructions est mis à jour avec le texte optimisé.
Optimiser les instructions existantes
Si votre agent a déjà des instructions, procédez comme suit :
- Ouvrir l’optimiseur de prompt La boîte de dialogue affiche vos instructions d’origine dans une carte délimitée.
- Si vous le souhaitez, entrez une suggestion dans la barre de suggestions pour guider l’optimisation. Par exemple : « Ajouter des garde-fous pour les questions hors sujet » ou « Rendre le ton plus conversationnel ».
- Sélectionnez Optimiser. L’optimiseur analyse vos instructions actuelles et génère une version améliorée.
- Passez en revue les instructions optimisées.
- Sélectionnez Utiliser l’invite pour remplacer vos instructions actuelles par la version optimisée. La boîte de dialogue se ferme et le champ Instructions est mis à jour avec le texte optimisé.
Note
Vous pouvez laisser le champ de suggestion vide. Dans certains cas, l’optimisation sans direction supplémentaire produit des résultats forts, car l’optimiseur se concentre uniquement sur les améliorations structurelles et claires.
Examiner le raisonnement d’optimisation
Prompt Optimizer fournit un raisonnement transparent au niveau du paragraphe pour chaque modification :
- Raisonnement individuel : sélectionnez l’icône de bulle de conversation (💬) en regard de tout paragraphe modifié pour voir pourquoi cette modification spécifique a été apportée. Le raisonnement apparaît dans une zone en surbrillance violette sous le paragraphe.
- Afficher tout le raisonnement : sélectionnez le bouton bascule Afficher tout le raisonnement pour afficher le raisonnement pour chaque paragraphe modifié à la fois.
Les explications du raisonnement décrivent quel principe d’ingénierie des prompts a été appliqué et pourquoi il améliore les instructions. Ces informations vous aident à comprendre et à valider chaque suggestion avant de l’accepter.
Itérer sur les optimisations
Vous pouvez affiner le résultat optimisé autant de fois que nécessaire :
- Après avoir examiné les instructions optimisées, entrez une nouvelle suggestion dans la barre de suggestions. Par exemple : « Raccourcir la section format de réponse » ou « Ajouter un comportement de secours lorsque l’utilisateur demande quelque chose de hors de portée ».
- Sélectionnez Optimiser à nouveau. L’optimiseur utilise votre dernier texte optimisé comme nouvelle base de référence et applique votre nouvelle suggestion.
- Répétez jusqu’à ce que vous soyez satisfait.
- Sélectionnez Utiliser l’invite pour appliquer le résultat final. La boîte de dialogue se ferme et le champ Instructions est mis à jour avec le texte optimisé.
Important
Les résultats d’optimisation ne sont pas stockés définitivement. Pour appliquer les résultats, sélectionnez Utiliser l’invite avant de fermer la boîte de dialogue, ou vous perdez les résultats.
Régions prises en charge
Vous pouvez utiliser le Prompt Optimizer dans les projets hébergés dans les régions suivantes.
- États-Unis du Centre
- Est des États-Unis 2
- France Central
- Allemagne Centre-Ouest
- Italie Nord
- Japon Ouest
- USA Centre Nord
- Pologne Centre
- Espagne Centre
- Suède Centre
- Suisse Ouest
- Émirats arabes unis Nord
- USA Ouest
- Ouest des États-Unis 2
- Ouest des États-Unis 3
Dans les régions non prises en charge, le bouton Optimiser n’apparaît pas.
Limitations
- Instructions textuelles uniquement : l’optimiseur fonctionne uniquement avec les instructions de l’agent textuel. Elle ne prend pas en charge l’optimisation des éléments de configuration non textuels tels que les définitions d’outils ou les sources de connaissances.
- Résultats éphémères : les résultats d’optimisation ne sont pas conservés entre les sessions. Sélectionnez Utiliser l’invite pour appliquer les résultats avant de fermer la boîte de dialogue.
- Aucun historique des versions : l’optimiseur n’enregistre pas automatiquement les versions précédentes de vos instructions. Envisagez de copier vos instructions d’origine avant de les optimiser si vous souhaitez les conserver.
Meilleures pratiques
- Commencez simple, puis affinez : commencez par une brève description de l’objectif de votre agent et laissez l’optimiseur créer la structure initiale. Effectuez ensuite une itération avec des suggestions ciblées.
- Utilisez des suggestions spécifiques : des suggestions vagues telles que « améliorer » produisent des résultats moins utiles que des résultats spécifiques tels que « ajouter la gestion des erreurs pour les dates non valides » ou « restreindre les réponses aux anglais uniquement ».
- Passez en revue le raisonnement avant d’accepter : le raisonnement par paragraphe vous permet d’intercepter les modifications susceptibles de ne pas s’aligner sur votre cas d’usage, même s’ils suivent les meilleures pratiques d’ingénierie rapide.
- Test après l’optimisation : après avoir appliqué des instructions optimisées, testez votre agent dans le terrain de jeu pour vérifier que les modifications produisent le comportement attendu avant le déploiement.
- Conservez votre invite d’origine : avant d’optimiser, veuillez copier vos instructions actuelles si vous souhaitez revenir en arrière. Rechargez la page après avoir appliqué les modifications pour restaurer vos instructions précédentes tant que vous n'avez pas enregistré l'agent.
- Exécutez une évaluation complète : après l’optimisation, exécutez une évaluation avec votre propre jeu de données pour mesurer si les modifications améliorent réellement les performances de votre agent. Prompt Optimizer applique les meilleures pratiques générales, mais vos données d’évaluation valident si ces modifications fonctionnent pour votre cas d’usage spécifique.
Dépannage
| Problème | Cause possible | Résolution |
|---|---|---|
| L’icône Optimiser n’apparaît pas | Project se trouve dans une région non prise en charge | Déplacez votre projet vers une région prise en charge ou créez un projet dans l’une des régions répertoriées. |
| L’optimisation produit des résultats inattendus | La suggestion était trop vague ou conflictuelle | Fournissez des conseils plus spécifiques dans la barre de suggestions. Essayez d’optimiser sans suggestion en premier, puis ajoutez des affinements ciblés. |
| L’optimisation prend trop de temps | Instructions volumineuses ou complexes | Divisez vos instructions en sections ciblées et optimisez-les individuellement, puis combinez-les. |
| Les changements ne se reflètent pas dans l'agent | L’option « Utiliser l’invite » n’a pas été sélectionnée | Ouvrez à nouveau l’optimiseur et réexécutez l’optimisation. Veillez à sélectionner Utiliser l’invite avant de fermer la boîte de dialogue. |