Vue d’ensemble de l’administration

Les administrateurs REDA AI configurent les agents, gèrent les accès et les réglages, suivent la consommation et examinent les incidents. Ce guide présente leurs fonctions et la mise en place de l’administration dans Salesforce.

Qui administre REDA AI ?

L’ensemble d’autorisations fourni REDA AI Admin donne accès aux fonctions de configuration, de suivi et de gestion prévues par le package. Les droits effectifs dépendent également du profil, des autres ensembles et du partage.

Attribuer l’ensemble d’autorisations

1. Ouvrez la Configuration Salesforce depuis l’icône d’engrenage.
2. Recherchez Ensembles d’autorisations dans la recherche rapide, puis ouvrez cette page.
3. Sélectionnez REDA AI Admin dans la liste. Ce nom fourni reste en anglais.
4. Ouvrez Gérer les attributions pour consulter les utilisateurs affectés.
5. Ajoutez des attributions, sélectionnez les utilisateurs prévus puis confirmez l’attribution.
6. Vérifiez le résultat et terminez le parcours. Testez ensuite les fonctions nécessaires avec l’utilisateur concerné.

Fonctions administratives

L’ensemble REDA AI Admin fournit les accès prévus aux fonctions suivantes, sous réserve du partage, des validations et des autres contrôles applicables :

L’onglet d’administration

La console comprend AI Connections, avec License & Credits, Configuration et Operations. Les administrateurs y créent, testent et activent les connexions et choisissent le défaut pour les outils administratifs, les documents et les agents qui en héritent. Elles peuvent être préparées pendant l’utilisation des crédits REDA ; elles prennent effet à l’activation de la licence compte client. Suivre le guide de configuration.

Licence et crédits

Ce sous-onglet regroupe la licence et la consommation :

• Clé de licence : collez la clé puis utilisez le bouton Clé d’activation. Les offres gratuites et payantes utilisent ce parcours. Attendez la réussite de l’enregistrement et contrôlez les détails affichés.
• Détails du plan : niveau, statut, crédits mensuels, agents autorisés, dates et adresse de facturation. Vérifiez séparément le processus de rappel de renouvellement applicable à votre compte.
• Utilisation de la période actuelle : indicateurs de la période et accès à la recharge. Distinguez allocation, report, consommation et solde disponible.
• Historique de crédit : périodes récentes avec allocation, report, recharges, total, consommation et disponible. L’interface vérifiée charge jusqu’à 12 périodes ; elle ne garantit pas l’affichage de tout l’historique.

Licence et crédits : activer une clé, puis examiner l’offre et sa consommation.

Configuration

Les paramètres globaux sont regroupés par thème. Leur nombre et leur portée varient selon la version. Consultez la Référence des paramètres de plateforme pour les détails et vérifiez les valeurs effectives :

• Système et notifications : REDA Activé par l'IA est le libellé fourni de l’interrupteur principal. Il bloque les nouvelles demandes des parcours qui le vérifient, sans annuler rétroactivement tous les travaux en cours. Le groupe contient aussi le suivi des réponses par e-mail, désactivé par défaut, et l’adresse d’expédition des notifications.
• Canaux externes : API de bot externe pour le widget et les clients externes configurés, et Chat du portail communautaire pour Experience Cloud. Leurs plafonds quotidiens limitent les usages concernés, sans garantie d’un plafond exact après appels concurrents ou en cours. WhatsApp et SMS nécessitent des intégrations explicitement configurées.
• Limites de réponse de l'IA : budgets de sortie des réponses et budgets distincts des générateurs d’agents, prompts, outils et analyses de débogage. Vérifiez les remplacements propres aux agents dans votre version.
• Limites de requêtes et de données, Optimisation de la conversation et Traitement et diffusion de fichiers regroupent notamment les lignes de requête et de résultat, la conservation, la déduplication d’incidents, l’historique et les règles de fichiers. Le multiplicateur de fichiers ajuste un budget de sortie ; les liens de distribution et leur nettoyage doivent être vérifiés séparément.

Configuration : activation, canaux externes, plafonds et budgets de réponse.

Opérations

Ce sous-onglet permet de gérer les données fournies et les tâches récurrentes :

• Données par défaut : le bouton Données par défaut de la graine charge ou actualise les prompts et suggestions par défaut. Il peut remplacer le contenu d’éléments fournis et désactiver certains anciens prompts fournis ; examinez les personnalisations avant utilisation. L’action vérifiée n’appelle pas directement la création de la définition d’agent par défaut.
• Tâches planifiées : état et prochaine exécution des tâches, avec Planifiez tout pour les planifier et Révoquer tout pour retirer leurs planifications. Vérifiez la portée de ces actions avant de les lancer.

Opérations : données par défaut et tâches récurrentes de la plateforme.

Utilisateurs et administrateurs

Le tableau compare les accès fournis par REDA AI User et REDA AI Admin. Il ne remplace pas l’examen des profils, des autres ensembles d’autorisations, du partage et des protections du package.

