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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • Configurez l’intégration de messagerie IBM Watson Assistant instantanée pour exécuter une compétence de dialogue (conversation) créée dans IBM Watson Assistant avec l’API Assistant V2. L’API V2 permet au Agent virtuel client de 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 plutôt qu’avec un espace de travail. Les espaces de travail sont appelés compétences de dialogue. Pour plus d’informations sur IBM Watson Assistant, consultez Migrer 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 tant que Agent virtuel 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 NLU services pour Agent virtuel.

    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 des restaurants.

    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 les valeurs de clé API et d’URL pour 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 pour 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 > Homonymie 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 en IBM Watson Assistant. L’onglet de désambiguïsation, l’activation/désactivation, le message de désambiguïsation, le message Anything else et le maximum de suggestions 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 s’affichera aux utilisateurs s’il s’agit de l’une des suggestions d’intention.
      Nœud 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 les modules d’extension suivants :
      • Glide Virtual Agent (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é pour 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’identifiant Watson Assistant de votre assistant et sélectionnez Mettre à jour.

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

        Formulaire pour la propriété watson_assistant.v2.service_endpoint. avec un exemple de valeur d’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 saisir 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. Saisissez 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 entrez sys_auth_profile_basic.list dans le filtre.
      2. Ouvrez l’enregistrement IBM Watson Assistant de profil.
      3. Dans le formulaire Configuration de l’authentification de base, saisissez la clé API Watson Assistant dans le champ Mot de passe et sélectionnez Mettre à jour.
        Configuration de l’authentification de base pour IBM Watson Assistant Profil, avec le champ Mot de passe et le bouton Mettre à jour mis en évidence.
    9. Ajoutez le Agent virtuel client (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 de Service Portal .
      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 designer avec widget Agent virtuel Portail de services , canevas de conception et icône de messagerie instantanée mis 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 , saisissez le sysparm_skip_load_history=true paramètre de sorte 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 la 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 l’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 n’autorise pas les utilisateurs à démarrer une nouvelle conversation ou à passer à 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 changer la couleur du bouton flottant, entrez la nouvelle couleur (format hexadécimal RVB) dans le champ Couleur du bouton flottant .
      3. Sélectionnez Enregistrer.
        Portail de services page designer avec ouvrir le modal d’instance. Le champ Paramètres de l’URL du client Virtual Agent est mis en surbrillance.
    11. Testez 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 affichant les intentions supplémentaires découvertes grâce à la fonctionnalité de désambiguïsation.