Virtual Agent-API verwenden

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Verwenden Sie ServiceNow® Virtual Agent API-App zur Integration einer beliebigen Chat-Schnittstelle oder eines Bots mit ServiceNow® Virtual Agent Oder Mitarbeiterchat. Die App ist über verfügbar ServiceNow® Store.

    Übersicht über Virtual Agent-API

    Die Virtual Agent API ist eine REST-API. Diese API basiert auf dem anwenderdefinierten Chat-Integrations-Framework für Konversationen, das mit bereitgestellt wird Virtual Agent Startet in Paris Release. Die API aktiviert ServiceNow Zu verwendende Entwickler, fortgeschrittene Anwender und Administratoren Virtual Agent Auf eine der folgenden Arten:

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

    Ihre Endanwender können mit interagieren Virtual Agent Und Mitarbeiterchat Mithilfe dieser Integration über mehrere Kanäle.

    Sekundärer Bot
    Verwenden Virtual Agent Als sekundärer 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 könnte sein IBM Watson Assistant, Microsoft LUIS, Oder ein selbst entwickelter primärer Bot.

    Ihre sekundären Bots, z. B. ServiceNow Bot, kann bestimmte Arten von Endanwenderanforderungen verarbeiten, z. B. Service-Tickets oder Reservierungen.

    Bot Interconnect
    Verwenden Virtual Agent Bot Interconnect Als primärer Bot in einer vielfältigen Chat-Umgebung. Bot Interconnect Erstellt eine einheitliche Chat-Experience und gewährt Ihren Endanwendern Zugriff auf mehrere Kanäle und eine Vielzahl von Unternehmensaufgaben, die über verfügbar sind ServiceNow.

    Die Virtual Agent Die API ist nützlich, um Server-zu-Server-Integrationen zu erstellen. Für Integrationen, die die Transformation nicht unterstützter Steuerungen erfordern, die in Ihrer vorhandenen Chat-Schnittstelle gerendert werden müssen, sollten Sie jedoch die Verwendung von in Betracht ziehen Anwenderdefiniertes Chat-Integrations-Framework .

    Für Informationen zu Funktionen wie dem URL-Format und den unterstützten Anforderungs- und Antwortparametern in Virtual Agent API, siehe Virtual Agent-Bot-Integrations-API .

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

    Wie Virtual Agent API funktioniert

    Das folgende Diagramm zeigt, wie die REST-API Anwendereingaben aus einer Chat-Schnittstelle eines Drittanbieters oder einem primären Bot verarbeitet und dann eine Bot-Antwort generiert.
    1. Der Anwender stellt Eingaben für einen primären Bot oder eine Chat-Schnittstelle einer Drittpartei bereit.
    2. Der Bot sendet eine POST-Anforderungs-JSON an den eingehenden REST-Endpunkt (über geskriptete REST-API).
    3. Die ServiceNow AI Platform Authentifiziert und verarbeitet die Anforderung, die an gesendet wird Virtual Agent Oder ein Servicemitarbeiter.
    4. Die ServiceNow AI Platform Sendet eine POST-Antwort-JSON vom ausgehenden REST-Endpunkt (über REST API) zurück an den Bot.
    5. Die primäre Bot- oder Drittanbieter-Chat-Schnittstelle zeigt die Antwort an den Anwender an.
    Abbildung : 1. Ein- und ausgehende REST-Endpunkte in der Virtual Agent API
    Diagramm, das zeigt, wie die REST-Endpunkte in Virtual Agent API verarbeitet Anwendereingaben und -Authentifizierung sowie Bot-Antwort und -Authentifizierung.

    Um eine Demonstration von anzuzeigen Virtual Agent API und FAQ, siehe Erste Schritte mit Virtual Agent-APIs Auf der Community-Website.

    Einschränkungen

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

    Versions- und Release-Kompatibilität

    Tabelle : 1. Virtual Agent API-Version 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 von Funktionen ist kompatibel mit Quebec.
    1.3.0 Quebec
    1.0.12 Quebec
    1.0.9 Paris
    Hinweis:
    Die Virtual Agent Die API erfordert eine Pro-Lizenz, die der von ähnelt Virtual Agent.