Vérifier et optimiser les prompts d'agents

Écrit par Stanislas

Dernière mise à jour Il y a 14 jours

Aperçu

Lorsque vous modifiez les instructions d'un agent, vous pouvez cliquer sur « Vérifier et optimiser » pour qu'un agent IA analyse votre prompt. La fonctionnalité effectue un examen détaillé et vous montre :

  • Recommandations : Une liste à puces de suggestions spécifiques (supprimer les problèmes de formatage, compléter les sections manquantes, clarifier les données codées en dur, ajouter une messagerie structurée, spécifier les URL de référence)

  • Prompt optimisé : Une version entièrement réécrite de votre prompt qui incorpore toutes les recommandations

Vous pouvez examiner les deux côte à côte, copier la version optimisée ou l'appliquer directement à votre agent en un clic.

Prérequis

Pour utiliser la fonctionnalité d'optimisation des prompts, vous avez besoin de :

  • Un compte Swiftask (inscrivez-vous sur swiftask.ai)

  • Un accès à la section Agents

  • La permission de modifier les agents dans votre espace de travail

  • Un agent avec un prompt (instructions) déjà créé

La fonctionnalité est disponible pour tous les utilisateurs de Swiftask sur tous les plans.

Guide étape par étape

1. Ouvrez votre agent et accédez à Instructions

Allez à Agents dans la barre latérale gauche et trouvez l'agent que vous souhaitez améliorer. Cliquez pour l'ouvrir, puis cliquez sur le bouton Modifier (icône crayon) pour entrer en mode édition.

Dans l'éditeur d'agent, localisez la section Instructions dans le panneau de gauche. C'est ici que le prompt de votre agent et ses règles de comportement sont définis.

2. Cliquez sur « Vérifier et optimiser »

