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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 dans IBM Watson Assistant avec 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 des rubriques.

    Avant de commencer

    Remarque :
    Une interface utilisateur mise à jour Concepteur d'assistants de la bibliothèque d’actifs 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, l’interface utilisateur et la page des rubriques héritées s’affichent. Pour plus d’informations, consultez la page des rubriques héritées du Concepteur d’agent virtuel.

    Avec l’intégration de la IBM Watson Assistant messagerie instantanée v2 API, le widget de messagerie instantanée 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, reportez-vous à la section 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 IBM Watson Assistant boîte de dialogue sous forme de 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 de Watson Assistant, ce 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 à la véritable intention 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 critiques de 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 des 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 pour 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, 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 d’arborescence des compétences Icône d’arborescence des compétences. dans le panneau.
        Liste des assistants avec l’icône IBM Watson Assistant de l’arborescence des compétences mise 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 en IBM Watson Assistant. L’onglet de désambiguïsation, la bascule marche-arrêt, le message de désambiguïsation, le message de tout 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 choix d’intention alternatif pour la désambiguïsation. 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 le bouton NLU/mot clé .Tous > 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 à Tout, 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. 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 l’URL de Watson Assistant et sélectionnez Mettre à jour.

        Formulaire pour la propriété watson_assistant.v2.service_endpoint. avec la valeur d’URL d’exemple 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 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 de l’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 Service Portal (Portail de services ).
      3. Recherchez le Agent virtuel widget et faites-le glisser dans la zone délimitée.
        L’icône de messagerie instantanée violette apparaît dans le coin inférieur droit.

        Portail de services page de conception avec Agent virtuel Portail de services le 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 l’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 de l’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 les 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 vous ouvrez le widget de sysparm_topic 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 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 d’être transférés à un agent actif. Il désactive également le menu contextuel et ne prend pas en charge les 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 la boîte de dialogue Instance ouverte. Le champ Paramètres d’URL du client d’Agent virtuel 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, l’agent virtuel 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.