Confirmation des actions
Différences selon le canal
La confirmation et l’exécution d’un outil d’action dépendent du canal de l’agent. Celui-ci choisit quelle action effectuer de la même manière sur tous les canaux ; ce qui change est la nécessité de cliquer au préalable sur une carte.
| Canal | Comportement |
|---|---|
| Interne, interface Salesforce | Affiche une carte de confirmation pour les outils soumis à confirmation. L’action est exécutée uniquement après un clic sur Confirmer. Cet article décrit principalement cette expérience. |
| Widget externe et Communauté | L’action est exécutée automatiquement, sans carte. L’agent effectue ensuite automatiquement un tour supplémentaire pour annoncer le résultat réel, par exemple : « J’ai créé la requête nº 00001234. » Si l’action échoue, il le signale sans prétendre qu’elle a réussi. Un paramètre de la plateforme limite le nombre de tours automatiques consécutifs afin d’éviter les boucles incontrôlées. |
| API / Flow | Avec autoExecuteActions=true, l’action s’exécute silencieusement, sans carte ni commentaire ; le flux appelant traite le résultat. |
Qu’est-ce qu’une confirmation d’action ?
Une confirmation d’action est une carte affichée avant l’exécution d’un outil de catégorie Action soumis à confirmation sur le canal interne. Ces outils créent ou modifient des données Salesforce. La carte présente :
- Type d’action : l’opération prévue, par exemple « Créer une tâche », « Envoyer un e-mail » ou « Modifier un enregistrement ».
- Détails principaux : les valeurs essentielles qui seront créées ou modifiées.
- Boutons de confirmation : « Confirmer » pour poursuivre ou « Annuler » pour abandonner.
Pour les actions concernées, ce mécanisme évite que l’IA crée des enregistrements, envoie des e-mails ou modifie des données sans approbation explicite.
Quand une confirmation est-elle nécessaire ?
Sur le canal interne, les outils d’action suivants se comportent ainsi :
| Outil | Confirmation ? | Informations affichées |
|---|---|---|
| create_record | Oui | Type d’objet et principaux champs, comme Name, Stage et Amount |
| update_record | Oui | Nom ou identifiant de l’enregistrement, champs à modifier et nouvelles valeurs |
| delete_record | Oui | Nom ou identifiant de l’enregistrement et indication de sa suppression |
| send_email | Oui | Destinataires, objet et aperçu du corps de l’e-mail |
| create_task | Oui | Objet, échéance, priorité et personne affectée |
| create_event | Oui | Titre, début et fin, participants et lieu de l’événement |
| send_custom_notification | Oui | Titre, contenu et destinataires de la notification |
| link_file_to_record | Non | Sans objet : associe un fichier existant à un enregistrement sans carte |
| continue_workflow | Non | Sans objet : demande un tour autonome supplémentaire, uniquement sur le canal API ; ne modifie lui-même aucune donnée |
| schedule_action | Non, exception | Sans objet : exécution silencieuse |
Les outils en lecture seule, comme soql_query, get_record et describe_object, ne demandent jamais de confirmation puisqu’ils ne modifient aucune donnée.
L’expérience utilisateur de la carte
Voici ce que voit et fait l’utilisateur :
-
L’utilisateur demande une action
L’utilisateur saisit : « Créez une tâche pour relancer John Smith mardi prochain, avec une priorité élevée. »
-
L’IA choisit un outil
L’IA détermine que create_task est l’outil adapté.
-
La carte de confirmation apparaît
Au lieu de créer immédiatement la tâche, la conversation affiche une carte contenant :
- Action : « Créer une tâche »
- Objet : « Relance : John Smith »
- Échéance : [date de mardi prochain]
- Priorité : « Élevée »
- Boutons : « Confirmer » et « Annuler »
-
L’utilisateur vérifie et approuve
L’utilisateur lit la carte, vérifie les détails et clique sur « Confirmer » s’ils sont corrects.
-
L’action s’exécute
REDA AI exécute create_task et affiche un message de réussite dans la conversation.
-
Autre possibilité : l’utilisateur annule
Si l’utilisateur repère une erreur, il clique sur « Annuler ». La tâche n’est pas créée ; l’IA peut demander une précision ou proposer un nouvel essai.
Présentation des cartes
Les cartes de confirmation sont affichées dans l’interface de conversation REDA AI avec une présentation claire :
- Libellés explicites : sections consacrées au type d’action et aux détails.
- Mise en page lisible : les champs et valeurs sont faciles à parcourir.
- Boutons bien visibles : « Confirmer », généralement vert, et « Annuler », généralement gris.
- Aucune confirmation automatique : l’utilisateur doit cliquer pour approuver. Aucun délai ne déclenche une approbation automatique.
Les actions personnalisées affichent aussi leurs détails. Une carte créée pour l’un de vos outils de classe Apex présente désormais les valeurs que l’agent compte utiliser, dans la même disposition qu’une action intégrée, plutôt que son seul nom. Pour approuver « Créer un ordre de travail », l’utilisateur doit pouvoir vérifier le bien, le prestataire et le montant concernés. Les conditions qui imposent une confirmation ne changent pas ; seule l’information présentée avant approbation est enrichie.
L’exception schedule_action
Parmi les trois outils sans carte, schedule_action mérite une explication, car il semble particulièrement susceptible de nécessiter une confirmation. Il s’exécute sans carte parce que :
- schedule_action planifie une action future, sans l’exécuter immédiatement.
- L’utilisateur peut ensuite annuler ou modifier l’action planifiée.
- L’opération métier planifiée n’est pas exécutée immédiatement ; sa planification est toutefois enregistrée.
Exemple : « Planifiez l’envoi d’un e-mail au client demain à 10 h. » schedule_action crée immédiatement la planification du futur e-mail, sans confirmation, mais l’envoi lui-même n’a pas encore eu lieu.
Exécution automatique sans confirmation
Lorsque l’agent est appelé depuis Salesforce Flow avec autoExecuteActions=true, les outils d’action s’exécutent sans carte. Cela convient aux cas suivants :
- Processus automatisés : flux qui créent des enregistrements sans interaction utilisateur.
- Traitements par lot : traitement de plusieurs demandes sans approbation manuelle.
- Intégrations serveur : utilisation par API lorsqu’aucune confirmation dans une interface n’est possible.
Avec autoExecuteActions=true, les actions sont exécutées silencieusement ; le processus appelant doit donc prévoir la validation nécessaire de la demande.
Que se passe-t-il en cas d’annulation ?
Si l’utilisateur clique sur « Annuler » :
- L’outil d’action n’est PAS appelé.
- Aucune donnée n’est créée, modifiée ou supprimée par cette action.
- L’IA reçoit un statut d’annulation.
- L’IA informe l’utilisateur, par exemple : « Action annulée. Souhaitez-vous essayer autre chose ? »
La conversation se poursuit normalement. L’utilisateur peut demander un nouvel essai avec d’autres paramètres ou choisir une autre action.
Exemples courants de confirmation
La carte affiche l’objet « Opportunité », le compte « Acme Corp », l’étape « Qualification », le montant « 50 000 $ » et la date de clôture « 31 mars 2026 ».
La carte affiche les destinataires « john@example.com, jane@example.com », l’objet « Point sur le projet » et un aperçu des 100 premiers caractères du corps du message.
La carte affiche l’enregistrement « Opportunité : affaire Acme » et les modifications : « StageName: Proposal → Negotiation/Review » et « Probability: 50% → 75% ».
La carte affiche l’avertissement « Supprimer la requête nº 001234 » et exige une confirmation, car la suppression est destructive.
Bonnes pratiques
Expliquez aux utilisateurs que ces cartes sont des points de contrôle essentiels. Invitez-les à lire attentivement les détails avant de cliquer sur « Confirmer ».
Formulez une demande précise : pour créer ou modifier des données, indiquez les détails nécessaires. Préférez « Créez une tâche intitulée “Relance”, pour demain, avec une priorité élevée » à « Créez une tâche », trop vague.
Surveillez les annulations : si elles sont fréquentes, l’IA comprend peut-être mal les demandes. Revoyez les prompts et les instructions de schéma pour améliorer la précision.
Résoudre les problèmes de confirmation
Si aucune carte n’apparaît, vérifiez le canal, la catégorie Action de l’outil et son paramètre Nécessite une confirmation. Contrôlez aussi l’exécution automatique par API ou Flow et les exceptions documentées ci-dessus.
Détails incomplets ou incorrects : l’IA interprète peut-être mal les demandes. Ajoutez des instructions d’action plus précises dans les prompts personnalisés, par exemple : « Lors de la création d’une tâche, incluez toujours l’objet, l’échéance et la priorité. »
Annulations trop fréquentes : l’IA propose peut-être des valeurs de champ incorrectes. Ajoutez des prompts de schéma pour expliquer les listes de sélection, ou affinez les prompts personnalisés.
Actions d’e-mail, d’enregistrement et de planification
Les actions d’e-mail distinguent le destinataire Contact ou Piste de l’enregistrement métier associé, acceptent des listes À/Cc et vérifient les cas de refus d’e-mail pris en charge. Un Contact/Piste fourni comme enregistrement associé est traité comme destinataire. Les confirmations montrent les champs non appliqués. Les étapes du plan sont rapprochées une à une et les heures relatives conservent UTC. Les agents désactivés et actions imbriquées non autorisées sont vérifiés avant confirmation. La confirmation de liaison de fichiers réutilise le chemin avec contrôle d’accès. Les nouvelles actions horaires en attente ou replanifiées exigent un processeur disponible ; suivi des réponses et mises à jour normales d’historique/statut restent valides. Les travaux différés utilisent leur propriétaire de planification, sans usurper le demandeur. Les instructions réduisent les doublons via d’autres connecteurs, sans garantir le comportement de l’assistant.
Questions fréquentes
Il n’existe pas de désactivation globale. Sur le canal interne, les actions dont Nécessite une confirmation est activé nécessitent une carte. Avec Flow, autoExecuteActions=true permet l’exécution sans confirmation. Les canaux widget externe et communauté exécutent les actions sans carte puis en annoncent le résultat, comme indiqué ci-dessus.
L’action s’exécute. Selon sa nature, l’utilisateur peut parfois la corriger immédiatement. Un enregistrement créé par erreur peut par exemple être supprimé. En revanche, il n’est pas toujours possible d’annuler un e-mail déjà envoyé.
Trois outils ont Nécessite une confirmation désactivé : schedule_action, link_file_to_record et continue_workflow. Les autres outils d’action intégrés — create_record, update_record, delete_record, create_task, create_event, send_email et send_custom_notification — demandent une confirmation sur le canal interne.
Il n’y a pas de limite de temps. La carte reste à l’écran jusqu’au clic sur « Confirmer » ou « Annuler ». L’utilisateur peut prendre le temps nécessaire pour vérifier les détails.
Prochaines étapes
Découvrez les champs de contexte pour enrichir les données fournies à l’agent, ou les accès aux données et autorisations pour comprendre les contrôles de sécurité.