Ajout d’un flux en tant qu’action d’agent

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

• Ancrer un sous-agent pour une efficacité maximale avec des actions d’agent basées sur le flux
  
• Créer une action d’agent qui fait référence à un flux
  
• Configurer un sous-agent de sorte qu’une action d’agent fournisse des données à une autre action d’agent
  

Ce badge suppose que vous connaissez les flux et que vous avez de l’expérience avec Flow Builder. Suivez le parcours Élaboration de flux avec Flow Builder pour développer de solides compétences en automatisation des processus et devenir un expert Flow Builder.

Maintenant que vous avez créé les flux dont l’agent de réservation Coral Cloud a besoin pour aider les clients à gérer leurs activités réservées, créez un sous-agent et attribuez-lui les actions basées sur les flux dont il a besoin pour aider vos clients.

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Configuration d’Agentforce

Tout d’abord, assurez-vous qu’Agentforce est activé dans votre Trailhead Playground.

1. Dans la recherche rapide de Setup (Configuration), recherchez et sélectionnez Einstein Setup (Configuration d’Einstein).
   
2. Vérifiez qu’Einstein est activé. S’il est déjà activé, désactivez-le, puis activez-le à nouveau.
   
3. Actualisez votre navigateur pour recharger la page Setup (Configuration).
   
4. Dans la recherche rapide de Setup (Configuration), recherchez et sélectionnez Agentforce Agents (Agents Agentforce).
   
5. Vérifiez que l’option Agentforce est activée.
   

Ajout d’un sous-agent

Avant de créer le sous-agent, tenez compte de certaines directives et meilleures pratiques pour la configuration des sous-agents.

• Ancrez votre sous-agent avec des informations sur les objets Salesforce pertinents. Décrivez leurs finalités afin que l’agent comprenne comment ses données sont utilisées.
  
• Indiquez au sous-agent qu’il ne doit utiliser aucune donnée Salesforce non fournie par une action. N’oubliez pas que les agents peuvent voir tous les objets et champs pour lesquels ils bénéficient d’une autorisation. Cette instruction empêche l’agent de parler de données qui ne sont pas pertinentes ou qui ne devraient pas être partagées.
  
• Dites au sous-agent de ne montrer aucune valeur d’ID au client. Les variables de collection d’enregistrements incluent toujours les ID des enregistrements. Par conséquent, sans cette instruction, il y a de fortes chances que l’agent montre ces données aux clients, même si elles ne les concernent pas. Cette instruction protège vos clients contre toute confusion due à des données chiffrées.
  

Lorsque vous configurez un sous-agent, vous fournissez une description et des instructions.

Créez maintenant un sous-agent qui indique à l’agent ce qu’il peut et ne peut pas faire avec les activités réservées des clients.

1. Cliquez sur le lanceur d’application ().
   
2. Cliquez sur View All (Afficher tout).
   
3. Sélectionnez l’application Studio Agentforce.
   
   
4. Dans la liste Agents, sélectionnez Coral Cloud Booking Agent (Agent de réservation Coral Cloud).
   
5. Dans le panneau Explorer (Explorateur), cliquez sur , puis sélectionnez New Subagent (Nouveau sous-agent).
   
   Si le bouton est désactivé, c’est parce que cette version de l’agent est validée. Pour créer une nouvelle version non validée, cliquez sur New Version (Nouvelle version).
   

6. Pour Subagent Name (Nom du sous-agent), saisissez Booked Activity Management (Gestion des activités réservées).
   
7. Pour Description (Description), saisissez This subagent helps Coral Cloud Resort guests to manage and understand their booked activities. Booked activities are stored in the 'Bookings' object in Salesforce. Guests are represented by the 'Contacts' object in Salesforce. (Ce sous-agent aide les clients de Coral Cloud Resort à gérer et à comprendre leurs activités réservées. Les activités réservées sont stockées dans l’objet Bookings [Réservations] dans Salesforce. Les clients sont représentés par l’objet Contacts dans Salesforce.)
8. Cliquez sur Create and Open (Créer et ouvrir).
   

