Installer REDA AI

Avant de commencer

Avant d’installer REDA AI, vérifiez les points suivants :

• Vous disposez du profil Administrateur système dans votre organisation Salesforce.
• Votre organisation utilise Salesforce Lightning Experience. REDA AI est une application native Lightning et ne prend pas en charge Salesforce Classic.
• Vous commencez par une installation dans une sandbox pour tester avant la production. Consultez Bonnes pratiques pour comprendre pourquoi.

Étapes d’installation

1. Ouvrez AppExchange
   Accédez à appexchange.salesforce.com et recherchez REDA AI. Cliquez sur sa fiche pour l’ouvrir.
2. Cliquez sur « Get It Now »
   Choisissez une installation dans une sandbox ou une organisation de production, puis connectez-vous à votre organisation Salesforce à l’invite.
3. Choisissez « Installer pour tous les utilisateurs » ou « Installer pour les administrateurs uniquement »
   Nous recommandons de commencer par Installer pour les administrateurs uniquement. Vous pourrez ensuite donner accès aux autres utilisateurs en leur attribuant des ensembles d’autorisations.
4. Autorisez l’accès tiers
   REDA AI communique avec le service d’IA pour traiter les demandes. À l’invite, cochez la case d’autorisation, puis cliquez sur Continuer.
5. Attendez la fin de l’installation
   Elle prend généralement 1 à 3 minutes. Vous recevrez un e-mail de confirmation lorsqu’elle sera terminée.
6. Ouvrez l’application REDA AI
   Dans Salesforce, cliquez sur le Lanceur d’applications, l’icône en grille de neuf points, puis recherchez REDA AI. Ouvrez l’application pour vérifier son installation.

Liste de contrôle après installation

Après l’installation, terminez ces étapes avant d’inviter vos utilisateurs :

• Activez votre clé de licence dans l’onglet d’administration
• Créez la première période de crédit dans la section Crédits de l’onglet d’administration
• Attribuez les ensembles d’autorisations aux utilisateurs et aux administrateurs
• Créez et configurez au moins une définition d’agent
• Testez l’agent dans votre sandbox avant de le déployer en production

L’onglet d’administration REDA AI après une nouvelle installation : saisissez votre clé de licence pour commencer.

Étapes client pour utiliser la version 1.16000

Ouvrir la liste complète des champs et présentations.

Suivez cette liste selon votre version installée. Elle couvre les correctifs 1.15001–1.15009 et la version majeure 1.16000. Les fonctions sont facultatives ; terminez leur configuration avant de les activer. Le tableau couvre les 13 champs du package ajoutés depuis 1.15000 : neuf dans les correctifs et quatre dans 1.16000.

1. Relever la version et sauvegarder la configuration

Dans Configuration → Packages installés, notez la version REDA AI. Testez la mise à niveau avec votre configuration dans un sandbox adapté. Sauvegardez agents, prompts personnalisés, métadonnées d’outils, présentations, autorisations et actions en attente. Pour une version antérieure à 1.15000, appliquez aussi les étapes de 1.15000. Installez 1.16000 avec les modalités fournies par REDA et vérifiez à nouveau la version.

2. Ajouter les champs aux pages utilisées

Pour chaque objet du tableau, ouvrez Configuration → Gestionnaire d’objet → objet → Présentations de page. Vérifiez l’attribution des présentations par profil et type d’enregistrement. Modifiez chaque présentation concernée, placez les champs dans les sections indiquées et enregistrez. La mise à niveau n’ajoute pas ces champs aux présentations personnalisées du client. Si la page Lightning utilise les Formulaires dynamiques, ouvrez aussi Modifier la page, ajoutez les champs aux sections, vérifiez les règles de visibilité et activez l’attribution appropriée.

Sur la présentation de Définition d’agent, ajoutez la liste associée des Prompts exclusifs, avec prompt, Actif et Mode de chargement. Rendez le nouvel objet d’affectation accessible depuis l’application ou cette liste. Via MCP, Niveau de traitement des crédits et Type de demande doivent être en lecture seule dans les vues opérationnelles : l’application les renseigne.

3. Vérifier les autorisations et l’accès réel

Vérifiez REDA AI Admin, REDA AI User et, si nécessaire, REDA AI Community User. Les ensembles du package déjà attribués peuvent recevoir des droits actualisés ; la mise à niveau ne crée pas les attributions manquantes et ne corrige pas vos ensembles personnalisés ou clonés. Vérifiez l’accès aux objets et champs du tableau. Les relations obligatoires suivent les droits de l’objet et peuvent ne pas avoir d’entrée de droit de champ distincte.

MCP requiert REDA AI User et REDA AI MCP User ; ce dernier permet aussi de modifier les deux champs de configuration MCP. Vérifiez ce droit selon vos rôles. REDA AI MCP Guest concerne l’utilisateur invité du Site publiant le point de connexion ; il ne remplace pas les droits métier des utilisateurs authentifiés.

4. Vérifier les listes de sélection et l’aide

Dans Définition d’agent → Niveau de traitement, vérifiez la valeur API Economy et les types d’enregistrement concernés. Si Type de demande existait déjà sur Demande asynchrone, vérifiez Continuation et Bulk Turn. Ajoutez les valeurs absentes avec cette orthographe API exacte. Un nouveau champ inclut ses valeurs du package.

