Bonnes pratiques pour les prompts REDA AI
1. Précisez le rôle et le périmètre de l’agent
L’agent doit savoir exactement ce qui relève de sa mission et ce qui en est exclu. Remplacez les descriptions vagues comme « Vous êtes un assistant utile » par un rôle concret :
« Vous êtes un assistant commercial spécialisé dans les contrats SaaS d’entreprise. Aidez les commerciaux à gérer leur pipeline, qualifier les pistes et suivre les affaires. Concentrez-vous sur les opportunités de plus de 50 000 $. Ne détaillez pas les tarifs et ne prenez pas d’engagement au nom de l’équipe commerciale. »
Un personnage précis aide l’IA à remplir son rôle de manière plus régulière.
2. Définissez les limites avec des garde-fous
Les prompts de garde-fous indiquent explicitement les comportements à éviter. Ne vous contentez pas de supposer que l’IA s’abstiendra :
- « N’accédez pas aux données personnelles des employés et ne les divulguez pas, notamment numéro de sécurité sociale, date de naissance et situation matrimoniale. »
- « Ne prenez pas d’engagement au nom de l’entreprise sans validation d’un responsable. »
- « Refusez les demandes d’accès aux enregistrements d’un autre service sans autorisation appropriée. »
- « Transmettez les questions sur les salaires et rémunérations aux ressources humaines. »
3. Décrivez les champs Salesforce essentiels dans des prompts de schéma
Les prompts de schéma expliquent vos structures de données et peuvent éviter des appels inutiles à describe_object ou get_picklist_values. Plutôt que de faire rechercher les valeurs de Opportunity.StageName à chaque fois, fournissez-les :
Prompt de schéma : « Opportunity.StageName possède les valeurs Prospecting, Qualification, Needs Analysis, Value Proposition, Decision Makers, Perception Analysis, Proposal/Price Quote, Negotiation/Review, Closed Won et Closed Lost. »
Au lieu de
Faire appeler un outil au modèle pour retrouver les mêmes informations, ce qui ajoute du traitement et des crédits.
Décrivez les 10 à 20 champs et objets les plus importants que votre agent utilise fréquemment.
4. Donnez un objectif unique à chaque prompt
Évitez de mélanger de nombreux comportements dans un seul texte. Créez plusieurs prompts ciblés :
Un prompt unique mêlant ton, format, règles métier et consignes d’action.
- Custom_Instructions (ordre 10) — « Utiliser des listes à puces »
- Custom_Instructions (ordre 20) — « Répondre en moins de 150 mots »
- Schema (ordre 30) — « Champs et listes de sélection d’Opportunity »
- Action (ordre 40) — « Comment créer les tâches »
- Guardrail (ordre 5) — « Ne pas discuter des tarifs »
Des prompts ciblés sont plus faciles à maintenir, tester et diagnostiquer. Utilisez des ordres distincts lorsque leur séquence compte.
5. Testez progressivement et observez les résultats
Évitez de créer dix prompts et de tout déployer d’un coup. Procédez ainsi :
- Créez un prompt
- Activez-le et testez l’agent
- Observez les changements de comportement
- Affinez les instructions si nécessaire
- Passez au prompt suivant
Cette méthode aide à identifier les instructions utiles et à repérer rapidement les effets inattendus.
6. Personnalisez avec les variables de contexte
Les variables comme {USER_FIRST_NAME}, {TODAY_DATE} et {USER_EMAIL} adaptent l’interaction. Exemple :
« Bonjour {USER_FIRST_NAME} ! Nous sommes le {TODAY_DATE}. Je vous aide à faire avancer vos affaires commerciales. »
La réponse tient ainsi compte de l’utilisateur, au lieu de rester générique.
7. Demandez des réponses concises pour réduire les crédits de sortie
Les réponses longues consomment davantage de jetons de sortie. Demandez le niveau de détail utile :
- « Limitez la réponse à deux ou trois phrases. »
- « Donnez les informations essentielles ; l’utilisateur pourra demander des précisions. »
- « Utilisez des puces pour présenter les points principaux avec concision. »
Les réponses ciblées demandent aussi moins d’effort de lecture.
8. Évitez les répétitions entre prompts
Les instructions répétées ajoutent des jetons et peuvent créer de la confusion. Si une règle existe déjà dans un prompt chargé, ne la recopiez pas ailleurs.
Évitez de répéter la même consigne dans un prompt Custom_Instructions et un prompt Guardrail.
9. Organisez l’assemblage avec l’ordre de tri
Donnez un Sort_Order inférieur aux instructions à charger en premier. Cet ordre organise le contenu, mais ne remplace pas la résolution des contradictions. Exemple :
- Sort_Order 10 : garde-fous essentiels, chargés en premier
- Sort_Order 20 : informations de schéma et contexte de données
- Sort_Order 30 : instructions de comportement
- Sort_Order 40 : consignes d’actions précises
Les prompts suivants peuvent compléter les précédents. Organisez-les logiquement.
10. Documentez votre stratégie
Consignez dans votre documentation interne :
- Le rôle de chaque prompt et sa raison d’être
- Les utilisateurs visés par l’agent
- Les situations où activer ou désactiver certaines instructions
- La façon dont les prompts se complètent
- Les limites connues et cas particuliers
Les autres administrateurs pourront comprendre vos choix et maintenir l’agent plus facilement.
Techniques avancées
Comparer deux versions
Pour un test A/B :
- Créez le prompt A et activez-le
- Créez le prompt B désactivé
- Testez successivement chaque version pendant une semaine en suivant les résultats
- Conservez la version qui répond le mieux au besoin
Affiner progressivement
Commencez par les consignes essentielles et ajoutez les améliorations selon les observations, en configurant les garde-fous nécessaires avant tout usage réel :
- Semaine 1 : personnage, instructions de base et garde-fous nécessaires
- Semaine 2 : ajouter le schéma d’après les recherches fréquentes de l’agent
- Semaine 3 : affiner les garde-fous selon les cas limites observés
- Semaine 4 et suivantes : ajuster et optimiser
Ajustements selon le contexte
Créez des prompts Persona_Override pour des contextes précis. Un agent commercial peut avoir :
- Personnage de base : ton commercial général
- Persona_Override (ordre 10) : ton plus formel pour les grandes entreprises
- Persona_Override (ordre 20) : ton plus simple pour les PME
Indiquez clairement les conditions d’application ou configurez les filtres de contexte pour éviter que les deux consignes se contredisent.
Questions fréquentes
Testez systématiquement chaque comportement avec des messages adaptés. Vérifiez le respect des instructions, des garde-fous et du format demandé. Consultez les conversations et leur débogueur pour comprendre les résultats.
Privilégiez des prompts courts et ciblés, plus faciles à gérer, tester et désactiver séparément. Un prompt par comportement logique ou ensemble cohérent d’instructions constitue un bon repère.
Recherchez une contradiction avec le personnage ou une autre instruction. Rendez le garde-fou explicite, vérifiez qu’il est effectivement chargé dans le budget et testez avec des messages représentatifs. L’ordre de tri ne garantit pas à lui seul son respect.
Oui. Un prompt universel partage les instructions avec tous les agents concernés par ses filtres ; les affectations exclusives ciblent quelques agents précis. Clonez uniquement si vous souhaitez maintenir des variantes indépendantes.
Prochaines étapes
Explorez les prompts personnalisés par agent pour leur organisation, ou les variables de contexte pour la personnalisation.