Référence de l’intégration Salesforce Flow
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.
Trouver l’action
Dans Flow Builder, ajoutez un élément Action, puis recherchez « REDA AI » ou filtrez les actions Apex. Le libellé est Send Message to REDA AI Agent. Utilisez un type de flux et un chemin d’exécution qui autorisent les actions Apex avec appels externes : flux d’écran, lancé automatiquement, planifié ou déclenché, selon sa configuration. Pour un flux déclenché par un enregistrement, utilisez un chemin asynchrone adapté.
Pour la configuration pas à pas, consultez Appeler REDA AI depuis Salesforce Flow. Cette page sert de référence des paramètres.
Entrées
Quatre paramètres sont obligatoires et six sont facultatifs.
| Paramètre | Obligatoire | Type | Fonction |
|---|---|---|---|
| Agent Name | Oui | Texte | Identifiant de l’agent qui doit traiter la demande, par exemple default-assistant. |
| Record ID | Oui | Texte | Identifiant Salesforce de l’enregistrement de contexte. L’agent utilise cet enregistrement et les champs de contexte configurés selon les contrôles d’accès applicables. |
| Object API Name | Oui | Texte | Nom API de l’objet correspondant à Record ID, par exemple Opportunity, Account ou Case. |
| Message | Oui | Texte | Message ou instruction transmis à l’agent comme message utilisateur. |
| Conversation ID | Facultatif | Texte | Identifiant d’une conversation existante pour poursuivre l’échange. Laissez vide pour en commencer une nouvelle. |
| Auto-Execute Actions | Facultatif | Booléen | Avec true, exécute les propositions encore en attente dans le traitement Flow. Le service peut déjà exécuter les actions du canal API ou des traitements automatisés : false ne garantit donc pas leur blocage. Limitez les outils aux opérations autorisées ; cette entrée ne crée pas de validation humaine. |
| Automated Source | Facultatif | Texte | Identifiant libre de l’automatisation, généralement le nom du flux, enregistré pour l’audit et le filtrage des conversations. |
| Create Incident on Error | Facultatif | Booléen | Avec true, l’action prévoit la création d’un incident pour ses erreurs. Avec false, ces erreurs restent accessibles dans les sorties sans cette journalisation spécifique. Les journaux techniques produits par d’autres couches du package peuvent néanmoins subsister. |
| File Content Version ID | Facultatif | Texte | Identifiant ContentVersion d’un fichier à traiter, comme une pièce jointe de conversation. |
| File Content Version IDs | Facultatif | Collection de textes | Identifiants ContentVersion d’un ou plusieurs fichiers, jusqu’à cinq, à traiter lors de cet appel. Si ce paramètre et File Content Version ID sont renseignés, la collection est prioritaire. |
Sorties
| Paramètre | Type | Fonction |
|---|---|---|
| Success | Booléen | true si l’appel a réussi ou si la demande a été acceptée pour traitement asynchrone. Vérifiez aussi Is Async avant d’utiliser la réponse. |
| Response | Texte | Texte de la réponse de l’agent. Il peut être vide lorsque la demande est traitée en arrière-plan. |
| Conversation ID | Texte | Identifiant de la conversation, à retransmettre pour poursuivre le même échange lorsqu’il est disponible. |
| Credits Used | Nombre décimal | Crédits comptabilisés pour cet appel. Un résultat d’acceptation asynchrone n’est pas le bilan final de consommation. |
| Action Results JSON | Texte | Résultats des actions exécutées, sérialisés en JSON, lorsque Auto-Execute Actions est activé et que des actions ont été proposées. Examinez chaque résultat avant de conclure que toutes les actions ont réussi. |
| Error Message | Texte | Description de l’erreur lorsque Success vaut false. |
| Is Async | Booléen | true si la demande est traitée en arrière-plan, notamment pour certains traitements de fichiers. Response n’est alors pas la réponse finale de l’agent. |
| Async Request ID | Texte | Identifiant de la demande asynchrone lorsque Is Async vaut true. Utilisez-le pour suivre la fin du traitement. Consultez Traitement asynchrone des agents. |
Autorisations
L’identité d’exécution dépend du flux et de son mode de lancement. Vérifiez les droits nécessaires dans ce contexte :
- Accès à REDA AI avec REDA AI User, REDA AI Admin ou des autorisations équivalentes adaptées.
- Accès à l’enregistrement transmis dans Record ID.
- Accès aux champs de contexte que l’agent doit lire.
- Droits nécessaires aux outils utilisés par l’agent, y compris les contrôles propres aux outils personnalisés.
- Droits d’écriture nécessaires aux opérations autorisées par votre configuration, y compris celles exécutées directement par le service API.
Ne supposez pas qu’un flux en contexte système supprime automatiquement tous les contrôles de l’agent. Vérifiez ensemble l’identité d’exécution, le canal API, le contexte d’exécution configuré sur l’agent et la sécurité de ses outils. Pour les automatisations sensibles, utilisez des droits précisément définis et testez avec une identité représentative du contexte réel.
Schémas d’intégration courants
Automatisation déclenchée par un enregistrement
À la création ou à la modification d’un enregistrement, transmettez son identifiant et l’instruction à l’agent depuis un chemin autorisant les appels externes. Exemples : synthèse pour l’orientation d’une requête, évaluation d’une opportunité ou qualification d’un prospect.
Automatisation planifiée
Un flux planifié traite un ensemble d’enregistrements et appelle l’agent pour les tâches prévues : synthèses quotidiennes, enrichissement ou classification. Dimensionnez la charge en tenant compte des limites de transaction, des ressources asynchrones Salesforce et du budget de crédits.
Déclenchement par événement de plateforme
Un flux abonné à un événement peut appeler l’agent. Dans une intégration de messagerie, un événement entrant déclenche le flux, qui transmet le message à l’agent puis envoie sa réponse avec le mécanisme sortant configuré. Consultez Intégration du canal de messagerie.
Flux d’écran
Un flux d’écran permet à une personne de demander une réponse depuis un bouton ou une action de page. Vérifiez le contexte d’exécution du flux. Ses composants d’affichage peuvent présenter une réponse synchrone ; un résultat asynchrone nécessite un suivi distinct.
Plusieurs tours dans un flux
Pour poursuivre un échange, conservez le Conversation ID du premier résultat disponible et retransmettez-le lors des appels suivants. Les tours sont alors associés à cette conversation, sous réserve des contrôles d’accès.
Gestion des erreurs
Après l’action, vérifiez toujours Success :
true: vérifiez d’abord Is Async. Utilisez Response comme réponse finale uniquement pour un résultat synchrone approprié.false: lisez Error Message et choisissez le traitement adapté : nouvelle tentative ultérieure, mise à jour d’un statut, notification à un administrateur ou parcours sans IA.
Le paramètre Create Incident on Error contrôle la journalisation d’erreurs effectuée par cette action :
- Activez-le pour les automatisations dont les échecs doivent être examinés.
- Si vous le désactivez pour réduire le volume d’incidents, conservez un autre moyen de suivre et de traiter les erreurs retournées.
Traitement asynchrone
Certains traitements, notamment de fichiers volumineux, peuvent être exécutés en arrière-plan. L’action renvoie alors Is Async = true et un Async Request ID. L’élément d’action a rendu la main, mais le travail de l’agent n’est pas nécessairement terminé.
Pour suivre la fin du traitement, surveillez la demande asynchrone et ses états Complete ou Error, ainsi que son éventuel message d’erreur. Ne supposez pas que les valeurs API sont Completed ou Failed. Utilisez la conversation liée lorsqu’elle est disponible pour retrouver la réponse. Consultez Traitement asynchrone des agents pour le cycle complet.
Traitement en volume et limites Salesforce
- Vérifiez le comportement sur votre version installée. Un flux déclenché en volume peut fournir plusieurs entrées à une action invocable. Ne supposez pas qu’une boucle rend les appels au modèle compatibles avec une seule transaction : des écritures antérieures peuvent empêcher un nouvel appel externe. Testez le traitement en volume et gérez les sorties asynchrones.
- Respectez les limites d’appels externes par transaction. Un tour d’agent peut nécessiter plusieurs appels. Les traitements en arrière-plan sont également soumis aux limites de ressources asynchrones de votre organisation.
- Prévoyez le budget de crédits. Ajustez la fréquence et le volume des automatisations pour maîtriser leur consommation.
- Traitez explicitement le résultat asynchrone. Votre flux doit vérifier Is Async. Ne considérez pas le traitement en arrière-plan comme une garantie que toute limite de volume sera automatiquement contournée.
Audit et suivi
- Les appels traités peuvent créer ou poursuivre une conversation. Utilisez Automated Source pour retrouver les échanges d’une automatisation. Une demande rejetée avant la création de conversation peut ne pas produire cet enregistrement.
- Le Canal des conversations de ces appels est
API. - Les erreurs journalisées avec Create Incident on Error activé peuvent être retrouvées dans le journal d’incidents, avec le contexte de l’automatisation disponible.
- Utilisez le débogueur de conversation pour examiner un échange qui n’a pas produit le résultat attendu.
Configurer l’agent pour Salesforce Flow
Vérifiez les points suivants :
- Le champ Canal de l’agent doit être configuré sur
API. - Les outils souhaités doivent être admissibles au canal
API. - Limitez les outils aux opérations adaptées à une exécution sans carte de confirmation humaine ; Auto-Execute Actions n’est pas un verrou global.
- Un agent dédié à un usage important peut faciliter le contrôle de ses instructions, de ses prompts et de ses outils.
Bonnes pratiques
Renseignez Automated Source. Cela facilite le rapprochement entre une conversation et le flux à son origine.
Choisissez explicitement Auto-Execute Actions. Un flux n’affiche pas automatiquement les cartes de confirmation de l’assistant interne. Si des actions sont nécessaires, prévoyez leur exécution et leur contrôle dans le processus, ou limitez l’agent à la lecture.
Vérifiez Is Async dans vos flux. Si Is Async vaut true, le résultat de cet appel ne contient pas nécessairement la réponse finale ; déclenchez le suivi prévu au lieu de lire un champ vide comme une réponse.
Maîtrisez l’identité des automatisations sensibles. Définissez les autorisations de l’utilisateur d’exécution, vérifiez le mode réellement utilisé et examinez les droits des outils. Un compte de service dédié peut faciliter cet audit lorsque le mécanisme de lancement le permet.
Retransmettez Conversation ID pour poursuivre un échange. Sans cet identifiant, un nouvel appel peut démarrer une conversation sans l’historique des tours précédents.
Testez dans une sandbox avant la production. Utilisez des enregistrements et des volumes représentatifs. Vérifiez les transcriptions, les erreurs, les limites de débit, l’épuisement des crédits et les sorties asynchrones avant de déployer votre flux.
Automatisation et fiabilité
Les appels groupés depuis Flow peuvent retourner des identifiants de demandes différées plutôt qu’une réponse immédiate. Examinez les éléments suivants qui attendent réponse, crédits ou résultats dans la même transaction. Les actions automatiques conservent canal et mode configurés, et leurs résultats réels restent dans le contexte ; cela ne garantit pas un tour narratif supplémentaire. Les décalages horaires explicites sont préservés dans les chemins pris en charge pour événements, planifications, écritures de champs et CSV. Sans décalage, l’interprétation de l’utilisateur exécutant reste applicable. Le mode Système ne crée pas d’avertissement du seul fait de son utilisation ; journaux et notifications ERROR demeurent. L’extraction respecte la limite de sortie, les couleurs fonctionnent dans les thèmes Salesforce pris en charge et les tests évitent les références statiques bloquant l’installation sans types d’enregistrement Compte.
Questions fréquentes
Send Message to REDA AI Agent, dans les actions Apex. Une recherche sur « REDA AI » permet aussi de la retrouver.
La classe expose une méthode invocable globale qui peut également être appelée depuis du code Apex autorisé. Vérifiez la signature, les permissions et les contraintes d’appels externes de votre contexte d’exécution.
Attribuez les autorisations REDA AI nécessaires et les droits requis sur le contexte et les outils. Vérifiez aussi le contexte d’exécution de l’agent API. L’exécution automatique d’actions nécessite un examen spécifique des opérations d’écriture autorisées.
Conservez Async Request ID, puis suivez la demande et ses états Complete ou Error. Vérifiez le message d’erreur même lorsqu’un traitement est terminé et consultez la conversation liée lorsqu’elle est disponible.
Oui, mais organisez les appels en tenant compte des transactions, des écritures et des limites Salesforce. Ne supposez pas que plusieurs appels séquentiels après des écritures restent autorisés dans la même transaction. Testez le comportement synchrone et asynchrone de la version installée.
Conservez le Conversation ID du premier résultat, par exemple sur l’enregistrement suivi, puis retransmettez-le aux appels suivants. Respectez les contrôles d’accès et évitez les écritures concurrentes dans la même conversation.
Lorsque certaines erreurs attendues sont gérées par un autre mécanisme de suivi, par exemple une classification qui marque les enregistrements non traités. Pour une automatisation critique, conservez un suivi permettant d’identifier et de résoudre les échecs.
Pour un appel rejeté, l’action peut renvoyer Success = false avec un message d’erreur de crédits. Branchez le flux sur ce résultat, puis utilisez un parcours sans IA ou informez l’administrateur. Un traitement accepté en arrière-plan nécessite aussi de suivre son résultat final.
Étapes suivantes
Consultez Appeler REDA AI depuis Salesforce Flow pour la configuration pas à pas ou Intégration du canal de messagerie pour relier un système de messagerie à l’agent.