Responsabilités et bonnes pratiques

Suivi de la plateforme

• Examinez les incidents : recherchez les erreurs et incidents critiques selon la fréquence adaptée à votre usage. Déboguer avec l’IA propose des pistes à vérifier, pas une preuve automatique de cause.
• Suivez les crédits : consultez Licence et crédits, puis les transactions et rapports nécessaires. Rechargez selon le budget autorisé et les besoins réels.
• Relisez des conversations : sélectionnez un échantillon autorisé pour vérifier les réponses et les résultats des actions, sans déduire la satisfaction utilisateur des seuls compteurs.
• Analysez les usages : les analyses de conversation peuvent orienter l’examen d’outils coûteux ou de paramètres à ajuster ; confirmez les conclusions par les résultats métier.

Gestion de la configuration

• Décrivez le rôle des agents : utilisez des noms explicites et une description claire du périmètre.
• Vérifiez les outils : testez leurs paramètres, permissions et effets avec des cas représentatifs avant leur mise à disposition.
• Conservez les versions de prompts : documentez les changements et les valeurs précédentes dans votre processus de configuration. Ne supposez pas un historique natif restaurable pour chaque modification.
• Testez les changements : utilisez un environnement de test adapté avant la promotion en production, avec les canaux et rôles concernés.

Sécurité et gouvernance

• Limitez les accès administrateur : attribuez REDA AI Admin aux personnes qui en ont besoin et réexaminez les attributions selon votre politique, par exemple chaque trimestre.
• Vérifiez les accès aux conversations : utilisez les outils de suivi effectivement disponibles dans votre édition et votre configuration. Le journal des modifications de configuration Salesforce ne constitue pas un journal universel de chaque lecture de conversation.
• Gérez les clés de widget : limitez les copies opérationnelles et coordonnez les remplacements. Une clé intégrée au navigateur est visible publiquement ; vérifiez aussi les origines et les permissions invité.
• Contrôlez les données transmises : examinez les champs, les outils, le contexte d’exécution, le partage et la sécurité au niveau des champs, y compris dans les extensions.

Tâches fréquentes

Créer un agent

1. Ouvrez les définitions d’agents dans REDA AI.
2. Utilisez Nouveau pour créer une définition.
3. Renseignez le nom, la description et la persona ou les instructions prévues pour votre parcours.
4. Choisissez le canal approprié : Interne, API, Communauté ou Widget externe. Les connecteurs supplémentaires relèvent d’une intégration explicite.
5. Configurez les prompts, outils et champs de contexte nécessaires.
6. Vérifiez la case d’activation avant l’enregistrement : la valeur fournie peut être active par défaut. Préparez et testez l’agent avec les droits et la licence adaptés avant de le rendre disponible.

Examiner un incident important

1. Ouvrez les journaux d’incidents d’IA depuis l’application, éventuellement dans le menu des onglets supplémentaires.
2. Filtrez les valeurs de gravité pertinentes, notamment ERREUR ou CRITIQUE, ou l’agent concerné. « High » n’est pas une valeur de gravité de cet objet.
3. Ouvrez l’incident.
4. Lisez « Message d'erreur » et « Contexte d'erreur ».
5. Cliquez sur « Déboguer avec l'IA » pour obtenir une analyse.
6. Vérifiez les hypothèses et appliquez uniquement les corrections appropriées et autorisées.
7. Après vérification, passez le statut à « Résolu » et consignez la correction dans « Notes de résolution ».

Recharger les crédits en cours de période

1. Dans Licence et crédits, ouvrez « Recharger » depuis l’utilisation de la période.
2. Collez la clé de recharge fournie par REDA.
3. Cliquez sur « Racheter », libellé fourni du bouton de validation de recharge.
4. Attendez le résultat. La clé doit correspondre à l’organisation et satisfaire les contrôles applicables.
5. Vérifiez la nouvelle recharge et le solde. Si le résultat est ambigu, contrôlez les écritures de période avant de réessayer et contactez le support si nécessaire.

Suivre l’usage d’un agent

1. Ouvrez les conversations accessibles.
2. Utilisez une vue de liste ou un filtre sur l’agent concerné.
3. Examinez les conversations récentes, leurs compteurs et leurs transactions de crédits.
4. Ouvrez l’analyse d’une conversation pour ses indicateurs détaillés. Pour une analyse par agent, utilisateur ou période, utilisez les rapports Salesforce adaptés.

Liste de mise à niveau pour les administrateurs

1. Confirmez le package : Configuration → Packages installés → REDA AI doit afficher 1.16000. Testez dans un sandbox approprié avant la production.
2. Préservez la configuration : sauvegardez métadonnées des outils, prompts personnalisés, présentations, droits et actions en attente.
3. 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.
4. 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.
5. 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.
6. 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ôlez Continuation et Bulk 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.
7. 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