Le générateur affiche le nouveau sous-agent vide.

Ajout de flux en tant qu’actions d’agent

Commencez par ajouter les flux à l’agent en créant une action d’agent pour chacun d’eux. Heureusement, vous pouvez créer et attribuer ces actions d’agent sans avoir à quitter le générateur Agentforce.

Ajout de l’action Get Customer Details (Obtenir les détails sur le client)

1. Sous Actions Available For Reasoning (Actions disponibles pour le raisonnement), cliquez sur Select action .(Sélectionner une action).
   
2. Sélectionnez Create a custom action (Créer une action personnalisée).
   
3. Pour Action Name (Nom de l’action), saisissez Get Customer Details (Obtenir les détails sur le client).
   
4. Pour Description, saisissez Validate a Customer’s details by passing their email and memberNumber to see if there is a related contact. (Valide les détails d’un client en transmettant son adresse e-mail et son numéro de membre pour voir s’il existe un contact associé.)
   
5. Pour Reference Action Type (Type d’action de référence), sélectionnez Flow (Flux).
   
6. Pour Reference Action (Action de référence), sélectionnez Get Customer Details (Obtenir les détails du client).
   
7. Cliquez sur Create and Open (Créer et ouvrir).
   
8. Configurez les paramètres d’entrée de la variable d’e-mail.
   
   • Si les sections Inputs (Entrées) et Outputs (Sorties) sont vides, accédez à un autre onglet, puis revenez à l’onglet Get Customer Details (Obtenir les détails sur le client).
     
   • Assurez-vous que la description indique The Email Address of the customer that is validating their identity. (L’adresse e-mail du client qui valide son identité.)
     
   • Cochez l’option Require input to execute action (Entrée requise pour exécuter l’action).
     Ce paramètre indique à l’agent qu’il ne doit pas exécuter cette action à moins qu’il ne dispose de données à lui envoyer. Utilisez ce paramètre pour garantir que le flux ne s’exécute pas sans les données dont il a besoin pour s’exécuter correctement.
     
9. Configurez les paramètres d’entrée de la variable memberNumber.
   
   • Assurez-vous que la description indique The Member Number of the customer that is validating their identity. (Le numéro de membre du client qui valide son identité.)
   • Cochez l’option Require input to execute action (Entrée requise pour exécuter l’action).
     
10. Configurez les paramètres de sortie de la variable de contact.
    
    • Assurez-vous que la description indique The contact that was returned in the search for records. (Le contact qui a été renvoyé lors de la recherche d’enregistrements.)
    • Cochez Show in conversation (Afficher dans la conversation).
      Ce paramètre indique à l’agent qu’il peut envoyer le contenu de cette variable au client. Si la case Show in Conversation (Afficher dans la conversation) n’est pas sélectionnée pour une sortie particulière, le contenu de cette variable de flux ne sera jamais partagé avec le client.
      
11. Cliquez sur l’onglet Booked Activity Management (Gestion des activités réservées) pour revenir à la zone de dessin du sous-agent.
    
12. Sous Actions Available for Reasoning (Actions disponibles pour le raisonnement), cliquez sur en regard de la gélule Get Customer Details (Obtenir les détails sur le client) dans la zone de dessin.
    
    La zone de dessin affiche les variables du flux et la manière dont elles sont attribuées.
    
13. Vérifiez que les variables « email » (e-mail) et « memberNumber » (numéro de membre) sont définies sur « Agent Populated » (Agent complété).
    Si elles ne sont pas définies correctement, cliquez sur en regard de l’action Get Customer Details (Obtenir les détails sur le client) dans la barre latérale, supprimez l’action, puis revenez à l’étape 1 pour la recréer.
    

Enregistrement de votre progression

1. Cliquez sur Enregistrer.
   
