Integration Virtual Agent Mit IBM Watson Assistant Für Assistant V2 API

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 aktiviert Virtual Agent Chat-Widget zum Ausführen eines Themas, das die Absichtsunterscheidungsfunktion von Watson Assistant verwendet, um die Themen-Discovery zu verbessern.

    Vorbereitungen

    Hinweis:
    Ein aktualisiert Virtual Agent-Designer Die Anwenderoberfläche ist verfügbar, wenn Sie installieren Now Assist In Virtual Agent Und aktivieren Sie Now Assist Themenkompetenz. Dieser Inhalt setzt voraus, dass Sie diese Kompetenz aktiviert haben und die Listenansicht anzeigen können. Wenn diese Kompetenz nicht aktiviert ist, werden die veraltete UI- und Themenseite angezeigt. Weitere Informationen finden Sie unter Virtual Agent-Designer – Seite mit veralteten Themen .

    Mit IBM Watson Assistant v2-API-Chat-Integration kommuniziert das Chat-Widget mit einem Assistenten anstatt mit einem Arbeitsbereich. Arbeitsbereiche werden als Dialogkompetenzen bezeichnet. Für Informationen zu IBM Watson Assistant, Siehe Migration zur v2-API In IBM Watson Assistant Dokumentation.

    Erforderliche Rolle: virtual_agent_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Integration führt eine aus IBM Watson Assistant Dialog als Virtual Agent Thema im Chat-Widget. Dies erfordert keine Aktivierung Natural Language Understanding( NLU) Oder Einstellung IBM Watson Assistant NLU Als NLU Service Provider für Virtual Agent.

    Die IBM Watson Assistant Die V2-API ermöglicht dem Chat-Widget die Verwendung der Watson Assistant-Absichtsdeklarationsfunktion, die potenziell falsch-positive Absichtsvorhersagen reduzieren kann. Wenn die Äußerung eines Anwenders mehrdeutig ist, IBM Watson Assistant Schlägt zusätzliche Absichten vor, die der wahren Absicht des Anwenders besser entsprechen könnten. Beispiel: Wenn die Anwenderäußerung lautet Restaurant , IBM Watson Assistant Kann andere mögliche Absichten vorschlagen, z. B. Buchen Sie ein Restaurant Oder Restaurantbewertungen .

    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 Erstellen eines Assistenten In IBM Watson Assistant Dokumentation.
      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, Der den API-Schlüssel und die URL-Werte für den Assistenten anzeigt.
      3. Wählen Sie das Symbol mit drei vertikalen Punkten Symbol „weitere Aktionen“.Und wählen Sie aus Einstellungen .
        • Wählen Sie aus API-Details Registerkarte.
        • Suchen Sie auf der Seite „Assistenteneinstellungen“ nach 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 Disambiguationsfunktion in IBM Watson Assistant(Nur für Premium- und Plus-Anwender).
      Sie können die Abgrenzung für jede Kompetenz aktivieren (oder deaktivieren) und auch eine Abgrenzungsnachricht und die Anzahl der Vorschläge angeben, die dem Endanwender angezeigt werden sollen.
      1. Greifen Sie auf Ihre Kompetenz zu, indem Sie das Kompetenzstruktursymbol wählen Symbol für Kompetenzstruktur.Im Bereich.
        Liste der Assistenten in IBM Watson Assistant Mit hervorgehobenem Kompetenzstruktursymbol.
      2. Navigieren zu Optionen > Beschreibung Zum Aktivieren der Entdeutlichung und Festlegen der Entdeutungsfunktionen.
        Das folgende Beispiel zeigt die Definitionsfunktionen, die festgelegt werden können, z. B. die Definitionsnachricht und die Anzahl der vorgeschlagenen Absichten, die dem Endanwender angezeigt werden sollen.

        Bezeichnungsformular in IBM Watson Assistant. Die Registerkarte „Abgrenzung“, der ein-/Ausschalter, die Entzweigungsnachricht, die Nachricht „alles andere“ und das Maximum des Vorschlags werden hervorgehoben.

    3. Navigieren Sie zu Dialogfeld Wählen Sie einen Knoten aus, für den die Disambiguerungsfunktion gilt, und geben Sie eine Zusammenfassung des Knotens an, der Anwendern angezeigt wird, wenn es sich um einen der Absichtsvorschläge handelt.
      Dialogknoten mit einer Knotenzweckzusammenfassung, die Anwendern als alternative Absichtsauswahl zur Erläuterung angezeigt wird. Optionale Knotenzusammenfassung wird 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. In Virtual Agent-Designer, Veröffentlichen Sie IBM Watson Assistant V2-Thema:
      1. Navigieren zu Konversations-Schnittstellen > Virtual Agent > Designer Und wählen Sie aus NLU/Stichwort Umschalter.Alle > Konversations-Schnittstellen > Virtual Agent > Designeran.
      2. In Virtual Agent-Designer Homepage wählen Sie aus IBM Watson Assistant V2-Thema zum Öffnen der Seite „Themeneigenschaften“.
        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 aus Veröffentlichen Um das Thema für bereitzustellen Virtual Agent Chat-Widget.
    6. Navigieren Sie zu Alle , Und geben Sie dann ein sys_properties.list Im Filter.
    7. Aktualisieren Sie die folgenden Eigenschaften.

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

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

      • watson_assistant.v2.service_endpoint– Im Wert Ersetzen Sie den vorhandenen Wert durch Ihre Watson Assistant-URL, und wählen Sie aus Aktualisieren .

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

        Wenn Ihr Watson Assistant in einem anderen Rechenzentrum als Dallas gehostet wird, z. B. Washington DC, lautet Ihre Basis-URL https://gateway-wdc.watsonplatform.net/assistant/api. Sie würden eingeben gateway-wdc.watston.platform.net In Wert Feld.

    8. Legen Sie den Watson Assistant-API-Schlüssel als Passwort in fest IBM Watson Assistant Profil.
      1. Navigieren Sie zu Alle , Und geben Sie dann ein sys_auth_Profile_Basic.list Im Filter.
      2. Öffnen Sie IBM Watson Assistant Profildatensatz.
      3. Geben Sie im Formular „Konfiguration der Standardauthentifizierung“ den Watson Assistant-API-Schlüssel in ein Passwort Feld und wählen Sie aus Aktualisieren .
        Konfiguration der Standardauthentifizierung für IBM Watson Assistant Profil mit hervorgehobenem Passwortfeld und Schaltfläche „Aktualisieren“.
    9. Fügen Sie hinzu Virtual Agent(Webchat)-Client zum Serviceportal.
      1. Navigieren zu Serviceportal > Serviceportal-Konfigurationan.
      2. Wählen Sie Aus Designer , Und wählen Sie dann aus Serviceportal Zielseite.
      3. Suchen Sie nach Virtual Agent Widget, und ziehen Sie das Widget in den umrissenen Bereich.
        Das lila Chat-Symbol wird unten rechts angezeigt.

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

    10. Konfigurieren Sie Virtual Agent Widget, indem Sie das Bearbeitungssymbol auswählen Symbol „Bearbeiten“.In der oberen rechten Ecke, um die URL-Parameter festzulegen, die an den Chat-Client übergeben werden, und die Farbe der fließenden Chat-Schaltfläche zu ändern.
      1. In Virtual Agent-Client-URL-Parameter Geben Sie ein sysparm_skip_load_history=trueParameter, damit der Themenverlauf nicht im Chat-Client und in angezeigt wird sysparm_topicParameter 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 in nicht konfigurieren Serviceportal, Sie können Ihre Instanz-URL mit angeben sysparm_topicUnd sysparm_skip_load_historyParameter, wenn Sie das Chat-Widget öffnen. Beispiel: https://<Your Instanz-URL>$sn-va-Web-Client-App.do?sysparm_Skip_load_history=true&sysparm_topic= <sys_id> Wo <sys_id> Ist die sys_ID des veröffentlichten IBM Watson Assistant Auszuführendes V2-Thema.

        Wichtig:

        Verwenden Sie Sysparm_topic Parameter nur zum Laden des angegebenen Themas in Serviceportal Chat-Client oder bei Verwendung von IBM Watson AssistantChat-Integrationen (Plugins com.Glide.cs.ibm.watson.Assistant.topic und com.Glide.cs.ibm.watson.Assistant.topicV2). Mit diesem Parameter können Benutzer keine neue Konversation starten oder an einen Live-Agent übertragen. Außerdem wird das Kontextmenü deaktiviert und andere Chat-Clients von Drittparteien werden nicht unterstützt.

      2. Um die Farbe der fließenden Schaltfläche zu ändern, geben Sie die neue Farbe (RGB-Hex-Format) in ein Schwebende Schaltflächenfarbe Feld.
      3. Wählen Sie Speichern.
        Serviceportal Designer-Seite mit Dialogfeld „Instanz öffnen“. Das Feld „Parameter für Virtual Agent-Client-URL“ ist hervorgehoben.
    11. Testen Sie, ob die Disambiguationsfunktion für Ihr Thema funktioniert.
      Stellen Sie sicher, dass die Begrifflichkeit 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 Anwender auswählen kann.
      Abbildung : 1. Beispielthema mit Klarstellung
      Virtual Agent Konversation mit zusätzlichen Absichten, die über die Disambiguerungsfunktion erkannt wurden.