L’ancienne aide peut être conservée après mise à niveau. Vérifiez Niveau de traitement, Raisonnement approfondi, Fenêtre de conversation, Consentement au niveau Économique, objets de contexte des prompts, objets de contexte par défaut de l’agent, ID d’agent et Persona. Corrigez toute aide annonçant un passage automatique à Efficace sans consentement : sans consentement, Économique est refusé. Aide proposée : « Confirme que votre organisation a accepté les conditions de traitement Économique. Sans consentement, les demandes Économique sont refusées. Cocher uniquement après accord. »

5. Configurer les fonctions retenues

• Continuité : une Fenêtre de conversation vide utilise désormais le défaut de l’organisation, initialement 30 minutes ; 0 empêche la reprise automatique et une valeur positive fixe la fenêtre. Testez avec et sans enregistrement. Ce réglage ne supprime pas l’historique.
• Économique : demandez une licence réémise à REDA si l’ancienne n’inclut pas les identifiants Économique. Activez-la selon le processus habituel et créez/vérifiez un paramètre de site distant approuvé et actif pour https://api.deepseek.com. Vérifiez les conditions avant de cocher le consentement sur chaque agent. L’absence de consentement ou d’identifiants entraîne un refus. L’indisponibilité du fournisseur est un cas différent pouvant utiliser Efficace. L’usage ordinaire applique 0,40× le crédit de base ; la pré-extraction est au plein tarif. Le raisonnement approfondi n’est pas disponible en Économique.
• Prompts exclusifs : ajoutez Exclusif et Résumé à la présentation de Prompt personnalisé. Créez le prompt partagé sans Définition d’agent directe, cochez Exclusif et rédigez un résumé. Créez une affectation par agent, choisissez le prompt et Actif, puis Toujours, Selon le contexte ou À la demande (API Always, On_Context, On_Demand). À la demande exige get_context_prompts parmi les outils disponibles. Un prompt avec une portée de contexte renseignée ne charge plus lors d’un échange sans contexte ; videz cette portée seulement s’il doit s’appliquer partout. Vérifiez l’aperçu avec un ID d’enregistrement et sans enregistrement.
• MCP : configurez Site et application cliente externe, autorisez l’ensemble dans la politique de l’application, attribuez les utilisateurs et activez MCP uniquement sur les agents Interne actifs choisis. Suivez Configuration MCP et le guide utilisateur. L’installation seule ne connecte pas un assistant externe.

6. Fusionner les définitions d’outils et les prompts

Dans Configuration → Types de métadonnées personnalisés → REDA AI Tool Definitions → Gérer les enregistrements, comparez les valeurs client aux définitions actuelles de REDA en préservant vos adaptations.

• create_task et create_event : Description et Schéma d’entrée doivent présenter field_values. Pour les événements sur API, Canaux doit inclure Internal;API.
• send_email : fusionnez description et schéma actuels, notamment recipient_id, To/Cc et la distinction entre destinataire et enregistrement associé.
• schedule_action : fusionnez la description actuelle. Pour une ancienne version, comparez aussi get_record. Vérifiez que l’agent dispose des outils requis.

Descriptions, schémas et canaux sont contrôlés par l’abonné ; Confirmation requise est contrôlé par le développeur du package. Ne remplacez pas tout l’enregistrement sans examen.

Vérifiez _common:language-directive-api, _common:language-directive-external et _common:core-instructions-api. Fusionnez les consignes de langue et de messages destinés aux personnes en préservant les règles métier. Seed Default Data peut écraser tous les prompts partagés par défaut. API/widget externe doivent suivre la langue du message reçu, pas celle du compte de service ou invité.

7. Vérifier l’automatisation avant exécution

Pour les Flows à plusieurs entrées, vérifiez les éléments attendant une réponse immédiate : le traitement différé retourne un asyncRequestId au lieu d’une réponse et de crédits immédiats. Examinez chaque agent API avec Contexte d’exécution = System : les correctifs font respecter ce réglage aux actions automatiques dont certaines utilisaient auparavant User. Les droits effectifs d’objets/champs peuvent donc s’élargir ; confirmez que c’est voulu.

Pour les actions à heure fixe, vérifiez que le processeur planifié peut s’exécuter, son propriétaire et le travail en attente. Une nouvelle action Pending ou replanifiée est refusée sans processeur exécutable. Ne l’activez pas sans examiner ce qu’il exécutera. Les travaux différés utilisent l’identité du propriétaire du planificateur. Suivi de réponses e-mail et mises à jour ordinaires d’historique sont des cas distincts. Vérifiez les décalages horaires avec un test jetable.

8. Valider et transmettre

Testez avec un utilisateur ordinaire autorisé et un administrateur témoin : visibilité des champs, accès permis/refusé, proposition/refus/approbation d’une action sans risque, résultat réel dans Salesforce et reprise de conversation. Vérifiez Niveau de traitement dans une nouvelle transaction et Via MCP dans un message MCP. L’historique des crédits n’est pas complété rétroactivement ; une ancienne valeur vide ne prouve pas le niveau utilisé. Consignez version, présentations/autorisations modifiées, fonctions activées, résultats et réglages restant au client avant d’étendre l’usage.

Questions fréquentes