2. Si la fenêtre Assign user record (Attribuer un enregistrement utilisateur) s’affiche, procédez comme suit.
   
   • Sélectionnez Select User (Sélectionner un utilisateur).
     
   • Dans le champ Agent’s User Record (Enregistrement utilisateur de l’agent), sélectionnez EinsteinServiceAgent User (Utilisateur EinsteinServiceAgent).
     
   • Cliquez sur Enregistrer.
     

Si vous voyez une erreur dans le panneau Explorer (Explorateur), ne vous en préoccupez pas pour l’instant ; nous la corrigerons plus tard.

Ajout de l’action Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact) à l’agent

1. Cliquez sur l’onglet Booked Activity Management (Gestion des activités réservées) pour revenir à la zone de dessin du sous-agent.
   
2. Dans la gélule Get Customer Details (Obtenir les détails sur le client) de la zone de dessin, cliquez sur et sélectionnez Create a custom action (Créer une action personnalisée).
   
   
3. Pour Action Name (Nom de l’action), saisissez Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact).
   
4. Pour Description, saisissez Find all the Booking records related to the guest's contact record. Only retrieve Bookings whose date hasn't occurred yet. (Rechercher tous les enregistrements de réservation liés à l’enregistrement de contact du client. Récupérer uniquement les réservations dont la date n’est pas encore passée.)
   
5. Pour Reference Action Type (Type d’action de référence), sélectionnez Flow (Flux).
   
6. Pour l’action de référence, sélectionnez Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact).
   
7. Cliquez sur Create and Open (Créer et ouvrir).
   
8. Configurez les paramètres d’entrée de la variable Contact_ID.
   
   • Si les sections Inputs (Entrées) et Outputs (Sorties) sont vides, accédez à un autre onglet, puis revenez à l’onglet Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact).
     
   • Assurez-vous que la description indique The Id of a Contact record that you would like to find related Booking records for. (L’ID d’un enregistrement de contact pour lequel tu souhaites rechercher des enregistrements de réservation associés.)
     Notez que la description par défaut correspond à la description de la variable Contact_ID dans le flux. Vous voyez la méthode ?
     
   • Cochez l’option Require input to execute action (Entrée requise pour exécuter l’action).
     
9. Configurez les paramètres de sortie de la variable Contact_Bookings.
   
   • Assurez-vous que la description indique The upcoming not-canceled bookings assigned to the contact whose ID matches the Contact_ID. (Les réservations à venir non annulées attribuées au contact dont l’ID correspond à la variable Contact_ID.)
   • Cochez Show in conversation (Afficher dans la conversation).
     
10. Configurez les paramètres de sortie de la variable Error_Message_Output.
    
    • Assurez-vous que la description indique The error message to show to the customer when this flow doesn't finish successfully. (Le message d’erreur à afficher au client lorsque ce flux ne se termine pas avec succès.)
    • Cochez Show in conversation (Afficher dans la conversation).
      
11. Cliquez sur Enregistrer.
    
12. Cliquez sur l’onglet Booked Activity Management (Gestion des activités réservées) pour revenir à la zone de dessin du sous-agent.
    
13. Sous Actions Available for Reasoning (Actions disponibles pour le raisonnement), cliquez sur en regard de la gélule Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact) dans la zone de dessin.
    La zone de dessin affiche les variables du flux et la manière dont elles sont attribuées.
    
14. Vérifiez que la variable « Contact_ID » est définie sur « Agent Populated » (Agent complété).
    Si cette variable n’est pas correctement définie, déplacez le curseur au-dessus de l’action Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact) dans la barre latérale, cliquez sur , supprimez l’action, puis revenez à l’étape 1 pour la recréer.
    

Mise à jour de la sortie Contact_Bookings

N’oubliez pas que Contact_Bookings est une variable de collection d’enregistrements dans le flux Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact). Les variables de collection d’enregistrements doivent être spécifiquement configurées dans le script du sous-agent. Dès lors, mettez à jour ce script afin d’éviter toute erreur future.

