Intégration Agent virtuel à IBM Watson Assistant pour l’API Assistant V2

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Configurez l’intégration de messagerie instantanée IBM Watson Assistant pour exécuter une compétence de dialogue (conversation) créée avec IBM Watson Assistant l’API Assistant V2. L’API V2 permet au widget de messagerie instantanée d’exécuter une rubrique qui utilise la fonctionnalité de désambiguïsation d’intention de Watson Assistant pour améliorer la Agent virtuel découverte de rubriques.

    Avant de commencer

    Remarque :
    Une interface utilisateur mise à jour Concepteur d'agent virtuel est disponible lorsque vous installez Now AssistAgent virtuel et activez la Now Assist compétence Rubriques. Ce contenu suppose que vous avez activé cette compétence et que vous pouvez afficher la vue de liste. Si cette compétence n’est pas activée, vous verrez l’interface utilisateur et la page des rubriques héritées. Pour plus d’informations, consultez la page des rubriques héritées du Concepteur d’agent virtuel.

    Avec l’intégration de la messagerie instantanée de l’API IBM Watson Assistant v2, le widget de messagerie instantanée communique avec un assistant et non avec un espace de travail. Les espaces de travail sont appelés compétences de dialogue. Pour plus d’informations sur , reportez-vous à la section Migration vers l’API v2 dans la IBM Watson Assistant documentation.IBM Watson Assistant

    Rôle requis : virtual_agent_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Cette intégration exécute une IBM Watson Assistant boîte de dialogue en tant que Agent virtuel rubrique dans le widget de messagerie instantanée. Il n’est pas nécessaire d’activer Compréhension du langage naturel (NLU) ou de définir IBM Watson Assistant NLU en tant que fournisseur de NLU service pour Agent virtuel.

    L’API IBM Watson Assistant V2 permet au widget de messagerie instantanée d’utiliser la fonctionnalité de désambiguïsation d’intention Watson Assistant, qui peut potentiellement réduire les prédictions d’intention faussement positives. Si l’énoncé d’un utilisateur est ambigu, IBM Watson Assistant suggère des intentions supplémentaires qui pourraient mieux correspondre à l’intention réelle de l’utilisateur. Par exemple, si l’énoncé de l’utilisateur est restaurant, IBM Watson Assistant il peut suggérer d’autres intentions possibles, telles que réserver un restaurant ou des avis sur un restaurant.

    Procédure

    1. Configurer IBM Watson Assistant.
      1. Créez votre assistant, puis ajoutez une compétence de dialogue.
        Pour plus d’informations, voir Création d’un assistant dans la IBM Watson Assistant documentation.
      2. Sur la page de liste Ressources, recherchez et enregistrez votre clé API et votre URL, dont vous avez besoin pour configurer l’intégration de la messagerie instantanée :
        Page de liste de ressources dans IBM Watson Assistant, qui affiche la clé API et les valeurs d’URL de l’assistant.
      3. Sélectionnez l’icône des trois points verticaux Icône Plus d’actions. et sélectionnez Paramètres.
        • Sélectionnez l’onglet Détails de l’API .
        • Sur la page Paramètres de l’assistant, recherchez la clé ID de l’assistant .

        IBM Watson Assistant Paramètres de la compétence de boîte de dialogue à utiliser. Les détails de l’API et l’ID de l’assistant sont mis en évidence ici.

    2. Activez la fonctionnalité de désambiguïsation dans IBM Watson Assistant (pour les utilisateurs premium et plus uniquement).
      Vous pouvez activer (ou désactiver) la désambiguïsation pour chaque compétence, mais également spécifier un message de désambiguïsation et le nombre de suggestions à afficher à l’utilisateur final.
      1. Accédez à votre compétence en sélectionnant l’icône de l’arborescence des compétences Icône de l’arborescence des compétences. dans le panneau.
        Les assistants listent avec l’icône de l’arborescence IBM Watson Assistant des compétences en surbrillance.
      2. Accédez à la Options > Désambiguïsation pour activer la désambiguïsation et définir les fonctionnalités de désambiguïsation.
        L’exemple suivant montre les fonctionnalités de désambiguïsation qui peuvent être définies, telles que le message de désambiguïsation et le nombre d’intentions suggérées à afficher à l’utilisateur final.

        Forme de désambiguïsation dans IBM Watson Assistant. L’onglet de désambiguïsation, la bascule marche-arrêt, le message de désambiguïsation, le message de toute autre chose et le maximum de suggestion sont mis en surbrillance.

    3. Accédez à la boîte de dialogue, sélectionnez un nœud auquel la fonctionnalité de désambiguïsation s’appliquera et fournissez un résumé du nœud qui sera affiché aux utilisateurs s’il s’agit de l’une des suggestions d’intention.
      Nœud de boîte de dialogue avec un résumé de l’objectif du nœud affiché aux utilisateurs comme choix d’intention alternatif pour la levée de l’ambiguïté. Le résumé du nœud facultatif est mis en surbrillance.
    4. Dans votre ServiceNow instance, activez ces modules d’extension :
      • Agent virtuel Glide (com.glide.cs.chatbot), s’il n’est pas déjà activé (nécessite un abonnement)
      • Module d’extension IBM Watson Assistant Integration V2 (com.glide.cs.ibm.watson.assistant.topicV2)
    5. Dans Concepteur d'agent virtuel, publiez la IBM Watson Assistant rubrique V2 :
      1. Accédez à la Interfaces conversationnelles > Agent virtuel > Concepteur et sélectionnez l’option NLU/mot clé .Tout > Interfaces conversationnelles > Agent virtuel > Concepteur.
      2. Dans la page d’accueil Concepteur d'agent virtuel , sélectionnez la IBM Watson Assistant rubrique V2 pour ouvrir la page Propriétés de la rubrique.
        Notez que le mot clé de cette rubrique est IBM Watson Assistant V2.
      3. Dans la page Propriétés de la rubrique, sélectionnez Publier pour déployer la rubrique dans votre Agent virtuel widget de messagerie instantanée.
    6. Accédez à Tous, puis saisissez sys_properties.list dans le filtre.
    7. Mettez à jour les propriétés suivantes.

      • watson_assistant.v2.assistantID — Dans le champ Valeur , entrez l’ID Watson Assistant de votre assistant et sélectionnez Mettre à jour.

        Formulaire de propriété système pour la propriété watson_assistant.v2.assistantID. Les exemples : la valeur de l’ID Watson Assistant et le bouton Mettre à jour sont mis en surbrillance.

      • watson_assistant.v2.service_endpoint — Dans le champ Valeur , remplacez la valeur existante par l’URL de votre assistant Watson et sélectionnez Mettre à jour.

        Formulaire pour la propriété watson_assistant.v2.service_endpoint. avec l’exemple de valeur URL et le bouton Mettre à jour mis en surbrillance.
        Remarque :
        Vous pouvez spécifier uniquement la partie emplacement de l’URL d’instance de service dans le champ Valeur . Par exemple, si l’URL de base du point de terminaison de service IBM Watson est https://gateway.watsonplatform.net/assistant/api, vous pouvez entrer uniquement l’emplacement de l’instance de service, gateway.watsonplatform.net dans le champ Valeur .

        Si votre Watson Assistant est hébergé dans un centre de données autre que Dallas, tel que Washington DC, votre URL de base est https://gateway-wdc.watsonplatform.net/assistant/api. Vous devez saisir gateway-wdc.watston.platform.net dans le champ Valeur .

    8. Définissez la clé API Watson Assistant comme mot de passe dans le IBM Watson Assistant profil.
      1. Accédez à Tous, puis saisissez sys_auth_profile_basic.list dans le filtre.
      2. Ouvrez l’enregistrement IBM Watson Assistant du profil.
      3. Dans le formulaire Configuration de l’authentification de base, entrez la clé API de Watson Assistant dans le champ Mot de passe et sélectionnez Mettre à jour.
        Configuration d’authentification de base pour le IBM Watson Assistant Profil, avec le champ Mot de passe et le bouton Mettre à jour mis en surbrillance.
    9. Ajoutez le client (de messagerie instantanée Agent virtuel en ligne) au Portail de services.
      1. Accédez à la Portail de services > Configuration du Portail de services.
      2. Sélectionnez Designer, puis la page de destination de Portail de services .
      3. Recherchez le Agent virtuel widget et faites-le glisser dans la zone délimitée.
        L’icône de chat violette apparaît dans le coin inférieur droit.

        Portail de services avec le Agent virtuel Portail de services widget, le canevas de conception et l’icône de messagerie instantanée mis en surbrillance.

    10. Configurez le Agent virtuel widget en sélectionnant l’icône Modifier Icône Modifier. dans le coin supérieur droit pour définir les paramètres d’URL transmis au client de messagerie instantanée et changer la couleur du bouton de messagerie instantanée flottant.
      1. Dans le champ Paramètres de l’URL du client Agent virtuel , entrez le sysparm_skip_load_history=true paramètre afin que l’historique des rubriques ne s’affiche pas dans le client de messagerie instantanée et le sysparm_topic paramètre avec le sys_id de la rubrique IBM Watson Assistant V2 publiée à exécuter.
        Vous pouvez trouver l’sys_id d’une rubrique dans la table Rubriques [sys_cs_topic].

        Si vous ne configurez pas le comportement de l’instance dans Portail de services, vous pouvez spécifier l’URL de votre instance avec les paramètres et sysparm_skip_load_history lorsque sysparm_topic vous ouvrez le widget de messagerie instantanée. Par exemple : https://< URL de votre instance >$sn-va-web-client-app.do ?sysparm_skip_load_history=true&sysparm_topic=<sys_id> où <sys_id> est le sys_id de la rubrique V2 publiée IBM Watson Assistant à exécuter.

        Important :

        Utilisez le paramètre sysparm_topic uniquement pour charger la rubrique donnée dans le client de messagerie Portail de services instantanée ou lors de l’utilisation IBM Watson Assistant des intégrations de messagerie instantanée (modules d’extension com.glide.cs.ibm.watson.assistant.topic et com.glide.cs.ibm.watson.assistant.topicV2). Ce paramètre ne permet pas aux utilisateurs de démarrer une nouvelle conversation ou d’être transférés à un agent actif. Il désactive également le menu contextuel et ne prend pas en charge d’autres clients de messagerie instantanée tiers.

      2. Pour modifier la couleur du bouton flottant, entrez la nouvelle couleur (format RVB hex) dans le champ Couleur du bouton flottant .
      3. Sélectionnez Enregistrer.
        Portail de services Page Designer avec la boîte de dialogue Instance ouverte. Le champ Paramètres de l’URL du client Agent virtuel est mis en surbrillance.
    11. Testez que la fonction de désambiguïsation fonctionne pour votre sujet.
      Assurez-vous que la désambiguïsation est activée pour votre compétence Watson Assistant et au moins deux nœuds de dialogue. Dans l’exemple suivant, Virtual Agent fournit quatre intentions supplémentaires que l’utilisateur peut sélectionner.
      Figure 1. Exemple de rubrique avec désambiguïsation
      Agent virtuel Conversation montrant les intentions supplémentaires découvertes via la fonctionnalité de désambiguïsation.