Dans le coin supérieur droit de la section Instructions, vous verrez un bouton intitulé « Vérifier et optimiser » (avec une icône d'étincelle). Cliquez dessus pour démarrer l'analyse.

3. Attendez que l'analyse se termine

Une boîte de dialogue intitulée « Révision du prompt » s'ouvre et affiche un message de chargement : « L'agent d'optimisation des prompts examine votre prompt. Cela peut prendre quelques secondes… »

Le système analyse votre prompt actuel pour la clarté, l'exhaustivité, la structure et les bonnes pratiques.

4. Examinez les recommandations et le prompt optimisé

Une fois l'analyse terminée, la boîte de dialogue affiche deux panneaux côte à côte :

Panneau de gauche — Recommandations :
Une liste à puces d'améliorations spécifiques. Chaque recommandation explique ce qu'il faut améliorer et pourquoi. Les suggestions courantes incluent :

  • Supprimer les incohérences de formatage ou les symboles supplémentaires

  • Ajouter des sections manquantes (par exemple, les directives de ton, le format de réponse)

  • Généraliser les valeurs codées en dur (par exemple, remplacer les noms spécifiques par des espaces réservés)

  • Ajouter des formats de messages structurés

  • Inclure les URL de référence ou les liens externes

Panneau de droite — Prompt optimisé :
Une version entièrement réécrite de votre prompt qui incorpore toutes les recommandations. C'est prêt à être utilisé immédiatement.

En haut à droite, vous verrez un bouton rouge : « Appliquer le prompt optimisé ».

5. Copier le prompt optimisé (optionnel)

Si vous souhaitez examiner le prompt optimisé en détail avant de l'appliquer, vous pouvez le copier dans votre presse-papiers. Recherchez une icône de copie dans le panneau du prompt optimisé et cliquez dessus.

Vous pouvez ensuite coller le texte n'importe où pour l'examiner davantage.

6. Appliquez le prompt optimisé ou fermez

Pour appliquer le prompt optimisé :
Cliquez sur le bouton « Appliquer le prompt optimisé » (bouton rouge/corail en haut à droite). La boîte de dialogue se ferme, votre éditeur de prompt se met à jour immédiatement avec la nouvelle version optimisée, et vous voyez un message de confirmation.

Pour conserver votre prompt original :
Cliquez sur le bouton X pour fermer la boîte de dialogue sans appliquer les modifications. Votre prompt original reste inchangé.

Cas d'usage pratiques

Améliorer un agent d'assistance à la clientèle

Le prompt de votre agent d'assistance est vague : « Vous aidez les clients ayant des problèmes. Soyez gentil et répondez aux questions. » Vous cliquez sur « Vérifier et optimiser » et recevez des recommandations pour ajouter des formats de réponse spécifiques, des directives de ton et une liste de sujets pris en charge. Vous appliquez la version optimisée, et l'agent fournit désormais des réponses plus cohérentes et structurées.

Affiner un agent de documentation technique

Le prompt de votre agent contient des noms de produits codés en dur et des références de fonctionnalités obsolètes. L'optimiseur suggère de généraliser ces valeurs et d'ajouter des espaces réservés pour la flexibilité. Après avoir appliqué les modifications, votre agent peut gérer plusieurs gammes de produits sans modifications de prompt.

Standardiser les prompts dans votre équipe

Vous avez créé plusieurs agents avec des rôles similaires mais des instructions incohérentes. Vous exécutez « Vérifier et optimiser » sur chacun d'eux. Les recommandations vous aident à identifier les sections manquantes et les lacunes structurelles. Vous appliquez les versions optimisées pour créer une base de référence cohérente dans votre parc d'agents.

Préparer un agent pour la production

Avant de partager votre agent avec votre équipe, vous souhaitez vous assurer que le prompt est clair et complet. Vous cliquez sur « Vérifier et optimiser » et recevez des suggestions pour ajouter des instructions de gestion des erreurs, clarifier les cas limites et améliorer le formatage. Vous appliquez le prompt optimisé, et votre agent est maintenant prêt pour la production.

Conseils et bonnes pratiques

Examinez les recommandations avant d'appliquer

Ne sautez pas la lecture du panneau des recommandations. Il explique pourquoi chaque modification est importante, ce qui vous aide à comprendre comment améliorer les futurs prompts.

Utilisez la version optimisée comme point de départ

Le prompt optimisé est complet mais peut nécessiter des ajustements pour votre cas d'usage spécifique. Appliquez-le, puis affinez davantage si nécessaire.

Testez votre agent optimisé

Après avoir appliqué le prompt optimisé, testez votre agent dans le panneau de chat pour vous assurer qu'il se comporte comme prévu. L'affinage est normal.

Exécutez l'optimisation régulièrement

Si vous mettez à jour votre prompt manuellement, envisagez d'exécuter « Vérifier et optimiser » à nouveau pour détecter de nouvelles opportunités d'amélioration.

Copier pour comparaison

Si vous n'êtes pas sûr d'appliquer les modifications, copiez le prompt optimisé, collez-le dans un éditeur de texte et comparez-le côte à côte avec votre original avant de décider.

Que se passe-t-il ensuite

Une fois que vous appliquez le prompt optimisé :

  • Les instructions de votre agent se mettent à jour immédiatement

  • La boîte de dialogue se ferme et vous revenez à l'éditeur d'instructions

  • Un message de confirmation apparaît brièvement

  • Votre agent utilise désormais le prompt amélioré pour toutes les nouvelles interactions

  • Les historiques de chat précédents restent inchangés

  • Vous pouvez modifier davantage le prompt optimisé si nécessaire

  • Vous pouvez exécuter « Vérifier et optimiser » à tout moment pour obtenir de nouvelles suggestions

Dépannage

Problème : Le chargement prend trop longtemps

Cause : L'analyse peut prendre plus longtemps si votre prompt est très long ou si le système est occupé.

Solution : Attendez un peu plus longtemps. Si cela dépasse 30 secondes, fermez la boîte de dialogue et réessayez. Si le problème persiste, vérifiez votre connexion Internet.

Problème : Le bouton « Vérifier et optimiser » est désactivé ou grisé

Cause : Vous n'avez peut-être pas la permission de modifier cet agent, ou l'agent n'a pas encore de prompt.

Solution : Confirmez que vous êtes en mode édition (icône crayon visible). Assurez-vous que votre rôle utilisateur permet la modification. Si l'agent n'a pas de prompt, ajoutez d'abord quelques instructions initiales, puis réessayez.

Problème : Message d'erreur au clic sur « Vérifier et optimiser »

Cause : Une erreur réseau ou un problème de service a empêché le démarrage de l'analyse.

Solution : Fermez la boîte de dialogue et réessayez. Si l'erreur persiste, actualisez la page et tentez à nouveau l'optimisation. Contactez le support si le problème continue.

Problème : Aucune recommandation affichée

Cause : Votre prompt est peut-être déjà bien structuré, ou l'analyse n'a pas pu détecter des domaines d'amélioration spécifiques.

Solution : C'est normal. Votre prompt est probablement déjà en bon état. Vous pouvez toujours examiner la version optimisée pour voir si des modifications vous intéressent.

Problème : Le bouton « Appliquer le prompt optimisé » est désactivé

Cause : L'analyse d'optimisation n'a peut-être pas été complétée avec succès.

Solution : Fermez la boîte de dialogue et essayez d'exécuter « Vérifier et optimiser » à nouveau.

Problème : L'action de copie ne fonctionne pas

Cause : Votre navigateur peut avoir des restrictions de presse-papiers, ou le bouton de copie n'a pas été complètement chargé.

Solution : Essayez de cliquer à nouveau sur l'icône de copie. Vous pouvez également sélectionner manuellement le texte du prompt optimisé, le copier (Ctrl+C ou Cmd+C) et le coller ailleurs.

Problème : Prompt optimisé perdu après fermeture de la boîte de dialogue

Cause : Si vous avez fermé la boîte de dialogue sans cliquer sur « Appliquer le prompt optimisé », la version optimisée n'a pas été enregistrée.

Solution : Exécutez « Vérifier et optimiser » à nouveau pour régénérer les recommandations et le prompt optimisé. Chaque exécution analyse votre prompt actuel, les résultats peuvent donc varier légèrement.

Ressources supplémentaires