1. Cliquez sur l’onglet Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact).
   Si cet onglet n’apparaît pas, vous pouvez passer à l’étape suivante. En cliquant sur cet onglet, vous pourrez identifier plus facilement le texte dans les étapes suivantes. Toutefois, vous pouvez toujours utiliser la fonction Rechercher de votre navigateur (Ctrl+F sous Windows, Commande+F sur Mac) pour localiser le texte.
   
2. Dans la rangée d’onglets, sélectionnez la liste déroulante Canvas (Zone de dessin), puis choisissez Script.
   
   
3. Recherchez la ligne Contact_Bookings: object.
   
   
4. Remplacez Contact_Bookings: object par Contact_Bookings: list[object].
   
5. Recherchez la ligne complex_data_type_name: "lightning__listType", située quelques lignes après Contact_Bookings.
   
6. Remplacez complex_data_type_name: "lightning__listType" par complex_data_type_name: "lightning__recordInfoType".
   
7. Cliquez sur Enregistrer.
   
8. Dans la rangée d’onglets, repassez de la liste déroulante Script à Canvas (Zone de dessin).
   

Formulation d’instructions au sous-agent

Définissez à présent les instructions pour ce sous-agent.

1. Dans l’explorateur, cliquez sur le sous-agent Booked Activity Management (Gestion des activités réservées).
   
2. Dans Reasoning Instructions (Instructions de raisonnement), ajoutez ce paragraphe :
   Your job is only to help Coral Cloud Resort guests book activities, give them information about their existing booked activities, and cancel their booked activities. Do not use any Salesforce data that wasn't provided by an action's output. Do not show the customer any ID values. (Ton travail consiste uniquement à aider les clients de Coral Cloud Resort à réserver des activités, à leur fournir des informations sur leurs activités réservées existantes et à annuler leurs activités réservées. N’utilise aucune donnée Salesforce qui n’a pas été fournie par la sortie d’une action. Ne montre aucune valeur d’ID au client.)
   
3. Appuyez sur Entrée pour commencer une nouvelle ligne et ajouter un deuxième paragraphe :
   If the customer asks what their current booked activities are, run the Get_Contact_s_Upcoming_Bookings action and then present the output to the customer. (Si le client demande quelles sont ses activités actuellement réservées, exécute l’action Get_Contact_s_Upcoming_Bookings, puis présente la sortie au client.)
   
4. Dans le paragraphe précédent, sélectionnez le texte Get_Contact_s_Upcoming_Bookings et saisissez le signe @.
   Lorsque vous saisissez le signe @ dans les instructions, le générateur Agentforce affiche un menu contextuel permettant de faire référence à des actions, variables, sous-agents et autres options spécifiques directement dans ces instructions.
   
   

Si le générateur Agentforce n’affiche pas le menu contextuel lorsque vous saisissez le signe @, ignorez les étapes 4 et 5 et suivez plutôt les étapes suivantes.

1. Sélectionnez la liste déroulante Canvas (Zone de dessin), puis choisissez Script.
   
2. Recherchez la ligne d’instructions qui commence par If the customer asks (Si le client demande).
   
3. Dans cette ligne, entre les mots « the » et « action », insérez le texte suivant : {!@actions.Get_Contact_s_Upcoming_Bookings}.
4. Repassez de la liste déroulante Script à Canvas (Zone de dessin). Vos instructions devraient ressembler à l’image de l’étape 5.
   

5. Sélectionnez Actions, puis Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact).
   Vous devez faire référence à l’action Get Contact’s Upcoming Bookings (Obtenir les réservations à venir du contact) ici pour vous assurer qu’Agentforce exécute cette action.
   
   
6. Appuyez sur Entrée pour commencer une nouvelle ligne et ajouter un troisième paragraphe :
   After showing the customer a list of their activities, ask them how you can help them. (Après avoir présenté au client la liste de ses activités, demande-lui comment tu peux l’aider.)
   
