Exécuter l'élément Agent
Utilisez un agent Agentforce pour gérer dynamiquement les tâches de votre flux. Sélectionnez un agent existant ou créez un agent avec des instructions et des actions personnalisées.
Éditions requises
Autorisations
Pour utiliser des agents existants dans vos flux, l'autorisation utilisateur Afficher la configuration est requise. pour créer des agents à partir de Flow Builder, l'autorisation utilisateur Personnaliser l'application, Générateur Einstein Copilot, Générateur de plate-forme Einstein Agent ou Générateur Copilot en libre-service est requise. Les utilisateurs qui ont le profil Administrateur système peuvent créer et utiliser des agents.
Si vous n'êtes pas autorisé(e) à créer des agents, le bouton Créer un agent n'est pas affiché dans le panneau de sélection des agents. Vous pouvez sélectionner uniquement des agents existants.
Utilisation
Ajoutez un élément Exécuter l'agent à votre flux. Dans le champ Agent, recherchez et sélectionnez un agent actif, ou cliquez sur Créer un agent pour en élaborer un nouveau.
Sélection d'un agent existant
Pour utiliser un agent existant, recherchez-le par son nom dans le champ Agent. Seuls les agents actifs sont affichés dans la liste. Après avoir sélectionné un agent, configurez ses entrées et sorties dans le panneau des propriétés.
Création d'un agent
Pour créer un agent, cliquez sur Créer un agent. Dans la fenêtre Nouvel agent, configurez les informations de base de l'agent.
| Champ | Description |
|---|---|
| Étiquette | Le nom de l'agent. |
| Nom d'API | La nécessité d'utiliser des éléments uniques s'applique uniquement aux éléments inclus dans le flux actuel. Deux éléments peuvent porter le même nom d'API, à condition qu'ils soient utilisés dans des flux différents. Un nom d'API peut inclure des traits de soulignement et des caractères alphabétiques sans espace. Il doit commencer par une lettre et ne peut pas se terminer par un trait de soulignement. Il ne peut pas non plus inclure deux traits de soulignement consécutifs. |
| Description | Une description de ce que fait l'agent. |
| Accès utilisateur | L'enregistrement utilisateur que l'agent exécute. Sélectionnez un utilisateur existant ou demandez au système de créer un utilisateur. |
| Instructions | Des instructions qui décrivent ce que fait l'agent et guident son raisonnement. |
| Actions | Les actions que l'agent peut utiliser. Sélectionnez des actions existantes dans la bibliothèque d'actifs ou créez des actions personnalisées. |
Ajout d'actions à l'agent
L'agent a besoin d'au moins une action pour exécuter des tâches. Ajoutez des actions avant de cliquer sur Créer et activer ou dans Agentforce Builder après avoir activé l'agent.
Pour sélectionner des actions existantes, cliquez sur Sélectionner Actions. Recherchez et sélectionnez une ou plusieurs actions dans la bibliothèque d'actifs, puis cliquez sur Ajouter à l'agent. Les actions disponibles comprennent les actions Knowledge, les flux configurés en tant qu'actions invocables et les actions standard.
Pour créer une action, cliquez sur Créer une action. Dans la fenêtre Créer une action, configurez l'action.
| Champ | Description |
|---|---|
| Étiquette de l'outil Agent | Le nom de l'action. |
| Nom d'API | La nécessité d'utiliser des éléments uniques s'applique uniquement aux éléments inclus dans le flux actuel. Deux éléments peuvent avoir le même nom d'API, à condition d'être utilisés dans des flux différents.Un nom d'API peut contenir des traits de soulignement et des caractères alphanumériques sans espace. Il doit commencer par une lettre et ne peut pas se terminer par un trait de soulignement. Il ne peut pas non plus inclure deux traits de soulignement consécutifs. |
| Description | Le nom de l'action. L'agent utilise ces informations pour déterminer comment et quand utiliser cette action. |
| Type d'action de référence | Le type d'action, Flux ou Apex par exemple. |
| Catégorie d'action | Le sous-type du type d'action de référence. Les actions n'ont pas toutes une catégorie d'action de référence. |
| Action de référence | Le nom de l'action à référencer. |
Pour chaque entrée, ajoutez une description de son action. L'agent utilise la description pour déterminer comment utiliser l'entrée en appelant l'action. Sélectionnez Exiger l'entrée pour rendre l'entrée obligatoire.
Pour chaque sortie, ajoutez une description des retours de sortie et comment utiliser le résultat dans le flux. Sélectionnez Filtrer dans le contexte de l'agent pour exclure la sortie du raisonnement de l'agent. Sélectionnez Afficher dans la conversation pour inclure cette sortie dans la réponse de l'agent.
Cliquez sur Créer et activer pour créer et activer votre agent.
Configuration de l'élément
Après avoir sélectionné ou créé un agent, configurez l'élément Exécuter l'agent dans le panneau des propriétés.
| Champ | Description |
|---|---|
| Étiquette | L'étiquette de l'action dans la zone de dessin et dans le Gestionnaire de boîte à outils. |
| Nom d'API | La nécessité d'utiliser des éléments uniques s'applique uniquement aux éléments inclus dans le flux actuel. Deux éléments peuvent avoir le même nom d'API, à condition d'être utilisés dans des flux différents.Un nom d'API peut contenir des traits de soulignement et des caractères alphanumériques sans espace. Il doit commencer par une lettre et ne peut pas se terminer par un trait de soulignement. Il ne peut pas non plus inclure deux traits de soulignement consécutifs. |
| Description | La description de l'élément. |
Définition des valeurs d'entrée
Configurez les entrées de l'élément Exécuter l'agent dans le panneau des propriétés.
| Champ | Description |
|---|---|
| Demande de l'agent | Une question ou une requête à envoyer à l'agent pour cette exécution de flux. L'agent applique ses instructions à cette requête spécifique pour générer une sortie. |
| ID de session | Facultatif. Utilisez l'ID de session renvoyé par un élément Exécuter l'agent exécuté précédemment dans le flux. L'agent conserve son contexte de raisonnement complet et la mémoire de cette conversation. Si vous ne saisissez pas d'ID de session, l'agent initie une nouvelle conversation, mais vous pouvez toujours spécifier les sorties des éléments précédents Exécuter l'agent en tant qu'entrées. |
Configuration d'une sortie structurée
Pour configurer l'agent afin de renvoyer des données structurées que votre flux peut utiliser, définissez des champs de sortie structurés. Chaque champ représente une information que l'agent extrait ou génère.
Si vous configurez une sortie structurée, l'agent renvoie uniquement des données structurées dans le champ Réponse structurée de l'agent. Le champ Réponse de l'agent renvoie null. Si vous ne configurez pas de sortie structurée, l'agent renvoie uniquement un texte non structuré dans le champ Réponse de l'agent.
Pour configurer une sortie structurée, cliquez sur Configurer. Configurez les champs de chaque champ de sortie structuré :
| Champ | Description |
|---|---|
| Nom du champ | Obligatoire. Le nom alphanumérique unique du champ de sortie structuré. Le nom ne peut pas contenir de caractères spéciaux ou d'espaces. |
| Description | Une brève description utilisée avec le nom du champ pour augmenter la précision du grand modèle de langage (LLM). |
| Type de données | Obligatoire. Le type de données du champ. Les valeurs valides sont : Chaîne, Numérique, Booléen. |
| Obligatoire | Indique que le grand livre doit générer une réponse pour ce champ de sortie. L'exigence de lignes de sortie peut entraîner des réponses imprécises ou préjudiciables de la part du grand livre. |
Stockage des valeurs de sortie
| Champ | Description |
|---|---|
| Réponse de l'agent | La réponse non structurée de l'agent. Renvoie null si la sortie structurée est configurée. |
| ID de session | L'ID de la session de conversation à laquelle participe la réponse de l'agent. |
| Réponse structurée de l'agent | La sortie structurée de l'agent. Renvoie null si aucune sortie structurée n'est configurée. |
Utilisation structurée des sorties
Avant de configurer une sortie structurée, saisissez une étiquette et un nom d'API pour l'élément Exécuter l'agent, puis enregistrez le flux.
Lorsque vous configurez une sortie structurée, définissez au moins 1 champ de sortie structuré avant d'enregistrer.
Pour chaque champ de sortie structuré défini, deux champs sont créés : une avec le nom défini et un champ booléen _set associé. Par exemple, si vous définissez un champ de sortie structuré nommé summary, un champ booléen nommé summary_set est également créé.
| Champ | Description |
|---|---|
| True | Le champ était inclus dans la réponse structurée de l'agent, mais n'avait aucune valeur définie. |
| False | Le champ n'était pas inclus dans la réponse structurée de l'agent. |
Lorsqu'une sortie structurée définie renvoie null, utilisez son champ _set associé plus loin dans le flux pour déterminer pourquoi le champ est null.
Notes d'utilisation
- Testez votre flux avant de l'activer pour vous assurer que l'élément Exécuter l'agent fonctionne normalement.
- Vous pouvez rechercher et modifier à tout moment les agents créés dans Flow Builder dans Agentforce Builder.
- À compter de l’API version 67.0, les actions Agent IA ne sont plus disponibles dans l’élément Action. Utilisez l'élément Exécuter un agent pour travailler avec des agents. Lorsque vous ouvrez un flux avec un élément Action qui référence une action Agent IA, il est automatiquement affiché en tant qu'élément Exécuter l'agent. Votre configuration d'origine est conservée.
