Skip to main content

Durée estimée

Environ 15 min

Thèmes

Besoin d'aide ?

Demander à la communauté

Comptez un délai de 24 à 48 heures pour obtenir une réponse de la part du service d'aide ou de la communauté.

Création d’une action d’agent Apex

Objectifs de formation

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

  • Créer une action d’agent Apex
  • Ajouter une action d’agent à une rubrique
  • Tester l’action de l’agent
Remarque

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.

Création d’une action d’agent Apex

Maintenant qu’Apex est prêt, ajoutons-le à une action. Vous verrez que les paramètres d’Apex sont automatiquement portés vers l’action.

  1. Cliquez sur Setup (Configuration) et sélectionnez Setup (Configuration).
  2. Dans la zone Quick Find (Recherche rapide), recherchez et sélectionnez Agentforce Assets (Actifs Agentforce).
  3. Cliquez sur l’onglet Actions.
  4. Cliquez sur New Agent Action (Nouvelle action d’agent).
  5. Pour le type Reference Action (Action de référence), sélectionnez Apex.
  6. Pour la catégorie Reference Action (Action de référence), sélectionnez Invocable Method (Méthode invocable).
  7. Pour l’action de référence, sélectionnez Check Weather (Vérifier la météo). Il s’agit de la méthode invocable.

    Fenêtre Create an Agent Action (Créer une action d’agent) affichant les champs décrits ci-dessus.
  1. Pour Agent Action Label (Étiquette de l’action d’agent), laissez la valeur préremplie, Check Weather (Vérifier la météo), qui a été extraite du paramètre d’étiquette de la méthode invocable.
  2. Pour Agent Action API Name (Nom d’API de l’action d’agent), laissez la valeur préremplie générée automatiquement, Check_Weather.
  3. Cliquez sur Next (Suivant).

L’étape suivante consiste à configurer l’action de l’agent. C’est là que vous commencez à voir les avantages des paramètres définis dans Apex.

  1. Pour les instructions de l’action d’agent, laissez la valeur préremplie fournie par le paramètre de description de la méthode invocable Apex.
  2. Désélectionnez Show loading text for this action (Afficher le texte de chargement de cette action).
  3. Pour l’entrée, remarquez que dateToCheck est prérempli.
  4. Pour Instructions, notez que le champ est prérempli avec le paramètre de description de la variable invocable Apex. Vous pouvez également mettre à jour ou compléter les instructions si nécessaire.
  5. Pour Data Type (Type de données), le champ est prérempli avec le type de données Apex.
  6. L’option Require Input (Entrée requise) est cochée par défaut, avec le paramètre requis défini sur true.
  7. Cochez la case Collect data from user (Collecter les données de l’utilisateur).

    Section d’entrée remplie comme décrit dans le contenu.
  1. Pour les sorties, trois sont extraites des variables invocables Apex, maxTemperature, minTemperature et temperatureDescription. Les instructions respectives sont préremplies à partir des paramètres de description et du type de données correspondants.
  2. Pour la troisième sortie, temperatureDescription, cochez Show in conversation (Afficher dans la conversation).

    La troisième sortie est remplie comme décrit ci-dessus, avec la case Show in conversation (Afficher dans la conversation) cochée.
  1. Cliquez sur Terminer.

Excellent ! L’action est complète. Vous savez maintenant ce qu’il faut faire pour ajouter Apex aux actions. Et vous comprenez mieux comment les paramètres Apex fonctionnent pour vous aider à élaborer l’action. Ajoutons l’action d’agent Check Weather (Vérifier la météo) à une rubrique et testons-la.

Mise à jour de la rubrique

  1. Cliquez sur Setup (Configuration) et sélectionnez Setup (Configuration).
  2. Dans la zone Quick Find (Recherche rapide), recherchez et sélectionnez Agentforce Agents (Agents Agentforce).
  3. Sélectionnez Einstein Copilot ou Agentforce (par défaut).
  4. Cliquez sur Open in Builder (Ouvrir dans le générateur).
  5. Assurez-vous que l’agent est désactivé.
  6. Sélectionnez MigrationDefaultTopic.
  7. Cliquez sur This Topic’s Actions (Actions de cette rubrique).
  8. Cliquez sur New (Nouveau), puis sélectionnez Add from Asset Library (Ajouter depuis la Bibliothèque d’actifs).
  9. Cochez la case de l’action Check Weather (Vérifier la météo) et cliquez sur Finish (Terminer).
  10. Actualisez la fenêtre de votre navigateur, puis sélectionnez MigrationDefaultTopic.
  11. Cliquez sur This Topic’s Actions (Actions de cette rubrique) et vérifiez que l’action Check Weather (Vérifier la météo) figure toujours dans la liste. Si ce n’est pas le cas, répétez les étapes 8 à 11. Parfois, dans nos environnements d’essai, une action ajoutée ne reste pas associée à la rubrique la première fois que vous l’enregistrez.
  12. Cliquez sur Activer. Remarque : si la fenêtre contextuelle Configuration Issues Detected (Problèmes de configuration détectés) s’affiche, cliquez sur Ignore & Activate (Ignorer et activer).

Consultation de la météo

  1. Dans le générateur Agentforce, saisissez Check the weather for tomorrow (Vérifie la météo de demain) dans l’aperçu de la conversation.

    Volet de conversation montrant la requête Check the weather for tomorrow (Vérifie la météo de demain) et la réponse de l’agent indiquant les températures à Coral Cloud.
  1. Observez les étapes suivies par l’agent et remarquez qu’il a sélectionné l’action Check Weather (Vérifier la météo) pour répondre à la requête.

    Étapes du générateur Agentforce affichant l’invite, sélection de Migration Default Topic (Rubrique de migration par défaut) puis l’action Check Weather (Vérifier la météo).
  1. Vous souhaitez connaître les prévisions météorologiques pour la semaine prochaine ? Saisissez Check the weather for next week (Vérifie la météo de la semaine prochaine).
  2. Examinez de nouveau les étapes. L’agent a envoyé la date de chaque jour de la semaine pour élaborer la réponse.

    Étapes du générateur Agentforce montrant plusieurs appels à l’action Check Weather (Vérifier la météo) avec différentes entrées de date.

Bravo ! Vous avez fait un grand pas vers l’utilisation de toutes les fonctionnalités Apex dont votre organisation dispose déjà et vous les avez mises à la disposition des agents IA. Vous avez appris quelques meilleures pratiques et comment définir les paramètres pour tirer le meilleur parti de vos agents.

Ressources

Partagez vos commentaires sur Trailhead dans l'aide Salesforce.

Nous aimerions connaître votre expérience avec Trailhead. Vous pouvez désormais accéder au nouveau formulaire de commentaires à tout moment depuis le site d'aide Salesforce.

En savoir plus Continuer à partager vos commentaires