Welchen Plan habe ich
Suite Team, Growth, Professional, Enterprise oder Enterprise Plus
Support mit Live-Chat und Messaging Team, Professional oder Enterprise
In diesem Beitrag werden Funktionen beschrieben, die nur Kunden zur Verfügung stehen, die seit dem 2. Februar 2025 einen AI Agent entworfen oder veröffentlicht haben. Weitere Informationen zu den entsprechenden Funktionen im Add-on „AI Agents – Advanced“ finden Sie unter Erstellen von Dialogen für AI Agents – Advanced.
Im AI Agent-Schritt Bedingung für Geschäftszeiten hinzufügen können Sie die Konversation je nachdem, ob Ihr Geschäft geöffnet oder geschlossen ist, mit einer anderen Antwort des AI Agent fortsetzen. Es ist aber nicht möglich, die Konversation je nach der Verfügbarkeit von Agenten zu verzweigen.

In diesem Rezept verwenden Sie die Bot-Builder-Schritte API-Aufruf durchführen und Nach Bedingung verzweigen, um festzustellen, wie viele Online-Agenten verfügbar sind, und die Konversation mit einer entsprechenden Antwort fortzusetzen. Der Schritt API-Aufruf durchführen ermittelt die Anzahl der Agenten, die momentan online sind, indem er den Endpunkt Get Agent Status Count der Zendesk Real Time Chat REST-API aufruft. Die ermittelte Anzahl wird dann im Schritt Nach Bedingung verzweigen für die Verzweigung des Antwortflusses verwendet.

Auf diese Weise können Sie angepasste AI Agent-Nachrichten senden, bevor Sie mit dem Schritt An Agenten übergeben ein Ticket erstellen, und Kunden zum Beispiel mitteilen, mit welchen Warte- oder Antwortzeiten sie rechnen müssen.

Es umfasst die folgenden Aufgaben:
  • Aufgabe 1: Einrichtung überprüfen
  • Aufgabe 2: API-Verbindung erstellen
  • Aufgabe 3: Agentenverfügbarkeit ermitteln
  • Aufgabe 4: Je nach Agentenverfügbarkeit verzweigen
  • Aufgabe 5: Aktualisierten AI Agent veröffentlichen
  • Aufgabe 6: Änderungen testen

Aufgabe 1: Einrichtung wird überprüft

Für dieses Rezept benötigen Sie Folgendes:
  • Ein Zendesk-Konto mit einem veröffentlichten AI Agent für Messaging. Wenn Sie einen Suite Enterprise- oder einen Enterprise Plus-Plan haben, können Sie den AI Agent in einer Sandbox testen, bevor Sie ihn in der Produktionsumgebung einsetzen.

    Weitere Informationen zum Einrichten eines AI Agent in einem Web- und Mobile-Messaging-Kanal finden Sie im Beitrag Erstellen eines AI Agent für Web- und Mobilkanäle.

  • Ein OAuth-Zugriffstoken für die Zendesk Chat-API. Wie Sie dieses Token generieren, erfahren Sie im Tutorial zur Chat-API: Generieren eines OAuth-Tokens.

Aufgabe 2: API-Verbindung erstellen

Erstellen Sie zunächst eine API-Verbindung, um Ihr OAuth-Zugriffstoken für die Chat-API zu speichern. Über diese Verbindung kann der AI Agent API-Aufrufe authentifizieren.

So erstellen Sie die Verbindung
  1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Verbindungen > Verbindungen.
  2. Klicken Sie auf Verbindung erstellen.
  3. Wählen Sie den Authentifizierungstyp Inhaber-Token.
  4. Geben Sie als Verbindungsname „zendesk_chat_api_oauth_token“ ein.
  5. Geben Sie als Token Ihr OAuth-Zugriffstoken ein (siehe Aufgabe 1: Einrichtung überprüfen).
  6. Geben Sie im Feld Zulässige Domäne „rtm.zopim.com“ ein.
  7. Klicken Sie auf Speichern, um die Verbindung zu erstellen.

Aufgabe 3: Agentenverfügbarkeit ermitteln

