Connecter les guides à des services externes par des actions sur les données

Conditions préalables 

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

  1. Cliquez sur Admin. 
  2. Sous AI Studio, cliquez sur Guides
  3. Cliquez sur Menu > Orchestration > AI Studio > Guides.
  4. Ouvrir un guide existant ou en créer un nouveau.
  5. 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.
  6. Sélectionnez Data Actions. La boîte de dialogue répertorie maintenant les actions de données disponibles. 
  7. Sélectionnez l'action de données requise. 
  8. 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 et ouvrez 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.
  9. Cliquez sur Sauvegarder. 

Remarques:
  • Veiller à ce que tous les paramètres des contrats d'entrée et de sortie de l'action de données soient correctement décrits.
  • Assurez-vous que les noms des paramètres et les variables auxquelles ils correspondent correspondent correctement.
  • Le nombre maximum d'actions de données que vous pouvez avoir dans un guide est de 20.
  • 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 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.
Note: Si vous ne voyez pas d'action de données dans la liste des actions de données disponibles, essayez d'actualiser la page. La liste des actions de données disponibles est récupérée lors du chargement de la page.

Utiliser les paramètres d'une action de données

Pour utiliser les paramètres d'une action de données, vous pouvez créer des variables pour les entrées et les sorties. Les noms doivent correspondre et les descriptions doivent être significatives. Vous pouvez définir le nom et les descriptions lorsque vous créez l'action de données. Les descriptions des paramètres doivent fournir les informations nécessaires et être similaires aux descriptions des variables qu'elles représentent.

Exemples:

  • Événements: Une liste d'événements contenant l'acte, le type et le lieu de l'événement.
  • Numéro de commande: Un numéro à 7 chiffres qui représente la commande du client

Pour plus d'informations sur la rédaction d'instructions et la publication d'un guide, voir Rédiger et publier des guides.