Virtual Agent-API verwenden

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

    • Verwenden Sie die API-App ServiceNow® Virtual Agent, um eine beliebige Chatschnittstelle oder einen Bot mit ServiceNow® Virtual Agent oder Mitarbeiterchatzu integrieren. Die App ist im ServiceNow® Storeverfügbar.

    Übersicht über Virtual Agent-API

    Die Virtual Agent -API ist eine REST-API. Diese API basiert auf dem Framework für die Integration benutzerdefinierter Konversationschats, das ab dem Release Paris ] mit Virtual Agent bereitgestellt wird. Die API ermöglicht Entwicklern von ServiceNow, erfahrenen Benutzern und Administratoren, Virtual Agent auf eine der folgenden Arten zu verwenden:

    Eigenständiger Bot
    Verwenden Sie Virtual Agent als eigenständigen Bot, den Sie mit Enterprise oder einer anderen Chatschnittstelle von Drittparteien integrieren, die Konversationsschnittstellen unterstützt.

    Endanwender können mithilfe 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 Endanwenders. 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 Endanwenderanforderungen bearbeiten, z. B. Servicetickets oder Reservierungen.

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

    Die Virtual Agent API eignet sich zum Erstellen von Server-zu-Server-Integrationen. Für Integrationen, die die Transformation nicht unterstützter Steuerelemente erfordern, die in Ihrer vorhandenen Chatoberfläche gerendert werden müssen, sollten Sie jedoch das Custom Chat Integration Frameworkverwenden.

    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 Integration API.

    Videolink zur Virtual Agent Academy. Erweitern Sie Ihre Experiences mit der Virtual Agent API (Virtual Agent Academy-Video)

    Funktionsweise der Virtual Agent -API

    Das folgende Diagramm zeigt, wie die REST API Benutzereingaben von einer Chatschnittstelle einer Drittpartei oder einem primären Bot verarbeitet und dann eine Bot-Antwort generiert.
    1. Der Benutzer gibt Eingaben an eine primäre Bot- oder Chatschnittstelle einer Drittpartei.
    2. Der Bot sendet eine JSON-POST-Anforderung an den eingehenden REST-Endpunkt (über eine 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 die REST API) an den Bot zurück.
    5. Der primäre Bot oder die Chatoberflächen einer Drittpartei zeigen dem Anwender die Antwort an.
    Abbildung : 1. Eingehende und ausgehende REST-Endpunkte in der Virtual Agent -API
    Diagramm, das zeigt, wie die REST-Endpunkte in der API Virtual Agent Benutzereingaben und -authentifizierung sowie Bot-Antwort und Authentifizierung verarbeiten.

    Eine Demonstration der Virtual Agent -API und häufig gestellte Fragen 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-Versions- und Release-Kompatibilität
    Version Kompatible Releases
    3.14.3 Yokohama
    3.14.2 Xanadu
    3.14.1 Xanadu
    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 kompatibel mit Quebec.
    1.3.0 Quebec
    1.0.12 Quebec
    1.0.9 Paris
    Hinweis:
    Die Virtual Agent API erfordert eine ähnliche Pro-Lizenz wie Virtual Agent.