Chatintegration des IBM Watson Assistant für Assistant V2-API konfigurieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Konfigurieren Sie die Chatintegration für IBM Watson Assistant, um einen Dialog-Skill (Konversation) auszuführen, die in IBM Watson Assistant mit der Assistant V2-API erstellt wurde. Die V2-API ermöglicht es dem Webchat-Client Virtual Agent, ein Thema auszuführen, das die Absichts-Begriffsklärungsfunktion von Watson Assistant verwendet, um die Themenerkennung zu verbessern.

    Vorbereitungen

    Mit der IBM Watson Assistant v2-API-Chatintegration kommuniziert der Webchat-Client mit einem Assistenten anstelle eines Arbeitsbereichs. Arbeitsbereiche werden als Dialogkompetenzen bezeichnet. Weitere Informationen zu IBM Watson Assistantfinden Sie unter Migration zur v2-API in der Dokumentation IBM Watson Assistant.

    Erforderliche Rolle: virtual_agent_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Integration führt einen IBM Watson Assistant -Dialog als Virtual Agent -Thema im Webchat-Client aus. Es ist nicht erforderlich, Natural Language Understanding (NLU) zu aktivieren oder IBM Watson Assistant NLU als NLU Service Provider für Virtual Agentfestzulegen .

    Die IBM Watson Assistant V2-API ermöglicht es dem Webchat-Client, die Absichts-Disambiguierungsfunktion von Watson Assistant zu verwenden, die potenziell falsch positive Absichtsvorhersagen reduzieren kann. Wenn die Äußerung eines Benutzers mehrdeutig ist, schlägt IBM Watson Assistant zusätzliche Absichten vor, die der wahren Absicht des Benutzers möglicherweise besser entsprechen. Wenn die Äußerung des Benutzers beispielsweise „-“ lautet, kann IBM Watson Assistant andere mögliche Absichten vorschlagen, z. B. die Reservierung eines Restaurantsoder die Bewertungvon Restaurants.

    Prozedur

    1. Konfigurieren Sie IBM Watson Assistant.
      1. Erstellen Sie den Assistenten, und fügen Sie einen Dialog-Skill hinzu.
        Weitere Informationen finden Sie unter Assistenten erstellen in der Dokumentation IBM Watson Assistant.
      2. Suchen und notieren Sie auf der Seite „Ressourcenliste“ Ihren API-Schlüssel und Ihre URL, die Sie zum Einrichten der Chat-Integration benötigen:
        Ressourcenlistenseite in IBM Watson Assistant, auf der der API-Schlüssel und die URL-Werte für den Assistenten angezeigt werden.
      3. Klicken Sie auf das Symbol mit den drei vertikalen Punkten , und wählen Sie Einstellungenaus.
        • Wechseln Sie zur Registerkarte API-Details.
        • Suchen Sie auf der Seite „Assistenteneinstellungen“ nach dem Assistenten-ID- Schlüssel.

        IBM Watson Assistant Einstellungen für die zu verwendende Dialogkompetenz. API-Details und Assistenten-ID werden hier hervorgehoben.

    2. Aktivieren Sie die Disambiguierungsfunktion in IBM Watson Assistant (nur für Premium- und Plus-Benutzer).
      Sie können die Disambiguierung für jede Kompetenz aktivieren (oder deaktivieren) und auch eine Disambiguierungsnachricht und die Anzahl der Vorschläge angeben, die dem Endbenutzer angezeigt werden sollen.
      1. Greifen Sie auf Ihre Kompetenz zu, indem Sie im Bereich auf das Kompetenzstruktursymbol klicken.
        Liste der Assistenten in IBM Watson Assistant mit hervorgehobenem Kompetenzstruktursymbol.
      2. Navigieren zu Optionen > Begriffsklärung , um die Begriffsklärung zu aktivieren und die Begriffsklärungsfunktionen festzulegen.
        Das folgende Beispiel zeigt die Disambiguierungsfunktionen, die festgelegt werden können, z. B. die Disambiguierungsnachricht und die Anzahl der vorgeschlagenen Absichten, die dem Endbenutzer angezeigt werden sollen.

        Formular „Begriffsklärung“ in IBM Watson Assistant. Die Registerkarte „Begriffsklärung“, der Ein-/Aus-Umschalter, die Meldung zur Begriffsklärung, alle anderen Meldungen und das Maximum für Vorschläge werden hervorgehoben.

    3. Navigieren Sie zu Dialogfeld, wählen Sie einen Knoten aus, für den die Funktion zur Begriffsklärung gilt, und geben Sie eine Zusammenfassung des Knotens an, die Benutzern angezeigt wird, wenn es sich um einen der Absichtsvorschläge handelt.
      Dialogfeldknoten mit einer Knotenzweckzusammenfassung, die Anwendern als alternative Absicht zur Begriffsklärung angezeigt wird. Die optionale Knotenzusammenfassung ist hervorgehoben.
    4. Aktivieren Sie die folgenden Plugins in der ServiceNow-Instanz:
      • Glide Virtual Agent (com.glide.cs.chatbot), falls nicht bereits aktiviert (Abonnement erforderlich)
      • IBM Watson Assistant Integration V2-Plugin (com.glide.cs.ibm.watson.assistant.topicV2)
    5. Veröffentlichen Sie in Virtual Agent-DesignerIBM Watson Assistant das V2-Thema []:
      1. Navigieren zu Alle > Konversations-Schnittstellen > Virtual Agent > Designer.
      2. Wählen Sie auf der Seite „Themen“ das IBM Watson Assistant V2-Thema aus, um die Seite „Themeneigenschaften“ zu öffnen.
        Beachten Sie, dass das Stichwort für dieses Thema „IBM Watson Assistant V2“ lautet ist.
      3. Wählen Sie auf der Seite „Themeneigenschaften“ die Option Veröffentlichen aus, um das Thema auf Ihrem Virtual Agent Webclient bereitzustellen.
    6. Navigieren Sie zu Alle, und geben Sie dann sys_properties.list in den Filter ein.
    7. Aktualisieren Sie die folgenden Eigenschaften.

      • watson_assistant.v2.assistantID – Geben Sie im Feld Wert die Watson Assistant-ID für Ihren Assistenten ein, und wählen Sie Aktualisierenaus.

        Formular „Systemeigenschaft“ für die Eigenschaft „watson_assistant.v2.assistantID“. Beispiel: Der Wert für die Watson Assistant-ID und die Schaltfläche „Aktualisieren“ sind hervorgehoben.

      • watson_assistant.v2.service_endpoint – Ersetzen Sie im Feld Wert den vorhandenen Wert durch Ihre Watson Assistant-URL, und wählen Sie Aktualisierenaus.

        Formular für die Eigenschaft „watson_assistant.v2.service_endpoint“. mit Beispiel-URL-Wert und hervorgehobener Schaltfläche „Aktualisieren“.
        Hinweis:
        Sie können im Feld Wert nur den Standortteil der Serviceinstanz-URL angeben. Beispiel: Wenn die Basis-URL für den IBM Watson-Serviceendpunkt https://gateway.watsonplatform.net/assistant/api lautet, können Sie im Feld Wert nur den Speicherort der Serviceinstanz „gateway.watsonplatform.net “ eingeben.

        Wenn Ihr Watson-Assistent in einem anderen Rechenzentrum als Washington, D.C. gehostet wird, lautet Ihre Basis-URL https://gateway-wdc.watsonplatform.net/assistant/api. Geben Sie in das Feld Wert „ gateway-wdc.watston.platform.net “ ein.

    8. Legen Sie den Watson Assistant-API-Schlüssel im Profil IBM Watson Assistant als Passwort fest.
      1. Navigieren Sie zu Alle, und geben Sie dann sys_auth_profile_basic.list in den Filter ein.
      2. Öffnen Sie den Profildatensatz IBM Watson Assistant.
      3. Geben Sie im Formular „Basisauthentifizierungskonfiguration“ den Watson Assistant-API-Schlüssel in das Feld Passwort ein, und wählen Sie Aktualisierenaus.
        Konfiguration der Basisauthentifizierung für das Profil IBM Watson Assistant, wobei das Feld „Passwort“ und die Schaltfläche „Aktualisieren“ hervorgehoben sind.
    9. Fügen Sie den Client Virtual Agent (Webchat) zu Serviceportalhinzu .
      1. Navigieren zu Serviceportal > Serviceportal-Konfiguration.
      2. Wählen Sie Designerund dann die Service Portal -Zielseite aus.
      3. Suchen Sie nach dem Widget Virtual Agent, und ziehen Sie das Widget in den umrandeten Bereich.
        Das violette Chat-Symbol wird in der rechten unteren Ecke angezeigt.

        Serviceportal -Designerseite mit hervorgehobenem Widget Virtual Agent Serviceportal, Design-Canvas und Chat-Symbol.

    10. Konfigurieren Sie das Widget Virtual Agent, indem Sie oben rechts auf das Bearbeitungssymbol klicken, um die an den Chat-Client übergebenen URL-Parameter festzulegen und die Farbe der schwebenden Chat-Schaltfläche zu ändern.
      1. Geben Sie im Feld Virtual Agent-Client-URL-Parameter den Parameter sysparm_skip_load_history=true ein, damit der Themenverlauf nicht im Chat-Client angezeigt wird, und den Parameter sysparm_topic mit der sys_id des veröffentlichten IBM Watson Assistant V2-Themas, das ausgeführt werden soll.
        Die sys_id eines Themas finden Sie in der Thementabelle [sys_cs_topic].

        Wenn Sie das Instanzverhalten nicht in Serviceportalkonfigurieren, können Sie Ihre Instanz-URL beim Öffnen des Chat-Webclients mit den Parametern sysparm_topic und sysparm_skip_load_history angeben. Beispiel: https://<Your instance URL> $sn-va-web-client-app.do?sysparm_skip_load_history=wahr&sysparm_topic=<sys_id> wo ist die sys_id des veröffentlichten IBM Watson Assistant V2-Themas, das ausgeführt werden soll.

        Wichtig:

        Verwenden Sie den Parameter sysparm_topic nur, um das angegebene Thema im Chat-Client von Serviceportal zu laden, oder bei Verwendung der Chat-Integrationen von IBM Watson Assistant (com.glide.cs.ibm.watson.assistant.topic und com.glide.cs.ibm.watson.assistant). .topicV2-Plugins). Mit diesem Parameter können Benutzer keine neue Konversation starten oder an einen Live-Agent übertragen. Außerdem wird das Kontextmenü deaktiviert, und es werden keine anderen Chat-Clients von Drittparteien unterstützt.

      2. Um die Farbe der schwebenden Schaltfläche zu ändern, geben Sie die neue Farbe (RGB-Hex-Format) in das Feld Farbe der schwebenden Schaltfläche ein.
      3. Wählen Sie Speichern.
        Serviceportal -Designerseite mit geöffnetem modalen Fenster „Instanz“. Das Feld Virtual Agent-Client-URL-Parameter ist hervorgehoben.
    11. Testen Sie, ob die Funktion zur Begriffsklärung für Ihr Thema funktioniert.
      Stellen Sie sicher, dass die Begriffsklärung für Ihre Kompetenz „Watson Assistant“ und mindestens zwei Dialogknoten aktiviert ist. Im folgenden Beispiel stellt der Virtual Agent vier zusätzliche Absichten bereit, die der Benutzer auswählen kann.
      Abbildung : 1. Beispielthema mit Begriffsklärung
      Virtual Agent -Konversation mit zusätzlichen Absichten, die mithilfe der Begriffsklärungsfunktion erkannt wurden.