Invoquer AgentForce Agent
Aperçu
Le Invoquer un agent Agentforce Cette interaction vous permet d'envoyer des messages à un agent Agentforce directement depuis un composant dynamique Avonni. Elle offre un moyen puissant d'intégrer une assistance alimentée par l'IA et une automatisation intelligente dans votre interface utilisateur, permettant aux utilisateurs d'exploiter les capacités de l'agent sans quitter la page en cours.
Important
Avant de pouvoir utiliser cette interaction, vous devez d'abord créer et configurer un agent Agentforce dans l'Agent Builder de Salesforce. Cette interaction est un connecteur entre votre composant dynamique et un agent existant — elle ne crée ni ne configure l'agent lui‑même
Ce dont vous avez besoin avant de commencer
Un agent Agentforce actif
Créé dans Salesforce Setup → Agent Builder
Complètement configuré avec des sujets, des actions et des instructions
Activé et prêt à recevoir des requêtes
Les autorisations sont configurées pour accéder aux données nécessaires
Le nom API de l'agent
Trouvé dans Agent Builder en affichant les détails de votre agent
C'est l'identifiant unique que vous utiliserez dans la configuration de l'interaction
Exemple :
Account_Summarizer_AgentouCustomer_Service_Agent
Sans agent créé dans Agent Builder, cette interaction ne fonctionnera pas. L'interaction déclenche un agent existant — tout le comportement IA, l'accès aux données et la logique de réponse doivent être configurés dans l'agent lui‑même.
Comment Agent Builder et les composants dynamiques fonctionnent ensemble
Agent Builder : L'endroit où vous définissez ce que fait l'agent, quelles données il peut accéder et comment il répond
Composants dynamiques : L'endroit où vous créez l'interface utilisateur qui déclenche l'agent et affiche ses réponses
Cette interaction : Le pont qui relie les actions utilisateur dans votre composant à l'exécution de l'agent dans Agent Builder
Nouveau sur Agentforce ? Apprenez à créer des agents dans la documentation Salesforce Agent Builder. Une fois votre agent prêt, revenez ici pour l'intégrer à vos composants dynamiques.
Composants pris en charge
Vous pouvez ajouter l'interaction "Invoquer un agent Agentforce" aux composants dynamiques Avonni suivants :
Bouton
Groupe de boutons
Menu de boutons
Icône de bouton
Table de données (Actions d'en-tête)
Élément de liste
Important
L'interaction "Invoquer un agent Agentforce" est conçue pour des invocations d'agent programmatiques qui s'exécutent en arrière‑plan. L'agent traite votre message et renvoie une réponse que vous pouvez capturer et utiliser dans votre composant dynamique.
Comment cela fonctionne
Action utilisateur : L'utilisateur interagit avec le composant (par exemple, clique sur un bouton).
Invocation de l'agent : L'interaction "Invoquer un agent Agentforce" envoie un message à l'agent Agentforce spécifié.
Passage de données (optionnel) : Vous pouvez transmettre des paramètres à l'agent pour fournir un contexte ou des instructions spécifiques.
Traitement par l'agent : L'agent traite le message en utilisant ses sujets, actions et capacités IA configurés.
Capture de la réponse (optionnel) : La réponse de l'agent peut être capturée dans une ressource pour être utilisée dans votre composant dynamique.
Actions post‑exécution (optionnel) : Vous pouvez configurer des actions à exécuter après la réponse de l'agent (par exemple, afficher un message toast en cas de succès ou d'erreur).
Configuration
L'interaction "Invoquer un agent Agentforce" relie une action utilisateur (comme cliquer sur un bouton) à un agent Agentforce. Lorsqu'elle est configurée, elle envoie un message à l'agent, transmet éventuellement des paramètres pour le contexte, capture la réponse de l'agent et gère les scénarios de succès ou d'erreur.
Ajoutez cette interaction à n'importe quel composant Avonni pris en charge via le panneau de propriétés du composant sous "Actions" ou "Interactions". Sélectionnez "Invoquer un agent Agentforce" comme type d'interaction.
Nom API de l'agent
Cela identifie quel agent Agentforce traitera votre requête. Saisissez le nom API de l'agent que vous avez créé dans Agent Builder. Il s'agit de l'identifiant unique qui indique à Salesforce quel agent invoquer lorsque l'interaction se déclenche.
Message utilisateur
Ceci est l'invite ou la question que vous envoyez à l'agent. Pensez-y comme à l'instruction que vous donnez à l'IA. Le message peut être :
Texte statique : Un message fixe comme "Résumer ce compte"
Dynamique avec syntaxe de correspondance : Incluez des variables de votre composant en utilisant
{!variableName}notation. Par exemple,"Pouvez‑vous résumer ce compte {!combobox1.selectedItemSObject.Id}"insère dynamiquement l'ID du compte sélectionné dans votre messageRiche en contexte : Combinez des instructions statiques avec des données dynamiques pour donner à l'agent tout ce dont il a besoin
L'agent reçoit ce message et le traite selon ses sujets et actions configurés.
Paramètres (Optionnel)
Les paramètres vous permettent de transmettre des données structurées supplémentaires à l'agent au‑delà du message utilisateur. C'est utile lorsque votre agent attend des entrées nommées spécifiques ou lorsque vous devez fournir un contexte séparément de l'invite principale.
Pour chaque paramètre que vous ajoutez :
Nom : L'identifiant du paramètre que votre agent attend (défini dans Agent Builder)
Valeur : Ce que vous transmettez - cela peut être une valeur fixe, un attribut de composant ou une variable de ressource
Utilisez des paramètres lorsque votre agent a besoin d'entrées structurées plutôt que de simplement analyser un message texte.
Nom de la ressource de réponse
Cela précise où l'interaction doit stocker la réponse de l'agent. Saisissez le nom d'une variable texte dans votre composant dynamique. Une fois que l'agent répond, sa réponse est automatiquement enregistrée dans cette variable, ce qui la rend disponible pour :
Afficher des composants texte
Utiliser des formules ou une logique conditionnelle
Déclencher des actions supplémentaires en fonction du contenu
Transmettre à d'autres interactions ou flux
Si vous ne spécifiez pas de ressource, l'agent traitera quand même votre requête, mais vous ne pourrez pas capturer ni afficher la réponse.
Exemple étape par étape
Résumé des comptes sélectionnés avec Agentforce
Construisons un exemple pratique où les utilisateurs peuvent sélectionner plusieurs comptes dans un tableau de données et obtenir un résumé alimenté par l'IA en cliquant sur un bouton.
Aperçu du scénario
Vous avez un tableau de données Avonni affichant une liste de comptes dans votre composant dynamique. Les utilisateurs peuvent :
Cocher un ou plusieurs comptes dans le tableau de données
Cliquer sur un bouton "Résumer la sélection" dans les actions d'en‑tête du tableau
Recevoir un résumé généré par l'IA des comptes sélectionnés par un agent Agentforce
Avant de commencer
Prérequis :
Un agent Agentforce créé et configuré dans Agent Builder
Un composant Avonni Data Table affichant des enregistrements de comptes
Le tableau de données est configuré avec la sélection de lignes activée (cases à cocher visibles)
Étapes de configuration
Préparez votre tableau de données
Tout d'abord, vous configurerez le tableau de données qui affiche vos comptes et le rendrez prêt pour que les utilisateurs sélectionnent des enregistrements et déclenchent l'agent. Cela crée la base de la fonctionnalité de résumé interactif.
Ajouter le tableau de données
Ajoutez un Avonni Data Table à votre composant dynamique
Configurez‑le pour afficher des enregistrements Account
Nom API : Notez‑le (par exemple,
Datatable1) - vous en aurez besoin plus tard pour référencer les lignes sélectionnées
Activer la sélection de lignes
Dans les propriétés du tableau de données, activez la sélection de lignes (cases à cocher)
Cela permet aux utilisateurs de sélectionner plusieurs comptes qu'ils souhaitent résumer
Ajouter un bouton d'action dans l'en‑tête
Dans les Actions d'en‑tête du tableau
Ajoutez un bouton avec un libellé comme "Résumer les comptes sélectionnés"
Ce bouton déclenchera l'invocation de l'agent lorsqu'on cliquera dessus
Créer une variable pour stocker la réponse de l'agent
Avant d'invoquer l'agent, vous avez besoin d'un emplacement pour stocker la réponse qu'il renverra. Cette variable capturera le résumé généré par l'IA afin que vous puissiez l'afficher aux utilisateurs ou l'utiliser ailleurs dans votre composant.
Créer une variable texte
Dans les ressources de votre composant dynamique
Nom API :
agentResponse(ou le nom de votre choix)Type de données : Texte
Ceci stockera le résumé renvoyé par l'agent
Configurer l'interaction "Invoquer un agent Agentforce"
Configurez maintenant ce qui se passe lorsque les utilisateurs cliquent sur le bouton "Résumer les comptes sélectionnés".
Sélectionnez votre bouton d'action d'en‑tête
Cliquez sur le bouton que vous avez créé à l'étape 1
Ajouter une interaction
Dans les propriétés du bouton, ajoutez une nouvelle action/interaction
Sélectionnez "Invoquer un agent Agentforce"
Configurer les paramètres de l'agent Remplissez les champs suivants dans la configuration de l'interaction : Nom API de l'agent Saisissez le nom API de votre agent depuis Agent Builder. Exemple :
Account_Summarizer_AgentPour trouver le nom API de votre agent : allez dans Agent Builder → sélectionnez votre agent → copiez le nom API depuis les détails de l'agent
Message utilisateur : Ceci est l'invite que vous envoyez à l'agent. Copiez et collez le modèle ci‑dessous, puis personnalisez‑le si nécessaire :
Système :
Vous êtes un analyste commercial connaissant bien Salesforce. Soyez concis et structuré.
Utilisateur :
Résumez les comptes Salesforce suivants sélectionnés par l'utilisateur.
Inclure : nombre de comptes, ARR/Revenu annuel total (si présent), principales industries, produits courants, espaces d'opportunité notables, et un résumé exécutif en 5 points.
IDs des enregistrements :
{!Datatable1.selectedRowsKeyValue}Important : Remplacez Datatable1 par le nom API réel de votre tableau de données.
Ce que cela fait :
{!Datatable1.selectedRowsKeyValue}insère dynamiquement les IDs de tous les comptes sélectionnés par l'utilisateurL'agent reçoit ces IDs et peut interroger Salesforce pour obtenir les détails complets des comptes.
Nom de la ressource de réponse
Saisissez : agentResponse
Il s'agit du nom de la variable que vous avez créé à l'étape 2. Le résumé de l'agent y sera stocké.
Afficher la réponse de l'agent
Maintenant que l'interaction avec l'agent est configurée et stockera sa réponse dans la agentResponse variable, vous devez afficher ce résumé aux utilisateurs. Nous ajouterons un composant qui affiche la réponse de l'agent et n'apparaît qu'après que l'agent a renvoyé des résultats.
Ajouter un composant d'affichage
Ajoutez un composant pour afficher le résumé (par ex., Carte de profil, Texte d'affichage, ou Texte enrichi composant)
Placez‑le à un emplacement visible sur la toile de votre composant dynamique
Configurer le contenu du composant
Dans les propriétés du composant, trouvez le champ pour afficher le contenu texte
Définissez la valeur sur
{!agentResponse}Ceci affichera ce que l'agent renvoie
Définir la visibilité du composant (Optionnel mais recommandé)
Sélectionnez votre composant d'affichage
Trouvez Définir la visibilité du composant dans le panneau des propriétés
Créez une condition pour que le composant n'apparaisse que lorsqu'il y a une réponse à afficher :
{!agentResponse} N'EST PAS NULLCe que cela fait : Le composant reste caché jusqu'à ce que l'agent renvoie une réponse. Une fois que agentResponse contient des données, le composant apparaît automatiquement avec le résumé.
Ce que vous avez accompli : Les utilisateurs verront désormais le résumé généré par l'IA apparaître à l'écran lorsqu'ils cliqueront sur le bouton "Résumer les comptes sélectionnés". Le composant de résumé reste caché tant qu'il n'y a pas de contenu à afficher, gardant votre interface propre
Considérations importantes
Configuration de l'agent : Assurez‑vous que votre agent Agentforce est correctement configuré avec les sujets, actions et autorisations nécessaires pour gérer vos requêtes.
Format du message : Structurez clairement votre message utilisateur pour aider l'agent à comprendre l'intention. Incluez le contexte pertinent en utilisant la syntaxe de correspondance.
Noms des paramètres : Si vous utilisez des paramètres, assurez‑vous que les noms des paramètres correspondent à ce que votre agent attend.
Gestion des réponses : Planifiez comment vous utiliserez la réponse de l'agent — que ce soit pour l'afficher aux utilisateurs, mettre à jour des enregistrements ou déclencher des actions supplémentaires.
Gestion des erreurs : Utilisez l'action "En cas d'erreur" pour gérer gracieusement toute erreur pouvant survenir lors de l'invocation de l'agent.
Performance : Les invocations d'agent peuvent prendre quelques secondes pour être traitées. Envisagez d'ajouter des indicateurs de chargement ou des messages informatifs pour gérer les attentes des utilisateurs.
En résumé
L'interaction "Invoquer un agent Agentforce" est une fonctionnalité précieuse pour ajouter une intelligence alimentée par l'IA à vos composants dynamiques. Les paramètres de configuration incluent la spécification de l'agent à invoquer, la rédaction du message utilisateur avec un contexte dynamique, le passage de paramètres, la capture de la réponse et la définition des actions de succès et d'erreur
Mis à jour
Ce contenu vous a-t-il été utile ?