Appeler REDA AI depuis des flux Salesforce
Qu’est-ce qu’une action d’agent déclarative ?
Une action d’agent déclarative est une action de flux qui appelle un agent REDA AI. Au lieu de développer du code Apex ou une intégration API, ajoutez l’action au flux, renseignez ses entrées et exécutez l’agent dans votre automatisation.
Elle permet notamment les usages suivants :
- Traitement automatisé — Déclencher un agent à la création d’un enregistrement, par exemple pour analyser une nouvelle piste
- Enrichissement — Compléter des champs à partir de données externes
- Orientation — Déterminer la file d’attente ou l’utilisateur qui doit prendre en charge un enregistrement
- Notifications — Produire des résumés à intégrer aux e-mails
Prérequis
Avant d’utiliser un agent dans un flux :
- L’agent doit exister — Créez-le et configurez ses prompts, outils et champs de contexte
- L’agent doit être actif — Cochez Est actif sur sa définition
- Autoriser les requêtes automatisées doit être activé — Cochez ce champ sur la définition d’agent pour permettre les appels par flux
- Le canal doit être
API— L’action invocable par flux ou Apex n’accepte que les agents dont le canal estAPI. Les canaux Interne, Communauté et Widget externe sont refusés avec un message explicite.
Un agent avec Canal = API est réservé aux appels programmatiques : Générateur de flux, Apex et intégrations REST. Il ne peut pas être placé sur une page d’enregistrement, qui nécessite Interne, une page de portail, qui nécessite Communauté, ou un site public, qui nécessite Widget externe. Choisissez le canal correspondant à l’usage prévu.
Préparer un agent pour les flux
-
Ouvrir la définition d’agent
Ouvrez l’agent à utiliser dans le flux.
-
Cocher Autoriser les requêtes automatisées
Cochez Autoriser les requêtes automatisées pour permettre l’intégration par flux.
-
Configurer l’agent
Configurez les prompts et outils appropriés à la tâche automatisée, puis définissez Canal sur API.
-
Activer l’agent
Cochez Est actif sur l’agent.
-
Enregistrer
Enregistrez. L’agent est prêt à être appelé depuis un flux.
Utiliser un agent dans un flux
-
Créer ou ouvrir un flux
Ouvrez le Générateur de flux Salesforce depuis Configuration → Flux, ou depuis une page.
-
Ajouter une action
Cliquez sur « + » pour ajouter un élément, puis sélectionnez Action.
-
Rechercher l’action REDA AI
Recherchez « REDA AI », puis sélectionnez l’action « Send Message to REDA AI Agent ».
-
Identifier l’agent
Dans l’entrée Agent Name, indiquez l’identifiant de l’agent, par exemple « default-assistant ». Utilisez l’identifiant de sa définition, pas son nom d’affichage.
-
Configurer les entrées
Associez les variables du flux aux entrées de l’action :
- Agent Name — Identifiant de l’agent, obligatoire
- Record ID — Identifiant de l’enregistrement de contexte, obligatoire
- Object API Name — Nom API de l’objet de contexte, comme « Opportunity », obligatoire
- Message — Prompt ou instruction à traiter, obligatoire
- Auto-Execute Actions — Exécuter les propositions d’action encore renvoyées au flux : true ou false. Cette entrée ne bloque pas les outils déjà exécutés par le service.
- Conversation ID — Identifiant d’un échange précédent pour poursuivre une conversation
- Automated Source — Libellé de l’automatisation, comme le nom du flux, conservé dans la conversation pour l’audit
- Create Incident on Error — Si true, les échecs créent un incident IA ; si false, les erreurs sont uniquement renvoyées dans les sorties
-
Configurer les sorties
Récupérez les résultats de l’agent :
- Response — Réponse textuelle de l’agent
- Success / Error Message — Réussite de l’appel et, en cas d’échec, description de l’erreur
- Action Results JSON — Tableau JSON des résultats d’actions lorsque Auto-Execute Actions vaut true
- Credits Used — Crédits IA consommés par l’appel
- Conversation ID — À transmettre à l’appel suivant pour continuer la conversation
- Is Async / Async Request ID — Renseignés lors d’un traitement asynchrone ; consultez Traitement asynchrone des agents
-
Utiliser les sorties aux étapes suivantes
Transmettez la réponse de l’agent aux étapes suivantes du flux : envoi d’e-mail, mise à jour d’enregistrement, etc.
-
Tester et enregistrer
Testez le flux avec des données d’exemple, puis enregistrez-le lorsqu’il est prêt.
Exemples d’utilisation dans les flux
Un flux se déclenche à la création d’une piste et transmet ses informations à un agent. Celui-ci enrichit la piste avec des données sur l’entreprise, identifie le meilleur contact et met à jour l’enregistrement automatiquement.
À la création d’une requête, un flux appelle l’agent pour analyser sa description et sa priorité. L’agent détermine l’équipe concernée — ventes, assistance ou facturation — et le flux attribue la requête en conséquence.
Un flux prépare un rapport hebdomadaire des opportunités ouvertes. Il appelle un agent pour résumer chacune, puis rassemble les résumés dans un e-mail adressé aux responsables.
Transmettre des fichiers à l’agent
Un flux peut envoyer à l’agent des fichiers déjà stockés dans Salesforce, comme un PDF, une image ou un CSV. Dans File Content Version IDs, fournissez une collection d’identifiants ContentVersion correspondant aux fichiers à lire, de un à cinq.
Récupérez les identifiants ContentVersion dans le flux, par exemple avec un élément Obtenir les enregistrements sur ContentVersion, puis transmettez-les à File Content Version IDs. L’agent les lit pour préparer sa réponse. Le champ Autoriser le téléchargement de fichiers, qui permet de joindre des fichiers, doit être activé sur l’agent. Les types et tailles autorisés suivent vos paramètres REDA AI ; consultez Joindre des fichiers.
L’entrée File Content Version ID, pour un seul fichier, reste disponible par compatibilité. Pour les nouveaux flux, utilisez File Content Version IDs, qui accepte un ou plusieurs fichiers. Si les deux entrées sont renseignées, File Content Version IDs est prioritaire.
Exécuter automatiquement les actions
L’entrée Auto-Execute Actions contrôle le traitement des propositions d’action encore présentes dans la réponse au flux. Elle ne constitue pas un interrupteur global des actions : le service peut déjà exécuter des outils sur le canal API ou lors d’une requête automatisée. Un appel en arrière-plan n’affiche pas de carte de confirmation.
- Activée — Le flux tente d’exécuter les propositions restantes et fournit leurs résultats dans Action Results JSON. Vérifiez les résultats effectifs et les enregistrements concernés.
- Désactivée, valeur par défaut — Le flux ne traite pas les actions encore proposées par ce mécanisme. Cela n’empêche pas les actions déjà exécutées par le service sur le canal API ou dans une requête automatisée ; aucune approbation humaine n’est ajoutée.
Contrôlez les outils et les autorisations avant l’exécution. Ne vous servez pas de false comme garantie de lecture seule. Attribuez uniquement les outils admis sans intervention humaine, vérifiez leurs résultats et les traces de conversation ; Action Results JSON ne doit pas être considéré comme la liste exhaustive de toute opération possible.
Pour imposer une étape humaine, concevez un parcours d’approbation explicite et séparez les outils d’écriture du traitement qui prépare la décision. Dans un flux déclenché par un enregistrement, utilisez le chemin asynchrone adapté aux appels externes, puis testez les réussites et les échecs.
Automatisations autonomes en plusieurs étapes
Un échange d’agent correspond à une transaction Salesforce. L’agent peut y appeler l’IA et ses outils, puis enregistrer des données, mais il ne peut pas rappeler un service externe après cet enregistrement dans la même transaction. Pour une tâche qui exige de créer ou modifier un enregistrement, appeler ensuite un service externe avec cet enregistrement, puis sauvegarder le résultat, un agent API peut poursuivre sur des échanges automatiques supplémentaires.
L’agent demande une suite avec l’outil intégré continue_workflow. Chaque échange supplémentaire utilise une nouvelle transaction et ses propres limites, puis reprend le travail avec les enregistrements validés lors de l’étape précédente. L’agent décide si cette suite est nécessaire ; s’il peut terminer en un échange, il le fait.
- Canal API uniquement — Cette capacité est réservée aux agents dont le canal est
API. Les agents Interne, Communauté et Widget externe n’y ont pas accès. - Disponible par défaut, désactivable par agent — Les agents API disposent automatiquement de
continue_workflow. Pour empêcher l’enchaînement, excluez cet outil dans Aperçu de l'exécution de l'agent → Modifier l'équipement, ou désactivez l’outil. - Exécution bornée — Une tâche peut enchaîner un nombre limité d’échanges, 20 par défaut et configurable dans les paramètres. Chaque échange consomme des crédits selon les limites habituelles, ce qui borne le traitement.
Un flux appelle un agent pour créer un compte client. L’agent crée le compte, puis utilise continue_workflow pour poursuivre, car il doit transmettre les informations du compte à un service externe de vérification. Au nouvel échange, il appelle ce service, reçoit son résultat et met à jour le compte, sans intervention humaine.
Seulement lorsqu’un appel externe doit intervenir après une sauvegarde. Un agent peut déjà lire, raisonner et créer ou modifier plusieurs enregistrements dans un seul échange. La plupart des automatisations n’ont donc pas besoin de suite ; réservez-la au parcours créer, appeler, puis enregistrer le résultat.
Gérer les erreurs dans les flux
Si un appel d’agent échoue :
- Le flux reçoit un statut d’erreur et peut adapter son parcours
- Vous pouvez ajouter un chemin d’erreur pour consigner le problème ou envoyer une notification
- Le flux peut continuer, relancer ou s’arrêter selon le type d’erreur
Exemples d’erreurs courantes :
- Agent inactif — Vérifiez Est actif et activez l’agent si nécessaire.
- Accès refusé — L’utilisateur exécutant le flux n’a pas accès à un enregistrement. Vérifiez les autorisations et le partage.
- Échec d’un outil — Consultez les journaux pour comprendre l’échec de l’outil appelé.
- Délai dépassé — L’agent a mis trop de temps à répondre. Vérifiez le budget des prompts et simplifiez la tâche si nécessaire.
Bonnes pratiques d’intégration
Rédigez des prompts propres au flux. Exemple : « Analysez cette piste et extrayez 1) la taille de l’entreprise, 2) le secteur et 3) la fourchette budgétaire. Renvoyez le résultat en JSON. »
Limitez le volume des entrées — Transmettez uniquement les données nécessaires à la tâche de l’agent.
Suivez les jetons et les crédits — Chaque appel consomme des crédits. Suivez la consommation et optimisez les prompts pour réduire les entrées inutiles.
Choisissez des budgets adaptés — Le budget de complexité des prompts doit correspondre à la tâche. Une opération en lot peut nécessiter moins d’instructions qu’un agent conversationnel.
Testez soigneusement — Utilisez des données représentatives en sandbox. Vérifiez les sorties et l’absence d’effets inattendus.
Questions fréquentes
Non. L’action invocable par flux ou Apex accepte uniquement les agents du canal API. Si un autre canal est utilisé, l’action renvoie une erreur expliquant l’incompatibilité. Créez un agent dédié avec Canal = API pour les flux.
Gardez le message centré sur la tâche et respectez les limites des entrées du flux et du traitement Salesforce. Le champ Longueur maximale du message concerne les sessions de chatbot externes ; il ne faut pas le considérer comme une limite générale des entrées Flow.
Oui, selon les outils d’écriture et les autorisations attribués. Le service peut exécuter des actions sur le canal API même si Auto-Execute Actions est false ; cette entrée traite les propositions restantes et ne garantit pas un fonctionnement en lecture seule.
Récupérez les sorties dans des variables de flux. Vous pouvez les conserver dans un enregistrement de diagnostic, les envoyer par e-mail ou les stocker dans un champ à des fins d’audit.
Pas dans le même échange, car un appel externe ne peut pas suivre une sauvegarde dans la même transaction. Pour ce parcours, un agent API utilise continue_workflow et poursuit dans une nouvelle transaction. Consultez Automatisations autonomes en plusieurs étapes. Cette capacité est réservée à API, limitée en nombre d’échanges et excluable de la sélection de l’agent.
Prochaines étapes
Explorez la gestion des prompts pour vos cas d’usage par flux, ou les outils pour activer les actions de l’agent.