Aperçu de l’exécution d’un agent REDA AI
Financement et utilisation de l’IA
IA incluse utilise des crédits REDA. Votre propre IA utilise le compte fournisseur de votre organisation, facturé directement par ce fournisseur. La licence définit un mode pour toute l’organisation. Dans les deux cas, REDA AI gouverne les outils et actions configurés dans Salesforce. Configurer la licence et les comptes IA.
Avec IA incluse, choisissez le Processing Tier de l’agent. Avec votre propre IA, choisissez AI Connection et Model dans AI Account, ou héritez du choix par défaut de l’organisation. Les agents peuvent utiliser différents fournisseurs et modèles compatibles. Prompts, outils, contexte et permissions du canal définissent toujours leur rôle. Configurer le compte IA de l’agent.
Ce que montre l’aperçu
L’aperçu lit la définition d’agent, applique les filtres de canal et d’objet de contexte utilisés à l’exécution, puis présente quatre panneaux :
| Panneau | Contenu |
|---|---|
| Invites | Les prompts personnalisés actifs, propres à l’agent ou partagés, dans leur ordre d’assemblage. Chaque ligne indique le type, l’ordre de tri, un extrait du contenu, une estimation de jetons et un indicateur de dépassement éventuel du budget. |
| Outils | Les outils de lecture accessibles à l’agent, intégrés et personnalisés. Ils sont filtrés par canal et pertinence pour l’objet de contexte, avec leur niveau et leur catégorie. |
| Actes | Les outils d’action accessibles à l’agent, avec leurs exigences de confirmation immédiatement visibles. |
| Suggestions | Les boutons de suggestion présentés au début de la discussion, filtrés selon le canal et l’objet de contexte. |
Un bandeau au-dessus des panneaux indique l’identité de l’agent, le canal de l’aperçu, l’éventuel objet de contexte et le budget de jetons configuré.
Conflits et score de configuration
En complément des quatre panneaux, l’aperçu applique des règles de détection des conflits. Il fournit :
- Un score de configuration de 0 à 100, qui résume l’état de la configuration.
- Une liste de conflits, classés selon leur gravité : élevée pour les problèmes susceptibles de bloquer l’agent, ou avertissement pour ceux à examiner.
La détection est gratuite et ne fait pas appel au modèle. Elle vise à repérer les erreurs évidentes — prompts manquants, outils sans affectation, canaux incohérents ou instructions contradictoires — avant les conversations réelles.
Sélectionner le canal et l’objet de contexte
Deux paramètres modifient les éléments chargés dans l’aperçu :
Canal
Le canal configuré sur l’agent est sélectionné par défaut. Vous pouvez choisir un autre canal à examiner ; les outils, prompts et suggestions sont alors filtrés de nouveau. Cela permet de vérifier que :
- Les outils prévus pour le canal API sont bien limités à ce canal
- Les prompts destinés à un widget externe ne se retrouvent pas par erreur dans les conversations internes
- Les suggestions du canal Communauté s’affichent sur ce canal et non sur Widget externe
Objet de contexte
Par défaut, aucun contexte d’enregistrement n’est sélectionné. Saisissez le nom API d’un objet pour voir ce que l’agent charge sur une page d’enregistrement de cet objet. L’aperçu applique les mêmes règles de pertinence qu’à l’exécution ; les outils limités à certains objets apparaissent ou disparaissent selon la valeur choisie.
Pour un agent utilisé sur plusieurs objets, changer d’objet de contexte permet de comparer sa configuration dans chaque cas, notamment si une page propose moins d’outils qu’une autre.
Suivre le budget de jetons
Le panneau Invites affiche un total cumulé des jetons estimés. Les prompts sont signalés en vert ou en rouge par rapport au budget de l’agent ; ceux qui font dépasser la limite sont clairement indiqués.
Cette estimation ne remplace pas le décompte réel à l’exécution, mais elle permet de repérer un dépassement après l’ajout d’un prompt. Après un essai réel, consultez les transactions de crédits pour vérifier la consommation facturée.
Un aperçu gratuit en lecture seule
- Consulter l’aperçu ne modifie aucune donnée. Son ouverture ne fait que lire les données, sans création, modification ou suppression d’enregistrements. L’exception volontaire est Modifier l'équipement : un administrateur peut exclure des outils, prompts ou suggestions de cet agent. L’enregistrement des exclusions met à jour sa définition en une seule opération et nécessite un droit de modification sur l’agent.
- Aucun appel au modèle. L’aperçu ne consomme pas de crédits. La détection des conflits utilise des règles exécutées dans Salesforce.
- Exécution sous l’utilisateur actuel. Les lectures de configuration et d’enregistrement soumises au mode utilisateur respectent ses autorisations. Les outils sont aussi décrits par leurs métadonnées : leur présence dans l’aperçu ne prouve pas que toutes leurs opérations seront autorisées pour un autre utilisateur.
Où trouver l’aperçu ?
Ouvrez une définition d’agent : le composant d’aperçu est intégré à sa page d’administration. Vous pouvez également y accéder depuis l’onglet d’administration REDA AI.
Différence avec le débogueur de conversations
L’aperçu montre ce que l’agent peut charger dans le contexte sélectionné. Le débogueur analyse les traces disponibles et une reconstruction de la configuration actuelle ; il ne constitue pas une copie exhaustive de ce que l’agent a chargé lors d’un ancien échange.
- Utilisez l’aperçu d’exécution pendant la création ou l’amélioration d’un agent, avant toute conversation.
- Utilisez le débogueur de conversations pour comprendre un problème observé dans une conversation réelle.
Sélection propre à chaque agent : Modifier l’équipement
Certains agents ont besoin d’un sous-ensemble précis des outils, actions, prompts et suggestions disponibles. Un outil personnalisé peut, par exemple, appliquer une validation métier spécifique. Son mode de partage, y compris un éventuel without sharing, doit être évalué séparément ; ce mode n’est pas requis pour un portail. Les outils standard create_record, update_record ou soql_query peuvent faire doublon avec ce parcours. Limitez les outils, prompts et suggestions au besoin réel de l’agent.
L’action Modifier l'équipement s’applique aux quatre catégories — Outils, Actes, Invites, Suggestions. Elle permet d’exclure des éléments pour un agent sans modifier les métadonnées livrées, les prompts ou les autres agents. Les éléments universels fournis avec le package et ceux du client peuvent tous être exclus.
La définition d’agent conserve trois listes d’exclusion : outils et actions ensemble, prompts, puis suggestions. À l’exécution, REDA AI applique ces listes avant d’assembler les instructions, le catalogue d’outils et les suggestions. Les éléments exclus ne sont pas transmis au modèle, mais restent visibles, grisés et marqués Exclu, dans l’aperçu pour permettre leur réintégration.
Utiliser Modifier l’équipement
- Ouvrez la définition d’agent contenant le composant d’aperçu d’exécution.
- Ouvrez l’un des onglets Invites, Outils, Actes ou Suggestions. Le bouton Modifier l'équipement se trouve dans la barre d’outils de chaque onglet.
- Cliquez sur Modifier l'équipement. Une case apparaît à côté de chaque élément des quatre onglets.
- Décochez les éléments à exclure pour cet agent. Ils deviennent grisés et portent la mention Exclu. Le récapitulatif de la barre d’outils s’actualise.
- Vous pouvez changer d’onglet librement : vos changements non enregistrés sont conservés pendant le mode de modification.
- Cliquez sur Sauvegarder l'équipement pour enregistrer toutes les exclusions en une seule opération, ou sur Annuler pour les abandonner.
Les exclusions affectent uniquement l’agent modifié. Les autres agents conservent leur sélection normale. Les nouveaux éléments installés avec le package sont disponibles par défaut pour chaque agent auquel leurs critères correspondent ; vous les excluez explicitement si nécessaire. Une nouvelle livraison d’outil, de prompt ou de suggestion n’est pas exclue automatiquement.
Gérez les listes avec Modifier l'équipement. Leur modification directe dans l’enregistrement contourne les contrôles de validation, de tri, de dédoublonnage et de suppression des espaces superflus réalisés par cette action.
Quand exclure un élément ?
- Un outil personnalisé remplace un outil standard — Si votre configuration possède, par exemple, un outil nommé
create_record_elevated, vérifiez sa validation métier et ses droits. Le modewithout sharingn’est pas une condition de déploiement. Excluezcreate_recorduniquement si le parcours approuvé doit passer par cet outil personnalisé. - L’agent ne doit jamais effectuer certaines actions — Par exemple, un agent de recherche en lecture seule ne doit pas disposer de
delete_recordouupdate_record. - Un prompt universel est inadapté à cet agent — Par exemple, des garde-fous longs qui font doublon avec des règles plus strictes déjà présentes dans son personnage. Vérifiez que la protection reste complète avant d’exclure le prompt pour récupérer du budget.
- Une suggestion n’est pas pertinente — Par exemple, « Afficher mes requêtes ouvertes » pour un agent commercial. Excluez-la afin de ne pas proposer une demande à laquelle l’agent ne peut pas répondre.
- Vous souhaitez réduire la taille du contexte — Moins d’éléments signifie moins de contenu transmis au modèle et moins de crédits par échange. Pour une mission précise, retirez les éléments inutilisés.
- Un élément provoque un comportement indésirable — Excluez-le temporairement pendant le diagnostic, puis réintégrez-le si nécessaire.
Bonnes pratiques
Consultez l’aperçu après chaque modification. C’est un moyen gratuit de vérifier les effets du changement, particulièrement lors du réglage des canaux et des objets de contexte.
Vérifiez chaque canal pertinent. Examinez séparément les canaux concernés par vos configurations d’outils et de prompts : un élément peut être correct sur un canal et mal filtré sur un autre.
Utilisez-le en démonstration. L’aperçu permet d’expliquer rapidement à un interlocuteur ce que fait l’agent, sans préparer une conversation réelle.
Traitez les conflits avant les essais. Corrigez les problèmes de gravité élevée et examinez les avertissements avant de consommer des crédits dans une conversation de test.
Considérez les estimations comme des repères. Pour décider des coûts de production, lancez une vraie conversation et consultez les crédits réellement consommés.
Configurer des instructions réutilisables
Les Prompts exclusifs affectent des instructions réutilisables aux agents choisis. Vérifiez Prompt exclusif et Résumé sur Prompt personnalisé, puis Définition d’agent, Prompt personnalisé, Actif et Mode de chargement sur l’affectation. À la demande nécessite l’outil de prompts de contexte dans l’agent. Les portées avec types d’enregistrement entre crochets partagent les mêmes règles, y compris dans les aperçus. L’ordre des prompts et outils est déterministe et l’aperçu peut utiliser un identifiant réel. Les instructions linguistiques suivent le message sur API/canaux externes ; les variables utilisateur ne s’appliquent que dans les contextes prévus. Préservez vos prompts personnalisés lors de la fusion des valeurs actuelles.
Questions fréquentes
Non. Il n’appelle pas le modèle d’IA. Vous pouvez l’ouvrir aussi souvent que nécessaire.
Vérifiez que le canal de l’aperçu correspond à celui de l’outil, que l’identifiant d’agent de l’outil correspond ou est vide, et que l’outil est actif. Changer de canal dans l’aperçu permet souvent de repérer le filtre en cause.
Les estimations reposent sur le nombre de caractères. Le décompte réel à l’exécution fait référence. L’aperçu repère les dépassements évidents, mais ne fournit pas une mesure exacte.
Oui. Les lectures soumises au mode utilisateur dépendent des autorisations de la personne qui consulte l’aperçu. La présence d’une définition d’outil ne garantit toutefois pas que chaque opération sera permise pour elle ou pour un autre rôle. Testez le parcours réel avec les droits prévus.
Il reflète des conflits plus nombreux ou plus graves. Consultez leur liste pour comprendre les causes ; le score ne constitue qu’un résumé.
Oui. Les exclusions sont enregistrées sur la définition de l’agent concerné. Les autres agents conservent les outils, actions, prompts et suggestions auxquels ils ont normalement accès. Il n’existe pas de liste d’interdiction globale.
C’est volontaire. Il présente tous les éléments qui pourraient être chargés, afin de montrer les exclusions et de permettre leur réintégration. Les éléments exclus sont grisés et marqués Exclu. À l’exécution, ils ne sont pas transmis au modèle.
Il se concentre sur les prompts, outils, actions, suggestions et conflits. Pour les champs de contexte, consultez Comprendre les champs de contexte et l’optimiseur des champs de contexte. Le débogueur aide à examiner les traces disponibles d’une conversation ; il ne restitue pas nécessairement toutes les données de contexte transmises à l’époque.
Prochaines étapes
Consultez Créer et améliorer un agent avec l’IA pour une analyse assistée, ou Configurer les paramètres d’un agent pour les champs que reflète l’aperçu.