Integration Virtual AgentMit IBM Watson AssistantFür Assistenten V2-API

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Konfigurieren Sie IBM Watson AssistantChat-Integration zum Ausführen einer Dialogkompetenz (Konversation), die in erstellt wurde IBM Watson AssistantMit der Assistenten-V2-API. Die V2-API aktiviert Virtual AgentChat-Widget zum Ausführen eines Themas, das die Absichtsunterscheidungsfunktion von Watson Assistant verwendet, um die Themen-Discovery zu verbessern.

    Vorbereitungen

    Hinweis:
    Aktualisiert Virtual Agent-DesignerDie Anwenderoberfläche ist bei der Installation verfügbar Now AssistIn Virtual AgentUnd aktivieren Sie Now AssistThemenkompetenz. 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 Assistantv2-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 AssistantDokumentation.

    Erforderliche Rolle: virtual_agent_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

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

    Die IBM Watson AssistantMit der V2-API kann das Chat-Widget die Funktion zur eindeutigen Absichten des Watson-Assistenten verwenden, was potenziell falsch-positive Absichtsvorhersagen reduzieren kann. Wenn die Äußerung eines Anwenders mehrdeutig ist, IBM Watson AssistantSchlägt zusätzliche Absichten vor, die besser der wahren Absicht des Anwenders entsprechen könnten. Beispiel: Wenn die Anwenderäußerung lautet Restaurant , IBM Watson AssistantKann andere mögliche Absichten vorschlagen, z. B. Buchen Sie ein Restaurant Oder Restaurantüberprüfungen .

    Prozedur

    1. Konfigurieren IBM Watson Assistant.
      1. Erstellen Sie Ihren Assistenten, und fügen Sie dann eine Dialogkompetenz hinzu.
        Weitere Informationen finden Sie unter Assistent wird erstellt In IBM Watson AssistantDokumentation.
      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 für drei vertikale Punkte aus 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 Mehrdeutigkeitsfunktion in IBM Watson Assistant(Nur für Premium- und Plus-Anwender).
      Sie können die Unmehrdeutigkeit für jede Kompetenz aktivieren (oder deaktivieren) und auch eine Unmehrdeutigkeitsnachricht und die Anzahl der Vorschläge angeben, die dem Endanwender angezeigt werden sollen.
      1. Greifen Sie auf Ihre Kompetenz zu, indem Sie das Kompetenzstruktursymbol auswählen Symbol für Kompetenzstruktur.Im Bereich.
        Liste der Assistenten in IBM Watson AssistantMit hervorgehobenem Kompetenzstruktursymbol.
      2. Navigieren zu Optionen > Mehrdeutigkeit Zum Aktivieren der Mehrdeutigkeit und Festlegen der Mehrdeutigkeitsfunktionen.
        Das folgende Beispiel zeigt die Definitionsfunktionen, die festgelegt werden können, z. B. die Klarstellungsnachricht und die Anzahl der vorgeschlagenen Absichten, die dem Endanwender angezeigt werden sollen.

        Eindeutiges Formular in IBM Watson Assistant. Die Registerkarte „Unmehrdeutigkeit“, der ein-/Ausschalter, die Unmehrdeutigkeitsnachricht, die Nachricht „alles andere“ und das Maximum für Vorschläge werden hervorgehoben.

    3. Navigieren Sie zu Dialogfeld Wählen Sie einen Knoten aus, für den die Unklarheitsfunktion 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 Deutung angezeigt wird. Optionale Knotenzusammenfassung wird hervorgehoben.
    4. In Ihrem ServiceNowInstanz, aktivieren Sie diese Plugins:
      • 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 AssistantV2-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-DesignerHomepage, wählen Sie aus IBM Watson AssistantV2-Thema zum Öffnen der Seite „Themeneigenschaften“.
        Beachten Sie, dass Stichwort Für dieses Thema ist IBM Watson AssistantV2.
      3. Wählen Sie auf der Seite „Themeneigenschaften“ die Option aus Veröffentlichen Um das Thema auf bereitzustellen Virtual AgentChat-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– In Wert Geben Sie die Watson-Assistenten-ID für Ihren Assistenten ein, und wählen Sie aus Aktualisieren .

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

      • watson_assistant.v2.service_endpoint– In 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 Beispiel-URL-Wert und Schaltfläche „Aktualisieren“ hervorgehoben.
        Hinweis:
        Sie können nur den Standortteil der Serviceinstanz-URL in 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 Speicherort 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 AssistantProfil.
      1. Navigieren Sie zu Alle , Und geben Sie dann ein sys_auth_profile_basic.list Im Filter.
      2. Öffnen Sie IBM Watson AssistantProfildatensatz.
      3. Geben Sie im Formular „Konfiguration der Standardauthentifizierung“ den Watson Assistant-API-Schlüssel in ein Passwort Feld und auswählen Aktualisieren .
        Konfiguration der Standardauthentifizierung für IBM Watson AssistantProfil mit hervorgehobenem Passwortfeld und Schaltfläche „Aktualisieren“.
    9. Fügen Sie hinzu Virtual Agent(Webchat)-Client zu 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 AgentWidget, und ziehen Sie das Widget in den umrissenen Bereich.
        Das lila Chat-Symbol wird unten rechts angezeigt.

        ServiceportalDesigner-Seite mit Virtual Agent ServiceportalWidget, Design-Canvas und Chat-Symbol hervorgehoben.

    10. Konfigurieren Sie Virtual AgentWidget, 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 schwebenden Chat-Schaltfläche zu ändern.
      1. In URL-Parameter des Virtual Agent-Clients 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.
        Sie finden die sys_ID eines Themas in der Tabelle „Themen“ [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 der veröffentlichten IBM Watson AssistantAuszuführendes V2-Thema.

        Wichtig:

        Verwenden Sie Sysparm_topic Parameter nur zum Laden des angegebenen Themas in ServiceportalChat-Client oder bei Verwendung von IBM Watson AssistantChat-Integrationen (com.Glide.cs.ibm.watson.Assistant.topic und com.Glide.cs.ibm.watson.Assistant.topicV2-Plugins). Mit diesem Parameter können Anwender keine neue Konversation starten oder an einen Servicemitarbeiter übertragen. Deaktiviert auch das Kontextmenü und unterstützt keine anderen Chat-Clients von Drittparteien.

      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 „URL-Parameter des Virtual Agent-Clients“ ist hervorgehoben.
    11. Testen Sie, ob die Deutungsfunktion für Ihr Thema funktioniert.
      Stellen Sie sicher, dass die Unklarheit für Ihre Watson-Assistent-Kompetenz und mindestens zwei Dialogknoten aktiviert ist. Im folgenden Beispiel stellt der Virtual Agent vier zusätzliche Absichten bereit, die der Anwender auswählen kann.
      Abbildung : 1. Beispielthema mit Mehrdeutigkeit
      Virtual Agent Konversation, die zusätzliche Absichten anzeigt, die über die Deutungsfunktion erkannt wurden.