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 à un sous-agent
  • 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. Dans le lanceur d’application , recherchez et sélectionnez Agentforce Studio (Studio Agentforce).
  2. Cliquez sur Agent Customization (Personnalisation d’agent).
  3. Cliquez sur New version (Nouvelle version).
  4. Sous Subagents (Sous-agents), sélectionnez Answer Weather Questions (Répondre aux questions concernant la météo).
  5. Sous Actions Available For Reasoning (Actions disponibles pour le raisonnement), cliquez sur Select action (Sélectionner l’action) et choisissez Create a custom action (Créer une action personnalisée).
  6. Dans Action Name (Nom de l’action), entrez Check Weather (Vérifier la météo).
  7. Dans la description, entrez This action will return the local weather information. (Cette action renvoie les informations météorologiques locales.).
  8. Pour le type Reference Action (Action de référence), sélectionnez Apex.
  9. Pour la catégorie Reference Action (Action de référence), sélectionnez Invocable Method (Méthode invocable).
  10. Pour l’action de référence, sélectionnez Check Weather (Vérifier la météo).
  11. Cliquez sur Create and Open (Créer et ouvrir).

Vous remarquerez que dans la section Inputs (Entrées), dateToCheck est préremplie avec une description provenant du paramètre de description de variable invocable d’Apex. Vous pouvez mettre à jour ou compléter les instructions si nécessaire.

  1. Assurez-vous que l’option Require input to execute action (Entrée requise pour exécuter l’action) est cochée par défaut. Pour cela, définissez le paramètre requis sur True dans le code.
    Inputs (Entrées) conformément à la description ci-dessus.

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.

  1. Pour la troisième sortie, temperatureDescription, cochez Show in conversation (Afficher dans la conversation).
    temperatureDescription avec l’option Show in conversation (Afficher dans la conversation) cochée.
  1. Cliquez sur Enregistrer.
  2. Cliquez sur Commit Version (Engager la version).
  3. Cliquez de nouveau sur Commit Version (Engager la version).
  4. Cliquez sur Activer.
  5. Cliquez de nouveau sur Activate (Activer).

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. Vous pouvez désormais la tester.

Consultation de la météo

Le Générateur Agentforce vous permet d’utiliser l’agent et d’afficher un aperçu directement dans l’outil.

  1. Dans le Générateur Agentforce, cliquez sur Preview (Prévisualiser).
  2. Vous devez être en mode Test réel.
  3. Dans la zone Describe your task or ask a question (Décrivez votre tâche ou posez une question), saisissez What’s the weather like this Monday? (Quel temps fait-il ce lundi ?) et appuyez sur Entrée. L’agent peut vous demander une date exacte et vous donner la possibilité d’en choisir une. Sélectionnez la date de lundi prochain et validez.

  4. Volet de conversation montrant la requête What’s the weather like this Monday (Quel temps fait-il ce lundi ?) et la réponse de l’agent indiquant les températures à Coral Cloud.

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 présentant Input (Entrée), Reasoning (Raisonnement), Transition to Subagent: Answer_Weather_Questions (Transition vers le sous-agent : Answer_Weather_Questions) et Reasoning: Answer Weather Questions (Raisonnement : Répondre aux questions concernant la météo).

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