Variables de contexte des prompts REDA AI
Qu’est-ce qu’une variable de contexte ?
Une variable est un emplacement réservé dans un prompt, remplacé par sa valeur lors du traitement. Elle permet des interactions personnalisées sans configuration manuelle pour chaque utilisateur ou situation.
Elle prend la forme {VARIABLE_NAME}. Lors du traitement du prompt, elle est remplacée par la valeur correspondante.
Exemple : « Bonjour {USER_FIRST_NAME} ! Nous sommes le {TODAY_DATE}. » devient « Bonjour Jean ! Nous sommes le 2026-03-05. » lorsque ces valeurs s’appliquent.
Variables disponibles
| Variable | Valeur obtenue | Exemple | Moment de résolution |
|---|---|---|---|
| {USER_NAME} | Nom complet de l’utilisateur | John Smith | Pour la conversation |
| {USER_FIRST_NAME} | Prénom de l’utilisateur | John | Pour la conversation |
| {USER_EMAIL} | Adresse e-mail de l’utilisateur | john@example.com | Pour la conversation |
| {USER_ACCOUNT_NAME} | Nom du compte lié au contact de l’utilisateur du portail ; vide pour un utilisateur interne sans contact associé | Acme Properties | Pour la conversation |
| {CONVERSATION_ID} | Identifiant de la conversation actuelle, utile pour les instructions d’audit | aX0… | Pour la conversation |
| {USER_CONTEXT_DATA} | Bloc formaté décrivant l’utilisateur exécutant, utilisé par les prompts fournis | — | Pour la conversation |
| {RECORD_CONTEXT_DATA} | Bloc de contexte formaté pour l’enregistrement concerné par la conversation | — | Pour la conversation |
| {TODAY_DATE} | Date du jour | 2026-03-05 | À l’assemblage, compatible avec le cache |
| {AGENT_NAME} | Nom d’affichage de l’agent | Assistant commercial | À l’assemblage, compatible avec le cache |
| {AGENT_CHANNEL} | Canal de la conversation | Internal | À l’assemblage, compatible avec le cache |
| {USER_LANGUAGE} | Code de langue Salesforce de l’utilisateur, selon le canal | es_MX | À l’assemblage, compatible avec le cache |
| {USER_LANGUAGE_CODE} | Partie linguistique du code de langue | es | À l’assemblage, compatible avec le cache |
Utiliser les variables dans les prompts
Ces variables s’utilisent dans le contenu des différents types de prompts :
« Bonjour {USER_FIRST_NAME} ! Je suis {AGENT_NAME}, votre assistant commercial. Comment puis-je vous aider à faire avancer vos affaires aujourd’hui ? »
« Pour répondre à {USER_FIRST_NAME}, adoptez un style direct et concis. Référez-vous à {TODAY_DATE} pour les estimations de calendrier. »
« L’utilisateur {USER_NAME} ({USER_EMAIL}) utilise cet agent dans la conversation {CONVERSATION_ID}. Conservez les échanges selon les exigences de conformité et transmettez les demandes de données sensibles au responsable. »
Exemples de personnalisation
Agent commercial personnalisé
Sans variable :
« Vous êtes un assistant commercial qui aide à conclure les affaires. »
Avec des variables :
« Vous êtes l’assistant commercial de {USER_FIRST_NAME}. Aidez cette personne à conclure les affaires, gérer les opportunités et suivre la progression. La date du jour est {TODAY_DATE}. »
Le même prompt s’adapte à chaque utilisateur.
Agent d’assistance avec date de référence
Sans variable :
« Aidez les clients à résoudre leurs demandes d’assistance. »
Avec des variables :
« Aidez les clients à résoudre leurs demandes d’assistance. Date actuelle : {TODAY_DATE}. Utilisez cette date pour discuter des délais. Répondez dans la langue de l’utilisateur ({USER_LANGUAGE}). »
Vos propres variables de modèle restent intactes
REDA AI remplace les douze variables répertoriées ci-dessus. Si votre organisation utilise ses propres emplacements réservés, à renseigner par une personne ou un autre système, écrivez-les entre doubles accolades, par exemple {{ORG_NAME}}.
REDA AI ne remplace pas ces variables à doubles accolades. L’optimiseur de prompts et l’outil d’optimisation de l’agent avec IA reçoivent l’instruction de conserver chaque marqueur {{…}} exactement, sans le supprimer, le renommer ni lui attribuer une valeur. Vérifiez leur conservation lors de la revue du résultat.
Distinguez les deux : les variables reconnues à simples accolades sont celles de REDA AI ; les doubles accolades sont vos propres marqueurs et restent inchangées.
Disponibilité selon le canal
Les variables d’agent et de date fonctionnent sur tous les canaux. Les variables utilisateur dépendent de l’existence d’une personne authentifiée :
- Canal Interne — Les variables utilisateur proviennent de la personne Salesforce connectée. Sur API, certaines versions les remplacent par du texte vide : ne comptez pas sur la langue ou l’identité du compte d’intégration pour représenter le destinataire. Fournissez explicitement le contexte humain nécessaire et vérifiez le résultat sur votre version installée.
- Canal Communauté — Elles proviennent de l’utilisateur du portail ; {USER_ACCOUNT_NAME} contient le compte lié à son contact.
- Widget externe — Aucune personne n’est authentifiée. Les variables utilisateur sont remplacées par du texte vide et ne sont pas envoyées littéralement au modèle. Rédigez les prompts pour qu’ils restent naturels sans ces valeurs.
Une variable inconnue, à cause d’une faute de frappe ou d’un nom inexistant, est différente : elle n’est pas remplacée et atteint le modèle telle quelle. Consultez le diagnostic ci-dessous.
Bonnes pratiques
Les variables doivent améliorer l’échange sans l’alourdir. Répéter {USER_FIRST_NAME} à chaque phrase manque de naturel. Utilisez-les avec mesure.
Vérifiez la disponibilité par canal — Avant d’utiliser une variable sur un widget externe ou une intégration, vérifiez son comportement dans une sandbox avec le contexte utilisateur représentatif.
Prévoyez les valeurs vides — Demandez un salut neutre si le prénom manque, plutôt que d’inclure une formule maladroite ou une variable inconnue dans le texte présenté.
Utilisez la date fournie pour les consignes temporelles — {TODAY_DATE} fournit une date comme 2026-03-05. Ne supposez pas un format d’affichage local dans la variable ; demandez séparément le format souhaité pour la réponse.
Respectez la confidentialité — N’exposez {USER_EMAIL} que si nécessaire. Le prénom suffit souvent à personnaliser l’interaction.
Exemples courants
« Bonjour {USER_FIRST_NAME}, ravi de vous retrouver. La date du jour est {TODAY_DATE}. »
« Vous assistez {USER_NAME}, de {USER_ACCOUNT_NAME}. Adaptez les réponses à son rôle et à son niveau de connaissance. La date du jour est {TODAY_DATE}. »
« Informations de suivi : utilisateur {USER_NAME}, e-mail {USER_EMAIL}, conversation {CONVERSATION_ID}, date {TODAY_DATE}. »
« La langue de l’utilisateur est {USER_LANGUAGE}. Répondez dans cette langue et respectez ses conventions. La date du jour est {TODAY_DATE}. »
Résoudre les problèmes de variables
Vérifiez l’orthographe exacte et la casse : {USER_FIRST_NAME} fonctionne, {User_First_Name} non. Sur Widget externe, les variables utilisateur sont volontairement remplacées par du texte vide.
Valeur inattendue — Certaines valeurs dépendent de Salesforce. Sur les canaux authentifiés, {USER_LANGUAGE} reflète la langue de l’utilisateur ; corrigez sa préférence personnelle si nécessaire.
Variable affichée littéralement — Un marqueur comme {UNKNOWN_VAR} n’est pas reconnu et peut être répété par le modèle. Utilisez uniquement les noms répertoriés.
Questions fréquentes
Seules les variables prédéfinies ci-dessus sont remplacées par REDA AI. Pour fournir d’autres informations, utilisez des champs de contexte ou les entrées de l’agent. Vos marqueurs à doubles accolades restent disponibles pour un traitement externe, mais REDA AI ne les renseigne pas.
Elles s’utilisent dans les prompts. Les configurations de champs de contexte attendent des noms API Salesforce, pas ces variables. Utilisez des descriptions de champs dans les prompts pour expliquer les règles dynamiques.
Si le prénom n’est pas renseigné, {USER_FIRST_NAME} est remplacé par une chaîne vide. Prévoyez une consigne demandant un salut neutre dans ce cas, afin de garder une réponse naturelle.
Le libellé du bouton est statique. Les variables de prompt ne doivent pas être supposées disponibles dans ce libellé. Vérifiez séparément le traitement du message associé à la suggestion selon votre configuration.
Prochaines étapes
Consultez Créer et modifier des prompts pour d’autres exemples, ou les bonnes pratiques pour améliorer les instructions.