Ajout de fonctionnalités personnalisées dans les workflows de conversation dans Agent IA avancé en utilisant de fausses intégrations

Mon édition

Module supplémentaire

Agents IA - avancé

Une fausse intégration permet d’ajouter des fonctionnalités personnalisées aux dialogues en utilisant les données déjà présentes dans les conversations, sans faire d’appels d’API ni récupérer de données externes. Cela vous permet d’implémenter une logique en utilisant JSONata pour les manipulations de données, les comparaisons ou autres tâches au sein du flux de dialogue.

Ce type d’intégration est utile pour gérer les tâches qui ne nécessitent pas de données externes en temps réel, car il sert d'« assistant » d’intégration pour élargir les capacités d’un agent IA au-delà des fonctionnalités standard.

Cet article aborde les sujets suivants :

• À propos des fausses intégrations
• Création d’une fausse intégration
• Ajout d’une fausse intégration dans une boîte de dialogue

À propos des fausses intégrations

Une fausse intégration est utile pour traiter ou manipuler des données déjà disponibles dans la conversation. Par exemple, vous pouvez effectuer les tâches suivantes en utilisant une fausse intégration :

• Transformez vos données dans un format plus approprié.
• Formatez et filtrez les données CRM ou API complexes.
• Comparez les dates pour trouver la plus récente.
• Récupérez le jour et l'heure actuels.
• Vérifiez qu’une date tombe dans une période donnée.
• Vérifiez si une URL contient des mots spécifiques.
• Recherchez et remplacez toute valeur nulle.
• Remplacez des lettres ou des symboles dans vos données.
• Utilisez un filtre insensible à la casse pour parcourir les données et renvoyer la première valeur correspondante ou fournir une réponse de remplacement en l’absence de correspondance.

Si vous pouvez définir la logique en utilisant JSONata, vous pourrez améliorer vos conversations grâce à ces intégrations très utiles.

Création d’une fausse intégration

Conseil : Avant de créer une intégration fictive, nous vous conseillons de vous familiariser avec l’utilisation de JSONata avec le créateur d'intégration. Consultez Activation JSONata.

Pour créer une fausse intégration, vous devez créer une intégration API comme à l’accoutumée. Cependant, il n’y a jamais de demande de données.

Pour créer une fausse intégration

1. Dans le menu principal, cliquez sur Intégrations d'API.
2. En haut à droite, cliquez sur Ajouter une intégration.
3. Dans la fenêtre Ajouter une intégration :
   
   1. Dans le champ Nom de l’intégration, donnez un nom descriptif à votre intégration.
   2. (Facultatif) Dans le champ Description, saisissez une description de l’intégration qui vous aidera à vous souvenir de sa fonction.
   3. Cliquez sur Enregistrer.
4. Dans la barre latérale gauche, sous Environnements, sélectionnez un environnement (par exemple Production).
5. Définissez le type de méthode sur GET.
6. Dans le champ URL, saisissez une URL fictive (par exemple, https://dummyjson.com/http/200).
   

   • Remarque : comme les fausses intégrations sont hébergées dans le cadre de l’intégration, elles doivent pointer vers une URL valide. L’exemple ci-dessus utilise https://dummyjson.com/http/200, mais sa disponibilité ne peut pas être garantie. Vous pouvez utiliser n’importe quelle URL fictive qui vous convient. Un appel API est effectué vers l’URL spécifiée, mais aucune donnée de la réponse n’est traitée dans la fausse intégration.

7. Vérifiez que Type d’autorisation est configuré sur Pas d’autorisation.
8. (Facultatif) Dans la barre latérale gauche, sous Scénarios, placez votre curseur sur Échec, puis sélectionnez le menu des options () et sélectionnez Supprimer. Vous n’avez pas besoin d’un scénario d’échec pour une intégration factice.
9. Dans la barre latérale gauche, sous Scénarios, sélectionnez Réussite.
10. Selon votre scénario, effectuez l’une des actions suivantes :
    
    • Si vous avez une requête simple, saisissez-la dans le champ Requête scénario. Par exemple, si vous n’avez besoin que d’une réponse booléenne, vous n’avez besoin que de la requête ici.
    • Si vous devez définir une logique basée sur les paramètres de la demande (provenant de la conversation) :
      
      1. Saisissez requestParameters dans le champ de requête Scénario .
      2. Sous Paramètres de session, saisissez les paramètres pour votre fausse intégration. La capture d’écran ci-dessous inclut des exemples de paramètres et d’expressions de données JSONata pour renvoyer le jour de la semaine et l’heure actuelle.
         
11. Cliquez sur Enregistrer.

Ajout d’une fausse intégration dans une boîte de dialogue

Dans le créateur de dialogue, vous pouvez ajouter un nœud d’intégration API et sélectionner votre fausse intégration.

Pour ajouter une fausse intégration dans une boîte de dialogue

1. En haut à droite, utilisez le champ déroulant agent IA pour sélectionner l’agent IA pour lequel vous voulez mettre le dialogue à jour.
2. Dans le menu principal sur la gauche, sélectionnez Contenu > Intentions.
3. Sélectionnez l’intention pour laquelle vous voulez mettre le dialogue à jour.
4. Cliquez sur l’onglet Réponses.
5. Sélectionnez la réponse pour laquelle vous voulez mettre la boîte de dialogue à jour, puis cliquez sur Modifier le dialogue.
6. Cliquez sur l’icône (+) au niveau de votre choix dans la boîte de dialogue et ajoutez un bloc d'intégration d’API.
   
7. Sélectionnez la fausse intégration que vous avez créée ci-dessus.
   

Maintenant, quand la branche de fausse intégration est atteinte dans la conversation, votre fausse intégration API est appelée et les paramètres de session que vous avez définis dans votre scénario de réussite sont disponibles dans la conversation. L’exemple ci-dessous montre une fausse intégration qui se transforme en bloc conditionnel en utilisant des paramètres basés sur le jour de la semaine renvoyés par la fausse intégration.