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

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 Funktion zur Begriffsklärung für Absichten von Watson Assistant verwendet, um die Themen-Discovery zu verbessern.

    Vorbereitungen

    Mit der IBM Watson Assistant v2-API-Chatintegration kommuniziert der Webchat-Client mit einem Assistenten anstatt mit einem Arbeitsbereich. Arbeitsbereiche werden als Dialogkompetenzen bezeichnet. Informationen zu IBM Watson Assistantfinden Sie unter Zur v2-API migrieren 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 ein Dialogfeld Virtual AgentIBM Watson Assistant als Thema [] im Webchat-Client aus. Es ist nicht erforderlich, Natural Language Understanding (NLU) zu aktivieren oder NLUIBM Watson Assistant NLU als Service Provider für Virtual Agentfür [] festzulegen.

    Die IBM Watson Assistant V2-API ermöglicht es dem Webchat-Client, die Watson Assistant-Funktion zur Mehrdeutigkeit von Absichten zu verwenden, die falsch positive Absichtsvorhersagen potenziell 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 Benutzeräußerung beispielsweise „ Restaurant“ lautet, kann IBM Watson Assistant andere mögliche Absichten vorschlagen, z. B. ein Restaurant buchen oder Restaurantbewertungen.

    Prozedur

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

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

    2. Aktivieren Sie die Funktion zur Begriffsklärung in IBM Watson Assistant (nur für Premium- und Plus-Anwender).
      Sie können die Begriffsklärung für jede Kompetenz aktivieren (oder deaktivieren) und außerdem eine Begriffsklärung und die Anzahl der Vorschläge festlegen, die dem Endanwender angezeigt werden sollen.
      1. Greifen Sie auf Ihre Kompetenz zu, indem Sie im Bereich das Kompetenzstruktursymbol auswählen.
        Liste der Assistenten in IBM Watson Assistant mit hervorgehobenem Kompetenzstruktursymbol.
      2. Navigieren zu Optionen > Begriffsklärung um die Begriffsklärung zu aktivieren und die Funktionen zur Begriffsklärung festzulegen.
        Das folgende Beispiel zeigt die Funktionen zur Begriffsklärung, die festgelegt werden können, z. B. die Meldung zur Begriffsklärung und die Anzahl der vorgeschlagenen Absichten, die dem Endanwender angezeigt werden sollen.

        Formular zur Begriffsklärung in IBM Watson Assistant. Die Registerkarte „Begriffsklärung“, der Ein-/Ausschalter, die Meldung zur Begriffsklärung, die Nachricht „Alles andere“ und der Maximalwert für Vorschläge sind 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 Anwendern angezeigt wird, wenn es sich um einen der Absichtsvorschläge handelt.
      Dialogknoten mit einer Zusammenfassung des Knotenzwecks, die Anwendern als alternative Absichtsauswahl zur Mehrdeutigkeit 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-Designer] das Thema IBM Watson Assistant V2:
      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 dem Webclient Virtual Agent bereitzustellen.
    6. Navigieren Sie zu Alle, und geben Sie im Filter sys_properties.list 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. Beispielwert 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 Standort der Serviceinstanz, „gateway.watsonplatform.net “, eingeben.

        Wenn Ihr Watson Assistant in einem anderen Rechenzentrum als Madrid gehostet wird, z. B. Washington DC, lautet Ihre Basis-URL https://gateway-wdc.watsonplatform.net/assistant/api. Geben Sie im Feld „Wert“ den Wert „ gateway-wdc.watston.platform.net “ ein.

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

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

    10. Konfigurieren Sie das Widget Virtual Agent, indem Sie das Bearbeitungssymbol in der oberen rechten Ecke wählen, um die an den Chat-Client übergebenen URL-Parameter festzulegen und die Farbe der unverankerten 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 geben Sie den Parameter sysparm_topic mit der sys_id des veröffentlichten IBM Watson Assistant V2-Themas ein.
        Die sys_id eines Themas finden Sie in der Thementabelle [sys_cs_topic].

        Wenn Sie das Instanzverhalten in Serviceportalnicht konfigurieren, können Sie Ihre Instanz-URL mit den Parametern sysparm_topic und sysparm_skip_load_history angeben, wenn Sie den Chat-Webclient öffnen. Beispiel: https://<Your instance URL> $sn-va-web-client-app.do?sysparm_skip_load_history=wahr&sysparm_topic=<sys_id> wobei 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 Serviceportal zu laden oder wenn Sie die Chat-Integrationen IBM Watson Assistant (com.glide.cs.ibm.watson.assistant.topic und com.glide.cs.ibm.watson.assistant) verwenden .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 andere Chatclients von Drittparteien werden nicht unterstützt.

      2. Um die Farbe der unverankerten Schaltfläche zu ändern, geben Sie die neue Farbe (RGB-Hex-Format) in das Feld Farbe der unverankerten Schaltfläche ein.
      3. Wählen Sie Speichern.
        Serviceportal Designer-Seite mit geöffnetem Dialogfeld „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 Watson Assistant-Kompetenz und mindestens zwei Dialogknoten aktiviert ist. Im folgenden Beispiel stellt Virtual Agent vier zusätzliche Absichten bereit, die der Benutzer auswählen kann.
      Abbildung : 1. Beispielthema mit Begriffsklärung
      Virtual Agent Konversation, in der zusätzliche Absichten angezeigt werden, die durch die Begriffsklärungsfunktion erkannt wurden.