Configurer les paramètres 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.
Propriétés essentielles
| Propriété | Type | Description |
|---|---|---|
| Nom d'affichage | Texte | Nom présenté dans l’interface de discussion. Choisissez un nom descriptif, comme « Assistant du pipeline commercial » plutôt que « Agent 1 ». |
| Canal | Liste de sélection | Détermine le déploiement et l’authentification de l’agent : Interne, Widget externe, Communauté ou API. |
| Est actif | Case à cocher | Si la case est décochée, l’agent est désactivé. Il affiche un message d’indisponibilité et ne répond pas. |
| Personnage | Zone de texte longue (5 000) | Prompt système d’ouverture définissant le rôle, le ton et la mission. Exemple : « Vous êtes un assistant commercial chaleureux qui aide à conclure les affaires… » |
| Priorité | Nombre | Si plusieurs agents correspondent au même emplacement, celui dont la priorité est la plus élevée est affiché. Valeur fournie : 50. |
Messages, jetons et conversations
| Propriété | Type | Rôle |
|---|---|---|
| Longueur maximale du message | Nombre | Nombre maximal de caractères d’un message dans une session de chatbot externe. Valeur fournie : 2 000 caractères. Limite les messages excessivement longs et leur consommation. |
| Messages de session maximum | Nombre | Nombre maximal de messages dans une session de chatbot externe. Une fois la limite atteinte, le visiteur doit démarrer une nouvelle conversation. Valeur fournie : 50. Les conversations enregistrées ne sont pas supprimées pour autant. |
| Délai d'expiration de la session (minute | Nombre | Libellé fourni pour le délai d’inactivité, en minutes, avant expiration d’une session externe. Valeur par défaut : 30 minutes. Le délai repart à chaque message utilisateur. |
| Budget de complexité rapide | Nombre | Ce champ limite la quantité de prompt système assemblée, pas la consommation totale d’un échange. Les prompts personnalisés sont ajoutés dans l’ordre de tri jusqu’au budget, et le texte Personnage y compte. Valeur fournie : 8 000. Le libellé français fourni est « Budget de complexité rapide » ; il correspond au budget de complexité des prompts, appelé Token Budget dans les anciens documents. Le réduire peut exclure silencieusement les prompts qui ne tiennent plus dans le budget ; il ne limite pas la longueur des réponses. |
| Utiliser le streaming | Case à cocher | Désactivé par défaut. Lorsqu’il est activé, les appels d’IA de l’agent reçoivent les jetons en flux continu, ce qui maintient la connexion et évite les délais de lecture dépassés. Recommandé pour les fichiers, le raisonnement complexe ou les longues réponses. C’est la case à activer lorsqu’un message REDA AI recommande le streaming pour éviter une expiration. |
| Démarrage sur le chargement | Case à cocher | Désactivé par défaut. Lorsqu’il est activé, le composant de discussion envoie un message initial dès son chargement sur une page d’enregistrement. L’agent examine alors l’enregistrement et propose des informations, actions ou risques sans attendre une question. |
| Fenêtre de conversation (heures) | Nombre | Une valeur positive définit la fenêtre de reprise automatique en heures. Une valeur vide utilise le défaut de l’organisation, initialement 30 minutes ; 0 désactive la reprise automatique. La conversation doit correspondre au canal, à l’agent, à l’utilisateur et au contexte d’enregistrement exigés par ce canal. Consultez la section sur la continuité. |
Performances et coûts
Ces paramètres contrôlent le coût de fonctionnement. Ils sont facultatifs : selon le champ, une valeur vide reprend la valeur globale ou le comportement par défaut décrit ci-dessous. Ils figurent dans la section Performances et contrôle des coûts, sauf indication contraire.
| Propriété | Type | Rôle |
|---|---|---|
| Niveau de traitement | Liste de sélection | Standard , Efficace ou Économique . Vide équivaut à Standard.
|
| Consentement du niveau Économique | Case à cocher | Obligatoire pour utiliser Économique. Lisez les conditions de traitement des données affichées et cochez la case uniquement si votre organisation les accepte. Sans consentement, les demandes Économique sont refusées ; REDA AI ne change pas silencieusement de niveau. |
| Mise en cache améliorée | Case à cocher | Conserve le contexte stable de l’agent, ses instructions et outils, en cache pendant une heure au lieu de cinq minutes. Une conversation reprise après une pause bénéficie ainsi du cache. Activez-la pour les agents conversationnels ; laissez-la désactivée pour les agents autonomes terminant leur travail d’un seul trait. REDA prend en charge le surcoût de stockage du cache. |
| Jetons de sortie max. | Nombre | Limite la longueur d’une réponse. Vide, il utilise la valeur globale. À distinguer du budget de complexité des prompts, qui limite les instructions envoyées à l’IA ; ce champ limite ce qu’elle renvoie. |
| Budget de jetons d'historique | Nombre | Quantité de conversation précédente renvoyée à chaque échange pour préserver la mémoire de l’agent. Vide, il utilise la valeur globale. C’est souvent le principal levier de coût d’un agent conversationnel à fort volume. Réduisez-le progressivement : trop bas, il fait perdre le contexte antérieur. |
| Recherches web max. | Nombre | Nombre de recherches web autorisées par réponse. Vide, il utilise la valeur globale. S’applique uniquement si Autoriser la recherche Web est activé ; chaque recherche ajoute un coût aux jetons habituels. |
| Profondeur max. de continuation | Nombre | Nombre de suites automatiques après une action sur les canaux Widget externe et Communauté. Vide, il utilise la valeur globale ; 0 désactive la continuation. Figure dans la section Commandes externes, car il concerne ces canaux. |
| Contexte d'exécution | Liste de sélection | Utilisateur par défaut, ou Système. S’applique uniquement aux agents API. Système contourne les autorisations d’objet et de champ pour les automatisations, mais n’élargit pas l’accès aux enregistrements : le partage reste appliqué. Figure dans Contexte et Persona, sous Canal. Consultez Accès aux données et autorisations avant tout changement. |
Outils et fonctionnalités
| Propriété | Type | Description |
|---|---|---|
| Mode Outils | Liste de sélection | Toujours : charger les outils sur chaque page. Pages d'enregistrement uniquement : les charger seulement sur les pages de détail, afin d’économiser des jetons sur l’accueil et les listes. |
| Nombre maximal d'outils | Nombre | Nombre d’outils proposés au modèle à chaque échange, de 1 à 100. Vide équivaut à 25. Chaque outil est décrit au modèle à chaque message, qu’il soit utilisé ou non ; une longue liste augmente donc le coût. Réduisez-la pour un agent qui a besoin de peu d’outils. |
| Nombre maximal d'itérations d'outils | Nombre | Nombre d’étapes d’IA dans un échange pour enchaîner les outils, de 3 à 25. Vide équivaut à 6. Augmentez-le pour un travail réellement complexe ; réduisez-le pour limiter les boucles inutiles. Il remplace l’ancien paramètre global du même nom, qui n’est plus utilisé. |
| Raisonnement approfondi | Liste de sélection | Profondeur de réflexion : Désactivé par défaut, Faible, Moyen, Élevé, Très élevé ou Maximal. Les niveaux supérieurs peuvent améliorer les analyses complexes au prix de délais et de crédits supplémentaires. Vide équivaut à Désactivé. Consultez Raisonnement approfondi. |
| Autoriser les requêtes automatisées | Case à cocher | Permet aux flux Salesforce et automatisations d’appeler l’agent. Requis pour les appels par flux. |
| Objets de contexte par défaut | Texte | Liste de noms API d’objets séparés par des virgules, comme « Account, Opportunity, Contact », sur lesquels l’agent travaille principalement. |
| Autoriser la recherche Web | Case à cocher | Permet à l’agent de rechercher des informations actuelles sur le web pendant la conversation. Chaque recherche ajoute des crédits au coût de base. Désactivé par défaut. Consultez Recherche web. |
| Autoriser le téléchargement de fichiers | Case à cocher | Ce libellé correspond à l’autorisation de joindre des fichiers à la conversation : PDF, CSV, images, texte ou JSON. L’agent peut lire et traiter leur contenu. Activé par défaut. Consultez Joindre des fichiers. |
| Types de fichiers pris en charge | Texte | Liste des noms développeur d’outils de traitement de fichiers autorisés, séparés par des virgules, par exemple « import_purchase_invoice,import_rent_roll ». Vide autorise tous ces outils. Ce champ ne reçoit pas des extensions comme pdf ou csv ; les extensions autorisées se règlent globalement dans les paramètres de plateforme. |
| Actions de fichiers à exécution automati | Case à cocher | Libellé fourni pour l’exécution automatique des actions de création ou de mise à jour issues du traitement de fichiers en mode automatisé. Concerne les appels Flow et le service e-mail. Désactivé par défaut. |
Collaboration entre agents
Ces réglages contrôlent la participation à la délégation entre agents, lorsqu’un agent en consulte un autre pendant la conversation. Les autorisations de consultation sont désactivées par défaut : une mise à niveau ne les active pas sur les agents existants.
| Propriété | Type | Description |
|---|---|---|
| Appelable par un agent | Case à cocher | Permet aux autres agents de consulter celui-ci. Désactivé par défaut. Autoriser les requêtes automatisées doit également être coché, car une consultation est une demande automatisée. Si un réglage manque, l’agent appelant reçoit un message qui le précise. |
| Profondeur maximale d'appel d'agents | Nombre | Se règle sur l’agent qui pose la question. Limite les niveaux de consultation : 1, valeur par défaut, permet de consulter un agent sans qu’il en consulte un troisième ; 0 interdit toute consultation. Vide équivaut à 1. Chaque niveau ajoute du temps et des crédits ; augmentez-le uniquement après avoir constaté un besoin. |
Paramètres du widget externe
Ces paramètres concernent le canal Widget externe, pour un agent déployé sur un site web.
| Propriété | Type | Description |
|---|---|---|
| Origines autorisées | Texte | Liste des origines web autorisées, séparées par des virgules, par exemple « https://example.com, https://www.example.com ». Renseignez les origines avec leur protocole et sans barre oblique finale pour limiter l’intégration aux sites prévus. Une valeur vide autorise toutes les origines. |
| Message de bienvenue externe | Zone de texte longue | Message affiché à l’ouverture du widget externe. Exemple : « Bonjour ! Comment puis-je vous aider aujourd’hui ? » |
| Démarrage sur le chargement | Case à cocher | Ce champ déclenche le message initial sur les pages d’enregistrement internes. Il ne doit pas être confondu avec les options d’ouverture automatique du widget externe, qui dépendent de son intégration au site. |
Apparence
| Propriété | Type | Description |
|---|---|---|
| Nom de l'icône | Texte | Nom de l’icône Salesforce Lightning Design System affichée avec l’agent. Valeur fournie : « standard:bot ». Autre exemple : « standard:service_resource ». Consultez la documentation des icônes SLDS. |
| Image de mascotte | URL d’image | URL facultative d’une mascotte ou d’un avatar affiché dans la discussion. Utilisez une image publique ou une ressource statique Salesforce. Une image d’au moins 200 × 200 pixels est recommandée. |
Limites de débit
| Propriété | Type | Description |
|---|---|---|
| Limite de tarif horaire (total des agent | Nombre | Malgré ce libellé fourni, il s’agit du nombre maximal de messages par heure pour l’agent externe, toutes sessions confondues, et non d’un tarif ni d’une limite par utilisateur. Valeur fournie : 500. |
| Limite de débit par session (msg/min) | Nombre | Nombre maximal de messages par minute et par session de chatbot externe. Valeur fournie : 10. Ce n’est pas le total de messages autorisés dans toute la session. |
Gestion des données
| Propriété | Type | Description |
|---|---|---|
| Durée de conservation des archives | Nombre | Nombre de jours de conservation des conversations avant leur archivage automatique. Vide reprend la valeur globale de 180 jours, configurable dans les paramètres de plateforme. Minimum par agent : 60 jours. |
| Passer l'archivage | Case à cocher | Exclut les conversations de cet agent de l’archivage automatique. Utilisez-le si une conservation plus longue est nécessaire selon votre politique de données. |
Parcours de configuration
- Ouvrez la définition d’agent — Accédez à l’enregistrement à configurer.
- Vérifiez les éléments essentiels — Contrôlez le nom d’affichage, le canal et le personnage.
- Fixez les limites adaptées — Réglez les limites de messages externes et le budget de complexité des prompts selon l’usage.
- Autorisez les automatisations — Activez Autoriser les requêtes automatisées pour un agent appelé par flux, sur le canal API.
- Réglez les paramètres du canal — Pour Widget externe, configurez les origines autorisées et le message de bienvenue.
- Personnalisez l’apparence — Ajoutez si nécessaire une icône et une image de mascotte.
- Fixez les limites de débit — Limitez les usages excessifs sur les canaux concernés.
- Testez — Enregistrez, puis testez l’agent en sandbox.
Conseils d’optimisation
Distinguez les budgets : le budget de complexité, de 8 000 par défaut, limite les instructions assemblées et peut exclure des prompts si vous le réduisez. Pour maîtriser le coût des conversations, examinez plutôt le budget d’historique, la longueur maximale des réponses et les outils chargés. Ajustez progressivement, puis contrôlez les résultats et les crédits réels.
Utilisez Pages d'enregistrement uniquement pour Mode Outils — Si les outils ne sont utiles que sur les pages d’enregistrement, ce réglage évite de les charger sur l’accueil et les listes, ce qui réduit les jetons et le coût.
Choisissez un délai de session raisonnable — Pour les sessions externes, 30 minutes convient à de nombreux usages. Adaptez-le à la durée habituelle des pauses entre les messages.
Limitez les longues sessions externes — Messages de session maximum peut obliger le visiteur à démarrer une nouvelle conversation après le nombre défini, par exemple 50.
Configuration par canal
Pour les utilisateurs Salesforce. Choisissez Toujours ou Pages d'enregistrement uniquement pour Mode Outils, attribuez les outils autorisés et adaptez le personnage aux besoins de l’équipe.
Pour les visiteurs web. Renseignez les origines autorisées et le message de bienvenue externe, puis limitez les outils à ceux qui conviennent aux invités.
Pour les utilisateurs du portail. Les outils et champs de contexte respectent leurs autorisations. Vérifiez la configuration afin d’éviter tout accès non prévu.
Exemples de configuration
| Scénario | Réglages proposés |
|---|---|
| Assistant commercial — Interne | Mode Outils : Toujours · Budget de complexité : 2 500, à vérifier dans l’aperçu pour conserver toutes les instructions nécessaires |
| Assistant de site web — Widget externe | Origines autorisées : https://your-domain.com · Budget de complexité : 1 500, à valider · Limite horaire totale : 10 messages |
| Agent de portail client — Communauté | Mode Outils : Pages d'enregistrement uniquement · Budget de complexité : 2 000, à valider · Passer l'archivage : désactivé |
| Agent d’intégration — API | Autoriser les requêtes automatisées : activé · Budget de complexité : 3 000, à valider · Les limites de débit du widget externe ne s’appliquent pas à ce canal |
Comprendre le changement de crédits Économique
L’usage ordinaire Économique applique désormais un multiplicateur de 0,40 au tarif de base des crédits. À quantités de jetons et tarifs identiques, un exemple de 100 crédits de base consomme 40 crédits Économique. Avec l’ancien multiplicateur de 0,10, il en consommait 10 : le débit est quatre fois l’ancien débit Économique et 60 % inférieur au tarif de base. La consommation change, pas le prix de l’abonnement. La pré-extraction de fichiers est facturée séparément au plein tarif. Un repli de fournisseur peut utiliser un autre niveau effectif ; consultez la transaction réelle au lieu d’appliquer 0,40 à toute opération mixte. Les nouvelles transactions enregistrent Niveau de traitement ; l’historique n’est pas complété rétroactivement. Économique exige consentement et licence/configuration compatibles. Sans consentement, la demande est refusée, sans traitement silencieux à un autre niveau.
Revoir la continuité des conversations
Fenêtre de conversation (heures) vide utilise désormais le réglage de l’organisation, initialement 30 minutes. Une valeur positive fixe la fenêtre de l’agent ; 0 désactive la reprise automatique. La correspondance dépend du canal : API utilise agent et enregistrement ; Interne/MCP authentifié utilise agent, utilisateur et contexte d’enregistrement pertinent. Communauté utilise le réglage partagé plutôt que le délai de session externe. Le chat des pages d’accueil, d’application et de la barre d’utilitaires peut reprendre une conversation éligible. Les identifiants explicites restent soumis aux contrôles de leur route. Utilisez 0 si vous comptiez sur une valeur vide pour démarrer une nouvelle conversation. Les autorisations empaquetées corrigent aussi l’accès Interne et Communauté.
Questions fréquentes
Les prompts qui ne tiennent plus dans le budget ne sont pas assemblés. Cela peut retirer des instructions importantes ; ce réglage ne tronque pas directement la réponse. Vérifiez les prompts chargés dans l’aperçu d’exécution et distinguez ce budget du champ Jetons de sortie max., qui limite la réponse.
Oui, mais cela peut casser les déploiements existants. Un agent interne placé sur une page ne fonctionnera plus à cet emplacement si vous passez son canal à Widget externe. Choisissez le canal avant le déploiement.
Sur les sessions de chatbot externes, Messages de session maximum limite le nombre de messages, tandis que le délai d’expiration met fin à une session après une période d’inactivité. Une nouvelle conversation est ensuite nécessaire ; les anciens enregistrements restent conservés selon la politique d’archivage.
Non. Ce réglage concerne Widget externe. Les agents internes utilisent la session Salesforce et n’ont pas besoin de ces restrictions d’origine.
Prochaines étapes
Apprenez à activer et désactiver les agents, ou explorez la gestion des prompts pour affiner leur comportement.