Arbeiten mit Virtual Agent API

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

    • Verwenden Sie die API-App ServiceNow® Virtual Agent, um eine Chat-Schnittstelle oder einen Bot mit ServiceNow® Virtual Agent oder Mitarbeiterchatzu integrieren. Die App ist über den ServiceNow® Storeverfügbar.

    Übersicht

    Die Virtual Agent -API ist eine REST-API. Diese API basiert auf dem benutzerdefinierten Konversations-Chat-Integrations-Framework, das mit Virtual Agent ab Release Paris ] bereitgestellt wird. Mit der API können ServiceNow -Entwickler, fortgeschrittene Benutzer und Administratoren Virtual Agent auf eine der folgenden Arten verwenden:

    Eigenständiger Bot
    Verwenden Sie Virtual Agent als eigenständigen Bot, den Sie in Enterprise oder in eine andere Chat-Schnittstelle von Drittanbietern integrieren, die Konversations-Schnittstellen unterstützt.

    Ihre Endbenutzer können mit dieser Integration über mehrere Kanäle mit Virtual Agent und Mitarbeiterchat interagieren.

    Sekundärer Bot
    Verwenden Sie Virtual Agent als sekundären Bot in einer Umgebung mit mehreren spezialisierten Bots, die von einem primären Bot verwaltet werden.

    In diesem Szenario verwaltet ein primärer Bot die Kommunikation mit sekundären Bots im Namen des Endbenutzers. Ein primärer Bot kann IBM Watson Assistant, Microsoft LUISoder ein selbst erstellter primärer Bot sein.

    Ihre sekundären Bots, z. B. der Bot ServiceNow, können bestimmte Arten von Endbenutzeranforderungen verarbeiten, z. B. Servicetickets oder Reservierungen.

    Bot Interconnect
    Verwenden Sie Virtual Agent Bot Interconnect als primären Bot in einer anderen Chat-Umgebung. Bot Interconnect bietet eine einheitliche Chat-Experience und ermöglicht Ihren Endbenutzern den Zugriff auf mehrere Kanäle und eine Vielzahl von Unternehmensaufgaben, die über ServiceNowverfügbar sind.

    Die Virtual Agent -API ist nützlich zum Erstellen von Server-zu-Server-Integrationen. Für Integrationen, die die Transformation nicht unterstützter Steuerelemente erfordern, die in Ihrer vorhandenen Chat-Oberfläche gerendert werden müssen, sollten Sie jedoch das benutzerdefinierte Chat-Integrations-Frameworkverwenden.

    Weitere Informationen zu Funktionen wie dem URL-Format und den unterstützten Anforderungs- und Antwortparametern in der Virtual Agent -API finden Sie unter Virtual Agent-Bot-Integrations-API.

    Videolink zur Virtual Agent-Akademie. Experiences mit der Virtual Agent-API verbessern (Video zur Virtual Agent-Akademie)

    Funktionsweise der API Virtual Agent .

    Das folgende Diagramm zeigt, wie die REST-API Benutzereingaben von einer Drittanbieter-Chatschnittstelle oder einem primären Bot verarbeitet und dann eine Bot-Antwort generiert.
    1. Der Benutzer gibt Eingaben in einer primären Bot- oder Drittanbieter-Chatschnittstelle ein.
    2. Der Bot sendet eine POST-Anforderungs-JSON an den eingehenden REST-Endpunkt (über die geskriptete REST-API).
    3. Now Platform authentifiziert und verarbeitet die Anforderung, die an Virtual Agent oder einen Servicemitarbeiter gesendet wird.
    4. Now Platform sendet eine POST-Antwort-JSON vom ausgehenden REST-Endpunkt (über REST-API) zurück an den Bot.
    5. Die Chat-Schnittstellen des primären Bots oder einer Drittpartei zeigen dem Benutzer die Antwort an.
    Abbildung : 1. Eingehende und ausgehende REST-Endpunkte in der Virtual Agent -API
    Diagramm, das zeigt, wie die REST-Endpunkte in der Virtual Agent -API Benutzereingaben und -authentifizierung sowie Bot-Antwort und -Authentifizierung verarbeiten

    Eine Demonstration der Virtual Agent -API und eine FAQ finden Sie unter Erste Schritte mit Virtual Agent-APIs auf der Community-Website.

    Einschränkungen

    Die Virtual Agent API unterstützt die folgenden Funktionen nicht:
    • Chat-Branding über diese Virtual Agent API-Integration

    Versions- und Release-Kompatibilität

    Tabelle : 1. Virtual Agent API-Version und Release-Kompatibilität
    Version Kompatible Releases
    3.10.0 Washington DC
    3.9.x Vancouver
    3.8.x Vancouver
    3.7.x Utah
    3.5.x Tokyo
    3.0.x San Diego
    2.0.x Rome

    Eine Teilmenge der Funktionen ist mit Quebeckompatibel.
    1.3.0 Quebec
    1.0.12 Quebec
    1.0.9 Paris
    Hinweis:
    Die Virtual Agent API erfordert eine Pro-Lizenz ähnlich der von Virtual Agent.