7. Appuyez sur Entrée pour commencer une nouvelle ligne et ajouter un paragraphe supplémentaire :
   If the customer is not known, you must always ask for their email address and their membership number to get their Contact record by running the Get_Customer_Details action before running any other actions. (Si le client n’est pas connu, demande-lui toujours son adresse e-mail et son numéro de membre pour obtenir son enregistrement de contact en exécutant l’action Get_Customer_Details avant d’exécuter toute autre action.)
   
8. Dans le dernier paragraphe, sélectionnez le texte Get_Customer_Details et saisissez le signe @.
   

Si le générateur Agentforce n’affiche pas le menu contextuel lorsque vous saisissez le signe @, ignorez les étapes 8 et 9 et suivez plutôt les étapes suivantes.

1. Sélectionnez la liste déroulante Canvas (Zone de dessin), puis choisissez Script.
   
2. Recherchez la ligne d’instructions qui commence par If the customer is not (Si le client n’est pas).
   
3. Dans cette ligne, entre les mots « the » et « action », insérez le texte suivant : {!@actions.Get_Customer_Details}.
4. Repassez de la liste déroulante Script à Canvas (Zone de dessin). La quatrième instruction devrait maintenant contenir l’action Get Customer Details (Obtenir les détails sur le client).
   

9. Sélectionnez Actions, puis Get Customer Details (Obtenir les détails sur le client).
   
10. Enregistrez l’agent.
    

Test de l’agent

Maintenant que le sous-agent est prêt, vous pouvez le tester. Utilisez l’onglet Preview (Aperçu) du générateur Agentforce pour exécuter l’agent et vérifier qu’il fonctionne comme prévu.

1. Toujours dans le générateur Agentforce, cliquez sur l’onglet Preview (Aperçu).
   
   
2. Dans la zone Describe your task or ask a question (Décrivez votre tâche ou posez une question) du panneau Let’s Chat (Discutons), saisissez Can you show me my booked activities? (Peux-tu me montrer mes activités réservées ?), puis appuyez sur la touche Retour/Entrée.
   
3. Une fois que l’agent a répondu, saisissez l’instruction générative suivante : I am sofiarodriguez@example.com and my membership number is 10008155 (Je suis sofiarodriguez@exemple.com et mon numéro de membre est 10008155), puis appuyez sur la touche Retour/Entrée.
   

L’agent montre la liste des activités actuellement réservées par Sofia :

Here are your upcoming booked activities at Coral Cloud Resort:
Family Adventure Quest - August 8, 2026, 1:30 PM to 2:30 PM
Trail Running Adventure - August 11, 2026, 9:00 AM to 10:00 AM
Beach Bootcamp Challenge - August 12, 2026, 1:30 PM to 5:30 PM
Seaside Gourmet Dinner - August 12, 2026, 9:00 AM to 12:00 PM
Seaside Gourmet Dinner - August 13, 2026, 1:30 PM to 4:30 PM
Family Movie Night Under the Stars - August 22, 2026, 9:00 AM to 10:00 AM
Live Music Beach Party - August 23, 2026, 1:30 PM to 3:30 PM
Ocean Kayak Fitness Expedition - August 23, 2026, 9:00 AM to 3:00 PM
Coastal Kayak Excursion - August 28, 2026, 1:30 PM to 2:30 PM
Artisan Workshop Series - August 30, 2026, 1:30 PM to 2:30 PM

Félicitations, vous avez créé un flux qui rend votre agent plus précis et plus puissant, puis vous avez donné à cet agent les instructions dont il a besoin pour exécuter le flux de manière cohérente. Dans le défi pratique, vous ajoutez une action d’agent qui met à jour les enregistrements de réservation de votre client.

Ressources

• Aide Salesforce : Création d’une action personnalisée
• Aide Salesforce : Meilleures pratiques pour les instructions d’action des agents