Actions de l'agent IA
Créez une réponse d'agent IA pour le message utilisateur spécifié. L'agent doit être actif.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition et Developer Edition. Les licences complémentaires requises varient selon le type d'agent. |
| Afficher les licences de fonctionnalités intégrées. |
Dans Flow Builder, ajoutez un élément Action vers votre flux. Sélectionnez la catégorie Actions de l'agent IA. Sélectionnez ensuite le nom de l'agent avec lequel créer une réponse.
Le nom d'API de chaque action est précédé de generateAIAgentResponse.
Définition des valeurs d'entrée
| Paramètre d'entrée | Description |
|---|---|
| Demande de l'agent | Une question ou une requête à envoyer à l'agent qui génère la sortie de cette action. Ce champ est disponible dans les versions 1.1.0 et supérieures. |
| Message utilisateur | Une question ou une requête à envoyer à l'agent qui génère la sortie de cette action. Ce champ est disponible dans les versions 1.0.0 et antérieures. |
| ID de session | L'ID de la session de conversation dans laquelle envoyer les réponses de l'agent. |
Configuration d'une sortie structurée
Pour configurer une sortie structurée, utilisez l'action version 1.1.0 et supérieure.
| 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 :
|
| 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. Ce champ est disponible dans les versions 1.1.0 et supérieures. |
Utilisation
Cette action est disponible uniquement si ces critères sont remplis. Sinon, l'action échoue.
- Agentforce est activé.
- L'utilisateur qui exécute le flux dispose de l'autorisation Gérer les agents IA.
- L'agent spécifié a une version active.
Les entrées spécifiques à l'action d'agent personnalisé sélectionnée sont répertoriées après la section Configurer une sortie structuré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 Action, puis enregistrez le flux.
Lorsque vous configurez une sortie structurée, définissez au moins 1 champ de sortie structuré avant d'enregistrer.
Lorsqu'une action personnalisée de l'agent a configuré une sortie structurée, Sortie structurée actuelle affiche le type de données structuré associé.
Pour chaque champ de sortie structuré défini, deux champs sont créés : une avec le nom défini et un champ booléen associé _set. Par exemple, si vous définissez un champ de sortie structuré nommé summary, un champ booléen nommé summary_set est également créé.
| Valeur de variable | 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.
