Configurer l’intégration de la IBM Watson Assistant messagerie instantanée pour l’API Assistant V2

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

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

    Avant de commencer

    Avec l’intégration de messagerie instantanée de l’API IBM Watson Assistant v2, le client de messagerie instantanée Web communique avec un assistant au lieu d’un espace de travail. Les espaces de travail sont appelés compétences de dialogue. Pour plus d’informations sur IBM Watson Assistant, consultez Migration vers l’API v2 dans la IBM Watson Assistant documentation.

    Rôle requis : virtual_agent_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Cette intégration exécute une boîte de IBM Watson Assistant dialogue en Agent virtuel tant que rubrique dans le client de messagerie instantanée Web. 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 services pour Agent virtuel.NLU

    L’API IBM Watson Assistant V2 permet au client de messagerie instantanée Web 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 peut suggérer d’autres intentions possibles, telles que réserver un restaurant ou des avis sur le restaurant.

    Procédure

    1. Configurer IBM Watson Assistant.
      1. Créez votre assistant, puis ajoutez une compétence de dialogue.
        Pour plus d’informations, consultez Création d’un assistant dans la IBM Watson Assistant documentation.
      2. Sur la page de liste des ressources, localisez 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 des ressources dans IBM Watson Assistant, qui affiche la clé API et les valeurs URL de l’assistant.
      3. Sélectionnez l’icône des trois points verticaux 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 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, ainsi que 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 dans le panneau.
        Liste des assistants avec l’icône de l’arborescence des compétences mise en IBM Watson Assistant 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 pour l’utilisateur final.

        Formulaire de désambiguïsation dans IBM Watson Assistant. L’onglet de désambiguïsation, l’activation/désactivation, le message de désambiguïsation, le message autre 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 un autre choix d’intention pour la désambiguïsation. Le résumé de 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 Tout > Interfaces conversationnelles > Agent virtuel > Concepteur.
      2. Dans la page Rubriques , 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 sur votre Agent virtuel client Web.
    6. Accédez à Tous, puis entrez sys_properties.list dans le filtre.
    7. Mettez à jour les propriétés suivantes.

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

        Formulaire Propriété système pour la propriété watson_assistant.v2.assistantID. Exemple : 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 Watson Assistant et sélectionnez Mettre à jour.

        Formulaire pour la propriété watson_assistant.v2.service_endpoint. avec un exemple de valeur URL et le bouton Mettre à jour mis en surbrillance.
        Remarque :
        Vous pouvez spécifier uniquement la partie emplacement de l’URL de l’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 à Tout, puis entrez sys_auth_profile_basic.list dans le filtre.
      2. Ouvrez l’enregistrement IBM Watson Assistant Profil.
      3. Dans le formulaire Configuration de l’authentification de base, entrez la clé API Watson Assistant dans le champ Mot de passe et sélectionnez Mettre à jour.
        Configuration d’authentification de base pour IBM Watson Assistant Profil, avec le champ Mot de passe et le bouton Mettre à jour mis en surbrillance.
    9. Ajoutez le Agent virtuel client (de messagerie instantanée Web) au Portail de servicesfichier .
      1. Accédez à la Portail de services > Configuration du Portail de services.
      2. Sélectionnez Designer, puis la page de destination du 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 page de concepteur avec Agent virtuel Portail de services widget, canevas de conception et icône de messagerie instantanée en surbrillance.

    10. Configurez le Agent virtuel widget en sélectionnant l’icône de modification 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 Virtual Agent , entrez le sysparm_skip_load_history=true paramètre pour que l’historique de la rubrique 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 sysparm_topic paramètres and sysparm_skip_load_history lorsque vous ouvrez le client Web 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 la 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 Portail de services messagerie instantanée ou lors de l’utilisation des intégrations de messagerie instantanée (modules d’extension IBM Watson Assistant 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 de la transférer à un agent actif. Il désactive également le menu contextuel et ne prend pas en charge d’autres clients de chat tiers.

      2. Pour modifier la couleur du bouton flottant, saisissez la nouvelle couleur (format RVB hexadécimal) dans le champ Couleur du bouton flottant .
      3. Sélectionnez Enregistrer.
        Portail de services page de concepteur avec la boîte de dialogue Ouvrir l’instance. Le champ Paramètres de l’URL du client d’Agent virtuel est mis en surbrillance.
    11. Vérifiez que la fonctionnalité de désambiguïsation fonctionne pour votre rubrique.
      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 des intentions supplémentaires découvertes grâce à la fonctionnalité de désambiguïsation.