Référence des paramètres de la plateforme
Les paramètres, groupe par groupe
Ce catalogue couvre les 34 paramètres des six groupes du panneau Administrateur IA REDA → Configuration. Les valeurs affichées par défaut dans ce panneau peuvent différer des valeurs de repli du moteur ou des réglages déjà enregistrés dans votre organisation. Les sections suivantes précisent ces différences et les paramètres gérés ailleurs.
Système et notifications
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| REDA Activé par l'IA | Activé | Interrupteur principal des interactions IA. Le libellé « REDA Activé par l’IA » désigne ici l’activation de REDA AI ; le désactiver bloque les appels IA concernés, sans supprimer les données ni tous les traitements de maintenance. |
| Suivi des réponses par e-mail | Désactivé | Active le suivi des réponses aux e-mails concernés par les actions planifiées. |
| Courriel de l'expéditeur de la notification | Vide | Adresse d’expédition des notifications d’incident. Elle doit correspondre à une adresse e-mail d’organisation vérifiée dans Salesforce. |
Canaux externes
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| API de bot externe | Activé | Active l’API du chatbot externe. Une intégration WhatsApp ou SMS nécessite en plus un connecteur configuré ; ce réglage ne crée pas ce connecteur. |
| Plafond de crédit quotidien pour les bots externes | 500 | Plafond quotidien des crédits des appels du bot externe. La valeur 0 supprime ce plafond de canal, sans supprimer la limite des crédits disponibles de la licence. |
| Chat du portail communautaire | Activé | Active le chatbot des portails Experience Cloud configurés pour REDA AI. |
| Bot communautaire - Plafond de crédits quotidien | 2000 | Plafond quotidien des crédits du chatbot communautaire. La valeur 0 supprime ce plafond de canal ; les crédits de la licence restent nécessaires. |
Limites de réponse de l’IA
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Jetons de sortie maximum | 4000 | Budget maximal de sortie pour les réponses standard, également utilisé dans le traitement de fichiers. C’est un plafond, pas une quantité systématiquement facturée : la consommation dépend des jetons réellement traités. Le panneau propose 4 000 ; en l’absence de valeur exploitable, le moteur utilise 2 000. Le minimum est 1 000. La capacité du modèle dépend de la configuration : 8 192 n’est pas un plafond universel garanti. |
| Créateur d'agents Jetons maximum | 12000 | Budget du créateur d’agents assisté par IA, réparti à 60 % pour la première analyse et à 40 % pour la seconde. Avec un budget effectif de 12 000 jetons, cela donne 7 200 puis 4 800. Pour une configuration complexe, vous pouvez envisager 16 000 après avoir constaté des résultats incomplets et vérifié les limites de la version installée ; un budget supérieur ne garantit pas une meilleure configuration. |
| Optimiseur d'invites Nombre maximal de jetons | 4096 | Budget de sortie pour l’optimisation des prompts et des champs de contexte. |
| Créateur d'outils Jetons maximum | 4096 | Budget de sortie pour la génération et l’optimisation des outils. Les définitions complexes peuvent nécessiter davantage de jetons ; contrôlez le résultat avant de les appliquer. |
| Jetons maximum du débogueur | 3000 | Budget de sortie pour le débogage des conversations et l’analyse des incidents. |
| Détecteur de conflits Nombre maximal de jetons | 1024 | Budget de sortie de l’analyse des conflits entre prompts. |
| Générateur d'invites Jetons max | 2048 | Budget de sortie pour les prompts produits par le générateur IA. |
| Nombre maximal de jetons pour l'itération de l'outil | 1000 | Budget de sortie des tours intermédiaires de la boucle d’outils, destiné aux appels d’outils plutôt qu’à une réponse longue. |
| Salutations Max Tokens | 800 | Budget de sortie des courts messages de début de conversation, par exemple « Bonjour ». |
| Plafond de tokens du Raisonnement approfondi | 24 000 | Plafond de sortie total, réponse et raisonnement compris, lorsque le raisonnement approfondi est activé. Il borne le budget supplémentaire associé au niveau choisi, sans garantir un délai de réponse précis. |
| Nombre maximal de tentatives d'API | 3 | Limite des tentatives pour les réponses de l’API du modèle indiquant une limitation de débit (429) ou une surcharge (529). Elle ne règle pas les reprises des actions planifiées. |
| Recherche Web Nombre maximal d'utilisations | 5 | Nombre maximal de recherches web par tour, pour les agents autorisant cette fonction. Les recherches peuvent entraîner une consommation supplémentaire de crédits. |
Limites des requêtes et des données
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Nombre maximal de lignes de requête | 200 | Valeur LIMIT ajoutée aux requêtes SOQL des outils lorsqu’elles n’en possèdent pas déjà, sous réserve des exceptions pour les agrégats. |
| Nombre maximal de lignes affichées | 50 | Nombre maximal de lignes incluses dans le résultat formaté transmis au modèle. Les lignes supplémentaires ne sont pas envoyées par ce résultat ; le total et un avis signalent la limite. |
| Longueur maximale des résultats de requête | 15000 | Longueur maximale, en caractères, d’un résultat d’outil transmis au modèle. Une limite plus élevée peut apporter davantage de contexte et augmenter la consommation de jetons. |
| Durée de conservation des archives | 180 | Durée en jours utilisée pour sélectionner les données anciennes à archiver. Il ne s’agit pas d’un délai universel de suppression après archivage ; consultez les règles de conservation ci-dessous. |
| Fenêtre de déduplication des incidents | 0 (désactivée : chaque incident est journalisé) | Fenêtre, en minutes, durant laquelle des incidents de même classe, méthode et type d’erreur peuvent être dédupliqués. |
Optimisation des conversations
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Budget de tokens de l'historique | 30 000 | Budget estimé des jetons d’historique. Le moteur conserve les messages complets les plus récents qui tiennent dans ce budget et retire les anciens messages entiers. Valeur de repli : 30 000 ; minimum : 4 000. Un budget plus grand peut augmenter le contexte et le coût par tour. |
| Seuil de caractères de salutation | 20 | Seuil de longueur utilisé pour les messages courts au début d’une nouvelle conversation ; ils reçoivent le budget réduit des salutations. |
Traitement des fichiers et diffusion en continu
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Taille maximale du fichier (Mo) | 5 Mo | Taille maximale autorisée par les parcours d’import concernés. Les limites propres à Salesforce, au canal et au type de fichier peuvent aussi s’appliquer. |
| Extensions de fichiers autorisées | pdf,csv,png,jpg,jpeg,txt,json | Liste d’extensions autorisées, séparées par des virgules. |
| Nombre maximal de caractères CSV | 50000 | Longueur maximale du contenu CSV. Au-delà du seuil configuré, le traitement concerné renvoie une erreur. |
| Multiplicateur de crédit pour le traitement des fichiers | 2 | Multiplie le budget maximal de sortie des traitements de fichiers. Par exemple, 2 000 jetons × 2 donnent un budget de 4 000. Malgré son libellé, ce paramètre ne signifie pas que chaque fichier est systématiquement facturé deux fois plus. |
| Seuil de distribution des fichiers (Ko) | 1 300 Ko | Seuil au-delà duquel certains fichiers binaires sont transmis au modèle au moyen d’un lien public temporaire. |
| Expiration du lien de distribution (minutes) | 30 | Durée de validité prévue des liens temporaires. Le package prévoit aussi leur nettoyage après les appels concernés et par une tâche de maintenance. |
| Traitement des fichiers de messagerie électronique | Désactivé | Autorise le traitement des pièces jointes reçues par le service de messagerie. Un agent de traitement des e-mails doit être configuré. |
| Outils d'administration Always Stream | Activé | Demande aux outils d’administration concernés d’utiliser la diffusion en continu pour réduire le risque d’expiration des appels longs. Cela ne garantit pas l’absence d’erreur réseau. |
Définition de l’agent → Nombre maximal d’itérations d’outils, dont la valeur par défaut est 6 : cinq tours d’outils puis un tour de réponse textuelle. L’ancien paramètre global est obsolète et n’est plus lu pour cette limite.Interrupteurs principaux
Ces paramètres activent ou désactivent des fonctions. Dans les métadonnées, 1 signifie activé et 0 désactivé.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| REDA Activé par l'IA | 1 |
Interrupteur principal des appels IA de REDA AI. Il ne supprime pas les données et n’arrête pas nécessairement les tâches de maintenance indépendantes. |
| API de bot externe | 1 |
Active le chatbot externe. Sa configuration nécessite aussi un site Salesforce et les accès invités appropriés. Lorsqu’il est désactivé, les appels du chatbot externe sont rejetés. |
| Chat du portail communautaire | 1 |
Active le chatbot communautaire. Lorsqu’il est désactivé, les appels de ce canal sont rejetés. |
| Traitement des fichiers de messagerie électronique | 0 |
Autorise le traitement des pièces jointes reçues par le service de messagerie. Si le paramètre est désactivé, les pièces jointes sont ignorées, mais un e-mail correctement routé peut toujours parvenir à l’agent sous forme de conversation. Ce n’est pas l’interrupteur du canal e-mail. |
| Suivi des réponses par e-mail | 0 |
Active le suivi des réponses pour les actions planifiées concernées. Configurez dans l’organisation un flux déclenché après la création d’un EmailMessage entrant, qui appelle l’action Apex « Process Inbound Emails ». Vérifiez le parcours de messagerie améliorée et la création effective des EmailMessage ; ce paramètre ne crée pas le flux. |
| Outils d'administration Always Stream | 1 |
Utilise la diffusion en continu pour les outils d’administration concernés, indépendamment du réglage de l’agent. Cette option vise à réduire les expirations pendant les opérations assistées par IA. |
Clés de licence
Ces paramètres contiennent les valeurs de licence gérées par l’activation. Ils servent à autoriser les appels IA et ne doivent pas être modifiés manuellement. Consultez Activer la licence.
Pour remplacer la licence, utilisez son parcours d’activation dans l’onglet d’administration. Le package met à jour les paramètres nécessaires ; attendez la confirmation de fin du déploiement.
Traitement des fichiers
Ces paramètres définissent les formats acceptés, leur taille et la transmission des fichiers volumineux au modèle. Consultez Traitement des documents pour le parcours complet.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Extensions de fichiers autorisées | pdf,csv,png,jpg,jpeg,txt,json |
Extensions de fichiers autorisées à l’import, séparées par des virgules. Les parcours concernés rejettent les extensions absentes de la liste. |
| Taille maximale du fichier (Mo) | 5 |
Taille maximale d’import, en mégaoctets, sous réserve des autres limites du canal et de Salesforce. |
| Nombre maximal de caractères CSV | 50000 |
Nombre maximal de caractères du contenu CSV. Un fichier dépassant la limite provoque une erreur dans le traitement concerné. Le panneau impose un minimum : ne supposez pas que la valeur 0 désactive cette limite. |
| Seuil de distribution des fichiers (Ko) | 1300 |
Seuil en kilo-octets au-delà duquel les fichiers binaires concernés, comme les PDF et les images PNG/JPG, utilisent un lien public temporaire destiné au modèle. Les fichiers texte suivent leur propre traitement. |
| Expiration du lien de distribution (minutes) | 30 |
Durée de validité du lien temporaire, en minutes. L’expiration complète le nettoyage prévu après l’appel du modèle et par la tâche périodique ; vérifiez les journaux si des liens persistent. |
| Multiplicateur de crédit pour le traitement des fichiers | 2 dans le panneau | Augmente le budget de sortie des traitements utilisant des fichiers. Il s’agit d’un réglage global, pas d’un multiplicateur de prix à régler séparément sur chaque agent. Adaptez-le aux extractions attendues et observez la consommation réelle. |
Plafonds de crédits
Les plafonds quotidiens limitent la consommation des canaux exposés aux visiteurs. Ils s’ajoutent aux limites de la licence : ils ne réservent pas des crédits distincts. Consultez Comprendre les crédits.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Plafond de crédit quotidien pour les bots externes | 500 |
Plafond quotidien cumulé du chatbot externe, tous agents et sessions concernés confondus. La valeur 0 supprime ce plafond, mais les crédits de licence disponibles restent limitants. |
| Bot communautaire - Plafond de crédits quotidien | 2000 |
Plafond quotidien cumulé du chatbot communautaire. Une valeur vide ou 0 supprime ce plafond. Le compteur du canal est distinct de celui du chatbot externe ; les deux utilisent les crédits disponibles de la même licence. |
Historique et contexte des conversations
Le budget détermine la quantité d’historique présentée au modèle à chaque tour. REDA AI conserve les messages complets les plus récents qui tiennent dans le budget estimé, afin de ne pas couper un appel d’outil ou son résultat au milieu. Réduire ce budget peut diminuer le coût et le contexte disponible.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Budget de tokens de l'historique | 30000 |
Budget estimé d’historique par requête. Les anciens messages sont retirés entiers lorsque le budget ne permet plus de les inclure. Valeur de repli : 30 000 jetons ; minimum : 4 000. |
| Profondeur max. de continuation | 3 |
Réglage de l’agent pour les tours automatiques de suivi après une action exécutée sur les canaux Widget externe et Communauté. Il borne ces continuations ; il ne figure pas parmi les 34 paramètres globaux du panneau. |
Exécution des agents
Ces limites règlent les budgets de réponse et le nombre de tours de la boucle d’outils. Certaines appartiennent à l’agent, d’autres à la plateforme.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Jetons de sortie maximum | 4 000 dans le panneau ; repli 2 000 |
Budget maximal de réponse, avec un minimum de 1 000. Le moteur ne lui impose pas le plafond universel de 4 096 parfois cité. Les limites du modèle et les réglages de l’agent restent applicables ; une valeur plus élevée autorise une réponse plus longue sans imposer sa consommation intégrale. |
| Nombre maximal d’itérations d’outils | 6 |
Réglage par agent : N−1 tours d’outils puis un tour textuel forcé. La plage prise en charge est de 3 à 10. Plus de tours peuvent permettre des opérations complexes, mais aussi consommer davantage de crédits. |
| Nombre maximal de jetons pour l'itération de l'outil | 1 000 | Budget de sortie des tours intermédiaires de la boucle d’outils. Il limite la taille des appels d’outils pour contrôler la consommation. |
| Seuil de caractères de salutation | 20 |
Seuil de longueur des messages courts au début d’une conversation. Plage : 5 à 100 caractères. Ces messages utilisent le budget réduit associé aux salutations. |
| Salutations Max Tokens | 800 |
Budget de sortie des messages courts au début d’une conversation. Plage : 400 à 2 000 jetons. |
Requêtes et affichage
Ces réglages limitent les résultats transmis au modèle et leur présentation à l’utilisateur.
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Nombre maximal de lignes de requête | 200 |
Valeur LIMIT ajoutée lorsqu’une requête SOQL d’outil n’en contient pas déjà. Le traitement prévoit des exceptions pour les requêtes d’agrégation ; ce n’est pas une limite absolue imposée à toute requête personnalisée. |
| Longueur maximale des résultats de requête | 15000 |
Longueur maximale en caractères d’un résultat de requête sérialisé transmis à l’agent. Les résultats trop longs peuvent être tronqués ; l’agent ne dispose alors pas nécessairement de toutes les lignes ou colonnes. |
| Nombre maximal de lignes affichées | 50 |
Nombre maximal de lignes sérialisées dans le résultat de requête transmis au modèle. Le résultat contient le nombre total et un avis lorsque cette limite retire des lignes ; le modèle ne reçoit pas automatiquement les autres lignes. Ce plafond est distinct du nombre de lignes interrogées et de la limite de longueur du résultat. |
Recherche web
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Recherche Web Nombre maximal d'utilisations | 5 |
Nombre maximal de recherches web autorisées au modèle par tour de conversation, lorsque cette fonction est activée pour l’agent. |
Fonctions IA d’administration : budgets de sortie
Chaque fonction assistée par IA dispose d’un budget de réponse. L’augmenter permet une sortie plus longue, mais ne garantit ni sa qualité ni une augmentation proportionnelle du coût.
| Paramètre | Valeur par défaut | Utilisation |
|---|---|---|
| Créateur d'agents Jetons maximum | 12000 |
Optimiser l’agent grâce à l’IA : analyse de plusieurs parties de la configuration, avec un budget plus important. |
| Créateur d'outils Jetons maximum | 4096 |
Génération et optimisation de définitions d’outils SOQL Template, File Mapping ou Apex Class. |
| Générateur d'invites Jetons max | 2048 |
Génération de prompts à partir d’une description du comportement attendu de l’agent. |
| Optimiseur d'invites Nombre maximal de jetons | 4096 |
Optimiseur de prompts et optimisation des champs de contexte. |
| Jetons maximum du débogueur | 3000 |
Débogueur de conversations et analyse des incidents avec l’IA. |
| Détecteur de conflits Nombre maximal de jetons | 1024 |
Analyse assistée par IA des conflits entre les prompts, les outils et les champs de contexte d’un agent. |
Réseau et nouvelles tentatives
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Nombre maximal de tentatives d'API | 3 |
Limite des tentatives d’appel HTTP pour les réponses 429 ou 529 de l’API du modèle. Ce paramètre ne règle pas les reprises d’exécution des actions planifiées. |
Notifications
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Courriel de l'expéditeur de la notification | Vide | Adresse d’expédition des notifications d’incident. Configurez aussi une adresse e-mail d’organisation correspondante dans Salesforce. Une valeur vide désactive cet envoi d’e-mails ; les notifications dans l’application suivent leurs propres règles. |
| E-mail du contact de facturation | Vide | Adresse utilisée pour les alertes de crédits, selon les coordonnées du cycle de crédits et de la licence. Une valeur globale vide peut entraîner un repli vers le contact de la licence ; elle ne garantit pas la désactivation des alertes. |
Gestion des incidents
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Fenêtre de déduplication des incidents | 0 |
Fenêtre de déduplication en minutes pour les incidents partageant la classe, la méthode et le type d’erreur. La valeur 0 désactive la déduplication : elle ne désactive pas la journalisation. Plage : 0 à 60. |
Archivage et conservation
| Paramètre | Valeur par défaut | Fonction |
|---|---|---|
| Durée de conservation des archives | 180 |
Durée de conservation utilisée pour sélectionner les conversations et données associées à archiver, selon les règles du traitement. Utilisez une durée valide d’au moins 60 jours et vérifiez les éventuels réglages par agent. Ne mettez pas 0 pour désactiver l’archivage : le moteur peut revenir à sa valeur par défaut. Consultez le guide d’archivage avant de modifier la planification ou la conservation. |
Intégration de la base de connaissances
| Paramètre | Fonction |
|---|---|
| KB JWT Secret | Secret partagé servant à signer ou vérifier les jetons JWT de l’intégration de base de connaissances concernée. Sa configuration doit être coordonnée avec le service connecté. Ce paramètre technique ne fait pas partie des 34 champs du panneau Configuration ; ne publiez jamais sa valeur. |
Où modifier les paramètres
Ouvrez l’onglet Administrateur IA REDA, puis Configuration. Les réglages sont enregistrés dans des métadonnées personnalisées. L’interface les déploie au moyen de l’API Metadata de Salesforce : attendez le résultat du déploiement avant de vérifier leur effet.
Les réglages modifiables peuvent aussi être accessibles dans Configuration Salesforce › Types de métadonnées personnalisés › REDA AI Setup › Gérer les enregistrements. Le panneau REDA AI propose des libellés, des groupes et des contrôles de saisie ; les valeurs protégées ou gérées par l’activation ne doivent pas être modifiées directement.
Liste de mise à niveau pour les administrateurs
- Confirmez le package : Configuration → Packages installés → REDA AI doit afficher 1.16000. Testez dans un sandbox approprié avant la production.
- Préservez la configuration : sauvegardez métadonnées des outils, prompts personnalisés, présentations, droits et actions en attente.
- Fusionnez les outils : Configuration → Types de métadonnées personnalisés → Définitions d’outils REDA AI → Gérer les enregistrements. Examinez Description/Schéma d’entrée de send_email et Description de schedule_action. Les descriptions, schémas et canaux contrôlés par l’abonné demandent une fusion explicite, sans remplacer les enregistrements personnalisés entiers. Pour les bases anciennes, vérifiez aussi create_task, create_event et get_record. Requires Confirmation empaqueté est contrôlé par le développeur.
- Fusionnez les prompts : Seed Default Data peut écraser tous les prompts communs par défaut. Préservez les modifications locales ; ne l’exécutez pas aveuglément pour une seule instruction.
- Vérifiez les champs : utilisez le tableau. Les ensembles empaquetés peuvent être mis à jour ; contrôlez attributions, profils et ensembles propres/clonés. Placez les champs via Configuration → Gestionnaire d’objet → objet → Présentations de page et accordez uniquement les droits nécessaires.
- Vérifiez les listes : dans Champs et relations, contrôlez Définition d’agent → Niveau de traitement : valeur API exacte
Economy. Si Type de demande existait déjà sur Demande asynchrone IA, contrôlezContinuationetBulk Turn. Ajoutez les valeurs absentes, conservez leur orthographe API et activez-les pour les types d’enregistrement utiles. Les listes restreintes peuvent les refuser ; un champ nouvellement installé comprend ses valeurs empaquetées. - Vérifiez la planification : dans les contrôles du planificateur REDA AI Admin, examinez processeur, propriétaire et travail en attente. L’activation peut exécuter des actions existantes ; la mise à niveau ne décide pas à votre place.
Liste complète des champs et vérifications
Questions fréquentes
Ils s’appliquent à l’organisation. Les dérogations propres à un agent se règlent sur sa définition lorsqu’un champ est prévu à cet effet. Les autorisations déterminent qui peut consulter ou modifier la configuration.
Après la réussite du déploiement des métadonnées et lors de leur prochaine lecture par le traitement concerné. Vérifiez avec une nouvelle demande ; ne supposez pas qu’une conversation entière conserve toujours la configuration de son premier message.
Non. Utilisez le parcours d’activation de la licence dans l’onglet d’administration pour la remplacer. Le package gère les valeurs nécessaires et leur mise à jour.
Commencez par observer des conversations représentatives et leur consommation. Modifiez ensuite un réglage à la fois, puis comparez la qualité des réponses, les délais et les crédits réellement consommés. Un budget élevé n’est pas automatiquement préférable.
Les budgets d’historique et de sortie, la quantité de contexte, les outils, le raisonnement et les fichiers peuvent tous influer sur la consommation. Le multiplicateur de traitement des fichiers augmente un budget de sortie ; il n’est pas un tarif fixe par fichier. Consultez Optimiser la consommation de crédits.
Le comportement dépend du paramètre : l’interface peut refuser la saisie ou afficher un avertissement, et le moteur peut borner la valeur ou utiliser une valeur de repli. Ne supposez pas une règle identique pour tous les paramètres. Vérifiez le résultat effectif après enregistrement.
Seulement lorsque ce comportement est prévu. Par exemple, 0 désactive la déduplication des incidents et supprime les plafonds quotidiens concernés ; une adresse d’expédition d’incident vide désactive cet envoi. D’autres paramètres reviennent à une valeur de repli. En particulier, 0 n’est pas une commande de désactivation de l’archivage.
Étapes suivantes
Consultez Paramètres de la plateforme pour parcourir le panneau d’administration ou Optimiser la consommation de crédits pour préparer vos ajustements.