Connecter les guides à des services externes par des actions sur les données
- L'agent virtuel a été activé sur dans votre organisation. Pour plus d'informations, contactez votre Customer Success Manager désigné.
- Autorisations du studio AI pour les guides. Pour plus d'informations sur les autorisations requises, voir AI Studio permissions.
Les actions sur les données permettent à vos agents d'intelligence artificielle d'accéder à des sources de données externes et d'utiliser les données récupérées pour effectuer la tâche en question. Au cours d'une conversation, votre agent IA peut récupérer des informations pertinentes sur un contact à partir d'une base de données CRM, telles que le nom, l'adresse, les numéros de contact, le numéro de compte ou le statut du compte.
Pour plus d'informations sur la création d'une action de données personnalisée, voir Créer une action personnalisée pour les intégrations.
Utiliser les actions de données
- Cliquez sur Admin.
- Sous AI Studio, cliquez sur Guides.
- Ouvrir un guide existant ou en créer un nouveau.
- Dans l'onglet Instructions, placez votre curseur à l'endroit où vous souhaitez insérer une action de données et tapez /.
Une boîte de dialogue contextuelle s'affiche et propose des options pour insérer une action ou une variable de données. - Sélectionnez Data Actions. La boîte de dialogue répertorie maintenant les actions de données disponibles.
- Sélectionnez l'action de données requise. L'éditeur met en évidence les variables présentes dans votre guide par un soulignement bleu.
- Pour afficher plus de détails sur l'action de données, cliquez sur le nom de l'action de données.
Le panneau de droite se développe et affiche des informations sur l'action de données. Cliquez sur View pour ouvrir l'action de données spécifique dans un nouvel onglet du navigateur ou cliquez sur Done pour fermer le panneau et revenir à l'onglet des instructions. - Cliquez sur Sauvegarder.
- Ensure that all parameters on both the input and output contracts of the data action have proper descriptions.
- If you have variables in the guide that match one or more parameters of the data action, ensure that the parameter names match correctly.
- Le nombre maximum d'actions de données que vous pouvez avoir dans un guide est de cinq.
- Le nombre maximum de paramètres d'entrée d'une action de données que vous pouvez utiliser dans un guide est de quatre.
- Le nombre d'invocations d'actions de données dans un guide est pris en compte dans les limites d'exécution d'actions de données par session.
Disponibilité des actions de données
- Les actions de données sécurisées ne sont pas disponibles dans les guides.
- Les actions sur les données peuvent ne pas être disponibles pour la sélection dans les guides si elles sont configurées comme suit :
- Actions sur les données avec des paramètres de valeur nulle
- Actions sur les données avec plus de quatre paramètres d'entrée
- Actions sur les données avec une dénomination incorrecte. Le nom de l'action de données doit être conforme aux exigences suivantes :
- Doit être inférieur à 100 caractères
- Doit commencer par un caractère alphanumérique
- Doit contenir uniquement des caractères alphanumériques, des traits de soulignement ou des traits d'union.
- Ne doit pas contenir de traits de soulignement ou de tirets consécutifs.
Utiliser les paramètres d'une action de données
Pour utiliser le paramètre d'entrée ou de sortie d'une action de données dans vos guides, indiquez le nom exact du paramètre, par exemple Save OrderStatus. Évitez de créer des variables pour les paramètres des actions de données, sauf si vous souhaitez envoyer ces données à Architect ou les recevoir de celui-ci.
Si vous devez créer une variable pour un paramètre d'action de données, ajoutez une étape dans vos guides pour aider le système à faire correspondre la sortie de l'action de données à la variable du guide. Par exemple, Save OrderStatus as CustomerOrderStatus.
Pour plus d'informations sur la rédaction d'instructions et la publication d'un guide, voir Rédiger et publier des guides.
