Ajouter des champs de contexte
Comment ajouter un champ de contexte
-
Ouvrez la définition de l’agent
Ouvrez l’application REDA AI, puis la définition de l’agent à configurer.
-
Repérez la liste associée Champs de contexte
Descendez jusqu’à la liste associée « Champs de contexte », qui affiche les champs déjà configurés.
-
Cliquez sur « Nouveau »
Cliquez sur « Nouveau » pour créer un enregistrement de champ de contexte.
-
Renseignez Nom de l'API de l'objet
Saisissez le type d’objet Salesforce, par exemple « Opportunity », « Account » ou « Contact ». Il s’agit du nom API, pas du libellé.
-
Saisissez Noms des API de champ
Saisissez tous les champs à charger dans cette configuration sous forme de noms API séparés par des virgules, par exemple
StageName, Amount, CloseDate. Un seul enregistrement de configuration contient la liste complète ; vous ne créez pas un enregistrement par champ. Retrouvez les noms API dans Configuration → Gestionnaire d’objet → Champs. -
Définissez Champs max., si nécessaire
Ce paramètre limite le nombre de champs fournis par la configuration. La valeur par défaut est 10. Augmentez-la si votre liste est plus longue, en gardant à l’esprit que chaque champ consomme des jetons à chaque tour.
-
Laissez Inclure les noms apparentés activé, comme recommandé
Cette option est activée par défaut. Les champs de relation fournissent alors le nom de l’enregistrement associé en complément de son identifiant. L’agent lit ainsi « Acme Properties » au lieu d’une clé de 18 caractères.
-
Ajoutez une Description du contexte, si nécessaire
Ce texte libre explique à l’agent ce que représente le contexte de l’enregistrement et comment l’utiliser. Il est utile lorsque les noms des champs ne suffisent pas à expliquer leur sens métier.
-
Définissez Ordre de tri, si nécessaire
Ce paramètre détermine l’ordre d’application des configurations lorsque plusieurs correspondent. Les valeurs les plus basses passent en premier ; la valeur par défaut du package est 100.
-
Limitez le type d’enregistrement, si nécessaire
Pour limiter la configuration à un type d’enregistrement, saisissez son nom développeur dans « Type d'enregistrement Nom du développeur ». Laissez vide pour tous les types ; ne saisissez pas le libellé affiché.
-
Enregistrez le champ de contexte
Cliquez sur Enregistrer. Le champ est désormais configuré pour cet agent.
Retrouver les noms API des champs et des objets
Les champs de contexte nécessitent des noms API, pas des libellés. Pour les retrouver :
- Ouvrez Configuration → Gestionnaire d’objet.
- Recherchez l’objet, par exemple « Opportunité ».
- Cliquez sur « Champs et relations ».
- Recherchez le champ souhaité, par exemple « Étape ».
- Cliquez sur le champ pour ouvrir ses détails.
- Repérez « Nom du champ » ou « Nom de l’API » : c’est la valeur à saisir dans les champs de contexte.
- Exemple : le champ dont le libellé est « Étape » possède le nom API « StageName ».
Exemples courants de libellés et de noms API :
| Objet | Libellé | Nom API |
|---|---|---|
| Opportunité | Étape | StageName |
| Date de clôture | CloseDate | |
| Chiffre d’affaires prévu | ExpectedRevenue | |
| Compte | Nom du compte | Name |
| Chiffre d’affaires annuel | AnnualRevenue | |
| Nombre d’employés | NumberOfEmployees | |
| Requête | Statut | Status |
| Priorité | Priority | |
| Description | Description |
Champs de configuration du contexte
| Champ | Obligatoire ? | Description |
|---|---|---|
| Définition d'agent | Non, facultatif | L’agent auquel ce champ de contexte s’applique. Laissez le champ vide pour créer une configuration universelle. |
| Nom de l'API de l'objet | Oui | L’objet Salesforce, par exemple « Opportunity » ou « Account ». Utilisez le nom API, pas le libellé. |
| Noms des API de champ | Oui | Liste des noms API des champs à charger, séparés par des virgules, par exemple « StageName, Amount ». Un enregistrement de configuration contient toute la liste. |
| Champs max. | Non | Limite le nombre de champs fournis par cette configuration. Valeur par défaut : 10. |
| Inclure les noms apparentés | Non | Activé par défaut : les champs de relation fournissent le nom de l’enregistrement associé en complément de son identifiant. |
| Description du contexte | Non | Texte libre qui explique à l’agent ce que représente le contexte de l’enregistrement et comment l’utiliser. |
| Ordre de tri | Non | Nombre qui départage les configurations de même priorité. Les valeurs les plus basses passent en premier. Valeur par défaut : 100. |
| Type d'enregistrement Nom du développeur | Non | Permet de limiter ce champ de contexte à un type d’enregistrement précis. Laissez vide pour l’appliquer à tous les types. |
Trois règles que les libellés des champs ne précisent pas.
- Champs max. est ramené à une valeur comprise entre 1 et 25 lors de l’exécution. La valeur par défaut est 10. Si vous saisissez 40, l’agent reçoit tout de même 25 champs ; si vous saisissez 0, il en reçoit 1. La valeur n’est pas rejetée à l’enregistrement : une configuration demandant 40 champs semble donc fonctionner tout en n’en fournissant que 25.
- Ordre de tri est le dernier critère de départage, pas la première règle. Une configuration propre à l’agent est prioritaire sur une configuration universelle ; une configuration limitée à un type d’enregistrement est prioritaire sur une configuration sans restriction. Ces critères sont appliqués avant Ordre de tri, qui ne départage que les configurations encore à égalité. Une configuration universelle avec Ordre de tri à 1 reste moins prioritaire qu’une configuration propre à l’agent avec Ordre de tri à 100.
- Type d'enregistrement Nom du développeur attend le DeveloperName, pas le libellé. Si un type d’enregistrement s’affiche sous le nom « Commercial Lease » dans Configuration, la valeur attendue ici est probablement
Commercial_Lease. Un libellé saisi par erreur ne correspond jamais et empêche silencieusement l’activation de la configuration.
Au maximum, 50 configurations sont prises en compte pour un objet au cours d’un même tour. Ce plafond dépasse largement les besoins d’une configuration raisonnable, mais il existe.
Champs de contexte universels
Pour créer une configuration qui s’applique à TOUS les agents :
- Laissez le champ de relation Définition d'agent vide, sans sélectionner d’agent.
- Renseignez Nom de l'API de l'objet et Noms des API de champ comme d’habitude.
- Enregistrez.
Cette configuration s’applique désormais à tous les agents pour ce type d’objet, sauf lorsqu’une configuration propre à un agent la remplace avec une priorité plus élevée.
Tester les champs de contexte
Après avoir ajouté un champ de contexte :
-
Ouvrez un enregistrement dans Salesforce
Ouvrez un enregistrement du type d’objet configuré, par exemple une opportunité si vous avez ajouté des champs pour Opportunity.
-
Ouvrez la conversation avec l’agent
Ouvrez le widget de conversation REDA AI sur la page de l’enregistrement.
-
Posez une question sur l’enregistrement
Posez une question telle que « Quelle est l’étape de cette opportunité ? » ou « Parlez-moi de cette affaire. »
-
Vérifiez que la réponse contient les valeurs des champs
L’IA doit mentionner les valeurs des champs de contexte. Si c’est le cas, les champs fonctionnent.
-
Consultez les journaux, si nécessaire
Si vous avez accès aux journaux de conversation ou aux informations de débogage, vérifiez que les données ont été incluses dans le contexte de l’IA.
Bonnes pratiques pour les champs de contexte
Commencez par ajouter 3 à 5 champs, puis testez. Surveillez la consommation de jetons et ajustez la configuration. Ajoutez des champs uniquement si l’IA en a besoin et si le budget de jetons le permet.
Expliquez le contexte, pas les noms des champs : l’agent lit directement les noms API. Utilisez donc Description du contexte pour expliquer ce que représente l’enregistrement et comment l’utiliser, par exemple : « Il s’agit d’un bail actif ; Amount correspond au loyer mensuel, pas au montant total du contrat. » Cette explication apporte bien plus que le renommage de chaque champ.
Ordonnez les champs dans la liste : les champs sont présentés à l’agent dans l’ordre de saisie dans Noms des API de champ. Placez les plus importants en premier. Ordre de tri départage les enregistrements de configuration complets, pas les champs d’une même liste.
Utilisez les restrictions par type d’enregistrement : si vos types d’enregistrement possèdent des champs différents, adaptez le contexte à chacun grâce aux restrictions.
Surveillez les jetons consommés : chaque champ de contexte ajoute des jetons. Après un ajout, surveillez les crédits consommés et ajustez la configuration si les coûts augmentent de façon inattendue.
Retirer des champs de contexte
Pour ne plus utiliser une configuration de champ de contexte :
- Ouvrez l’enregistrement du champ de contexte.
- Cliquez sur Supprimer.
- Confirmez la suppression.
Le champ est immédiatement retiré du contexte de l’agent. L’IA ne dispose plus de ce champ sur les pages d’enregistrement via cette configuration.
Exemples de listes de champs de contexte
- Ordre 1 : AccountId (relation vers le compte ; son nom est ajouté si Inclure les noms apparentés est activé)
- Ordre 2 : StageName (étape actuelle de l’affaire)
- Ordre 3 : Amount (montant de l’affaire)
- Ordre 4 : CloseDate (date de clôture prévue)
- Ordre 5 : Probability (probabilité utilisée dans les prévisions)
- Ordre 1 : CaseNumber (référence)
- Ordre 2 : Status (ouvert/fermé)
- Ordre 3 : Priority (urgence)
- Ordre 4 : Description (résumé du problème)
- Ordre 5 : CreatedDate (date du signalement)
- Ordre 1 : Name (nom du compte)
- Ordre 2 : Industry (secteur d’activité)
- Ordre 3 : AnnualRevenue (indicateur de taille de l’entreprise)
- Ordre 4 : BillingCity (ville)
Questions fréquentes
Oui. Tout champ accessible via l’API Salesforce peut être ajouté, y compris les champs de formule et de synthèse. Saisissez son nom API exactement comme il apparaît dans le Gestionnaire d’objet.
Si un champ est vide sur un enregistrement, l’IA le voit comme vide. Elle gère les données manquantes sans interrompre la conversation. Vous pouvez donc inclure des champs facultatifs.
La consommation de jetons augmente avec le nombre de champs. Un bon point de départ est de 5 à 10 champs par objet. Utilisez l’optimiseur de champs de contexte pour repérer les plus utiles et retirer ceux rarement utilisés.
Non. Ils sont chargés uniquement sur les pages de détail d’un enregistrement. Sur une vue de liste ou une page d’accueil, l’IA ne dispose pas d’un enregistrement précis à utiliser comme contexte ; les champs ne sont donc pas chargés.
Comportement lors de l’exécution
La plateforme applique deux mécanismes de sécurité lors du chargement du contexte. Tenez-en compte dans votre configuration :
- Gestion des relations polymorphes. Les champs de relation ayant plusieurs objets cibles possibles, comme
Task.WhoIdetTask.WhatId, incluent l’identifiant de relation dans le contexte, mais n’ajoutent pas automatiquement le nom comme les relations à cible unique. Consultez Relations polymorphes. - Mode strict ou dégradé. Par défaut, si un champ de contexte configuré devient inaccessible parce qu’il a été supprimé, renommé ou bloqué par la sécurité au niveau des champs (FLS) pour l’utilisateur d’exécution, l’exécution de l’agent est interrompue. L’option Autoriser le contexte d'enregistrement d de l’agent autorise la poursuite : la plateforme consigne un avertissement et continue avec les champs qu’elle a pu charger. Choisissez le mode strict pour les agents internes nécessitant un contexte complet, et le mode dégradé pour les agents destinés aux clients ou pilotés par API qui doivent tolérer l’absence de certains champs.
Prochaines étapes
Utilisez l’optimiseur de champs de contexte pour obtenir des recommandations de l’IA, découvrez la gestion des relations polymorphes lors de l’exécution, ou explorez les suggestions contextuelles pour proposer des boutons d’action rapide.