Vous êtes ici :
Meilleures pratiques pour les instructions d'action des agents
Les instructions d'action indiquent à un agent l'action que vous exécutez et quand l'utiliser. Lorsque vous créez une action personnalisée, planifiez et testez soigneusement vos instructions pour vous assurer que votre action fonctionne normalement.
É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. |
Les noms et les instructions des actions des agents, ainsi que leurs entrées et sorties, déterminent quand et comment une action est utilisée. Les agents IA utilisent un grand modèle de langage (LLM) et le moteur de raisonnement pour rechercher parmi tous les sous-agents et actions attribués à un agent, et sélectionner un ou plusieurs à exécuter dans la conversation, en fonction de la question ou de la demande de l'utilisateur. Plus les instructions sont efficaces, plus l'action est prévisible.
Les instructions efficaces varient selon l'action et le cas d'utilisation. Pour de meilleurs résultats, testez votre action dans Agentforce Builder, puis itérez jusqu'à ce que votre action réponde à vos besoins.
Instructions pour les actions
Les instructions d'action décrivent votre action et quand l'utiliser dans une conversation. L'élément le plus important des instructions d'action est une description concise en langage naturel de ce que votre action fait, généralement une à trois phrases écrites en tant qu'instruction pour le grand livre. La description peut inclure le but ou la tâche de l'action, tous les cas d'utilisation de l'action, et les objets ou les enregistrements qu'elle utilise ou modifie. En général, plus vous incluez de détails pertinents dans vos instructions, plus il est facile pour le grand livre de différencier les actions.
| Exemple d'action d'agent | Description moins efficace | Description plus efficace |
|---|---|---|
| Mise à jour du numéro de téléphone du contact | Met à jour un numéro de téléphone. | Met à jour le numéro de téléphone de l'utilisateur associé à son enregistrement de contact. Si aucun contact correspondant n'existe, crée un enregistrement de contact. |
| Enregistrements de requête | Permet d'utiliser le langage naturel pour interroger des informations sur les enregistrements Salesforce CRM. | Recherche et récupère des enregistrements Salesforce CRM en fonction de l'entrée de l'utilisateur et de conditions spécifiques, telles que des valeurs de champ. Cette action identifie automatiquement les enregistrements et le type d'objet appropriés. |
| Suivre la commande | Action de récupération des informations de suivi d'une commande. | Renvoie les informations de suivi d'une commande client en fonction du numéro de suivi et du code postal de destination. |
Dans la plupart des cas, la description en langage naturel suffit pour qu'un agent puisse utiliser votre action normalement. Cependant, certaines actions nécessitent plus de détails après le test. Voici quelques options pour affiner la description de votre action.
| Ce qu'il faut inclure | Utilisation | Exemples |
|---|---|---|
| Un à trois énoncés, ou exemples d'entrées clients | Incluez des exemples de messages clients qui devraient déclencher votre action pour aider le grand livre à faire correspondre une entrée client donnée à votre action. Si vous incluez plusieurs énoncés, réduisez les chevauchements.
|
|
| Actions dépendantes | Certaines actions utilisent d'autres actions, souvent des actions système, pour récupérer les informations requises. Si une action requise est manquante dans un plan ou si les actions ne sont pas appelées dans le bon ordre, vous pouvez les spécifier par nom d'API. | L'actionIdentifieRecordByName doit être appelée directement avant cette action pour obtenir un ID d'enregistrement unique en entrée. Si l'actionIdentifieRecordByName fait partie du plan, elle doit être exécutée avant GetRecordFieldsAndValues. |
| Exemples de fonctionnement de l'action | Les exemples ne se généralisent pas bien, mais ils peuvent être utiles lorsqu'un agent commet une erreur de manière répétée. En général, les grands modèles de langage comprennent des exemples de ce qu'il faut faire mieux que des exemples de ce qu'il ne faut pas faire, mais vous pouvez tester avec l'un ou l'autre. |
Cette action doit être appelée uniquement lorsqu'une action de synthèse plus spécifique n'est pas disponible. |
Instructions pour les entrées et les sorties
Les instructions d'entrée et de sortie indiquent comment mettre en forme et utiliser le paramètre. Dans les instructions d'une entrée, spécifiez les informations requises pour exécuter l'action. Dans les instructions d'une sortie, spécifiez le résultat de l'action et ce qu'un agent renvoie à l'utilisateur.
Les modèles de langage de grande taille (LLM) ne comprennent pas parfaitement le contexte, y compris le contexte Salesforce. En d'autres termes, un LLM ne connaît pas toujours le nombre de caractères dans un ID d'enregistrement Salesforce ni les noms des objets Salesforce. Des instructions concises, mais détaillées aident un agent à récupérer les informations nécessaires et à renvoyer des résultats pertinents. La meilleure façon de déterminer le niveau de détail approprié est de tester et d'itérer sur vos instructions.
Lors de la rédaction d'instructions pour une entrée ou une sortie, tenez compte des points suivants :
- Le type de données des informations : « un ID à 18 caractères », « une réponse en texte enrichi à la question de l'utilisateur ».
- Tous les champs ou valeurs spécifiques : « contient l’ID de contact et la date de livraison prévue ».
- Comment les informations sont récupérées ou générées : « Pour un nouvel e-mail, récupérez l'ID dans l'entrée de l'utilisateur. Pour un e-mail révisé, récupérez l'ID dans l'historique des conversations. »
- Toute règle spéciale concernant l'utilisation de l'action : « Ne générez pas de SQL ou SOQL. », « Obligatoire uniquement lorsque l'utilisateur souhaite réviser un brouillon antérieur. », « Le nom d'API est utilisé pour identifier des paires champ-valeur d'enregistrement Salesforce à partir de la requête de l'utilisateur. »
Voici quelques exemples d'instructions efficaces pour les entrées et les sorties.
| Paramètre d'entrée ou de sortie | Instructions |
|---|---|
| recordId | L'ID unique de l'enregistrement Salesforce CRM pour lequel créer le résumé. Par exemple : recordId, record_id, recordIds[0], accountId. |
| objectApiName | Le nom d'API de l'objet Salesforce (tel que Compte ou Opportunité) associé à l'enregistrement que l'utilisateur souhaite retrouver. Le nom peut être obtenu à partir du contexte et ne nécessite pas l'actionIdentifieObjectByName. |
| summary | Le résumé de texte enrichi créé pour l'enregistrement spécifié. |
| searchResults | Une liste des ID d'enregistrement Salesforce CRM correspondants par ordre décroissant de pertinence. |
| generatedEmail | Un objet JSON qui contient l'ID de destinataire, la ligne d'objet et le corps de l'e-mail. |