Fügen Sie als Nächstes den Schritt API-Aufruf durchführen zu einer vorhandenen Antwort im AI Agent hinzu. In diesem Schritt wird die aktuelle Anzahl der Online-Agenten beim Endpunkt Get Agent Status Count der Real Time Chat-API abgerufen.

So fügen Sie den Schritt „API-Aufruf durchführen“ hinzu

  1. Klicken Sie in der Seitenleiste des Admin Centers auf KI und dann auf AI Agents > AI Agents.
  2. Klicken Sie auf AI Agents für Messaging verwalten.
  3. Klicken Sie auf den gewünschten AI Agent und dann auf die Antwort, die Sie aktualisieren möchten.
  4. Fügen Sie im Bot-Builder an der gewünschten Stelle des Antwortflusses einen Schritt hinzu.
  5. Klicken Sie unter Schritt auswählen auf API-Aufruf durchführen.
  6. Geben Sie Agentenverfügbarkeit abrufen in das Feld Name ein.
  7. Geben Sie unter API-Details https://rtm.zopim.com/stream/agents/agents_online als Endpunkt-URL ein.
  8. Wählen Sie unter Authentifizierung die Verbindung zendesk_chat_api_oauth_token aus.
  9. Klicken Sie auf API-Aufruf durchführen, um die API-Anfrage zu testen.
  10. Geben Sie unter Testdaten als Ort die Zeichenfolge Melbourne, AU ein.
  11. Klicken Sie auf API-Aufruf durchführen.
  12. Speichern Sie die folgende Variable unter ihrem Standardnamen:
    • content > data > agents_online
  13. (Optional) Fügen Sie im Schritt Agentenverfügbarkeit abrufen unter der Verzweigung API-Aufruf fehlgeschlagen einen Schritt hinzu. Dieser Schritt wird ausgeführt, wenn der Aufruf „Get Agent Status Count“ fehlschlägt.

Aufgabe 4: Je nach Agentenverfügbarkeit verzweigen

Fügen Sie als Nächstes den Schritt Nach Bedingung verzweigen hinzu, um den Antwortfluss je nach dem Wert der Variablen agents_online zu verzweigen.

So fügen Sie den Schritt „Nach Bedingung verzweigen“ hinzu

  1. Fügen Sie im Bot-Builder in der Verzweigung API-Aufruf erfolgreich des Schritts Agentenverfügbarkeit abrufen einen Schritt hinzu.
  2. Klicken Sie unter Schritt auswählen auf Nach Bedingung verzweigen.
  3. Geben Sie Agentenverfügbarkeit prüfen in das Feld Name ein.
  4. Geben Sie im Feld Name der Verzweigung Wenn das den Namen Agenten sind online ein.
  5. Klicken Sie in der Verzweigung Wenn das auf Bedingung hinzufügen. Konfigurieren Sie die Bedingung wie folgt:
    • Variable: agents_online
    • Operator: Ist nicht
    • Wert: 0
  6. Klicken Sie auf Hinzufügen.
  7. Fügen Sie unter den Verzweigungen Agenten sind online und Sonstige gegebenenfalls weitere Schritte hinzu. Die Schritte unter der Verzweigung Agenten sind online werden ausgeführt, wenn der Aufruf Get Agent Status Count ergibt, dass mindestens ein Agent online ist. Die Schritte unter der Verzweigung Sonstige werden ausgeführt, wenn keine Agenten online sind.

Aufgabe 5: Aktualisierten AI Agent veröffentlichen

Wenn Sie die Bearbeitung der Antwort abgeschlossen haben, können Sie den aktualisierten AI Agent veröffentlichen.

So veröffentlichen Sie den AI Agent
  1. Klicken Sie oben rechts im Bot-Builder auf Fertig.
  2. Klicken Sie auf der AI Agent-Seite auf AI Agent veröffentlichen.
  3. Klicken Sie auf Veröffentlichen.

Aufgabe 6: Änderungen testen

Nachdem Sie die Änderungen veröffentlicht haben, können Sie die aktualisierte Antwort testen, indem Sie in einer Konversation mit dem aktualisierten AI Agent einen der Trainingssätze verwenden. Weitere Informationen zum Testen von AI Agents finden Sie unter Testen des Messaging-Erlebnisses von Endbenutzern.

Powered by Zendesk