Integrationen verwenden

Um Ihre API-Integrationen mit dem Dialogfluss Ihres KI-Agenten zu verbinden, müssen Sie Integrationsmodule in Ihrem Dialogfluss-Builder verwenden. Die Integration wird in dem Moment ausgelöst, in dem dieses Modul im Dialogfluss erreicht wird (an der Stelle, an der Sie Ihr Integrationsmodul platziert und verbunden haben).

Note

Dieser Artikel setzt grundlegende Kenntnisse im Erstellen von Dialogflüssen sowie mindestens einen im Abschnitt API-Integrationen konfigurierten Endpunkt voraus.

Integrationstypen: Blockierend vs. Asynchron

Es gibt zwei Arten von Integrationsmodulen, und die Wahl des richtigen Moduls hängt davon ab, wie schnell Ihre API antwortet und welche Art von Bot Sie erstellen.

Modul API Integration

Dieses Modul wartet auf die Antwort, bevor es fortfährt.

• Ideal für: Chatbots, E-Mail-Bots oder schnelle APIs
• Der Dialog stoppt hier, bis die Antwort empfangen wird oder ein Timeout eintritt
• Danach wird der Fluss über den Ausgangsport Success oder Failure fortgesetzt

Note

Vermeiden Sie die Verwendung dieses Moduls mit langsamen APIs in Voicebots. Lange Verzögerungen können den Anrufablauf und das Kundenerlebnis stören. Verwenden Sie stattdessen die Async/Await-Version des Moduls.

Modul API Integration (Async + Await)

Diese Methode ist nicht blockierend. Sie trennt das Senden der Anfrage und das Prüfen des Ergebnisses in zwei separate Module, die Sie verwenden und miteinander verknüpfen müssen:

1. API Integration (Async) — sendet die Anfrage und wechselt sofort zum nächsten verbundenen Modul in Ihrem Dialogfluss, ohne auf die Antwort zu warten (die zugeordneten $context werden noch nicht erstellt)

2. API Integration (Await) — prüft später, ob die Antwort eingetroffen ist. Falls nicht, wartet es eine festgelegte Zeit und fährt dann über den entsprechenden Ausgangsport fort.

3. Wird üblicherweise nur für Voicebots verwendet

4. Ermöglicht es, die Konversation fortzusetzen, während die Integration im Hintergrund läuft (in der Zwischenzeit stellt der Bot weitere Fragen oder informiert den Benutzer einfach darüber, dass wir daran arbeiten)
5. Das Await-Modul wartet auf die Antwort, wenn der Dialogfluss dieses Modul erreicht. Ist das Ergebnis noch nicht bereit, pausiert es für den definierten Timeout-Zeitraum und fährt dann über den Pfad Waiting for response fort, falls die Antwort weiterhin nicht empfangen wurde. Sie können den Dialog zu diesem Modul zurückschleifen, um es erneut zu versuchen, oder stattdessen einen Fallback-Dialog wählen.

So verwenden Sie die Integrationsmodule

Verwendung des einfachen Moduls „API Integration“

1. Ziehen Sie im Abschnitt Advanced des Modulbereichs das Modul API Integration in Ihren Fluss.
2. Klicken Sie auf das Modul, um den Einstellungsbereich zu öffnen.
3. Wählen Sie aus dem Dropdown-Menü den Endpunkt aus, den Sie verwenden möchten.
4. Fügen Sie optional benutzerdefinierte dynamische Ausgangsports hinzu (falls Sie diese in der Verwaltung der API-Integrationen definiert haben).
5. Verbinden Sie die Ausgänge Success und Failure (sowie ggf. benutzerdefinierte Ports), um festzulegen, was als Nächstes geschieht.

Verwendung der Async-Version

Schritt 1: API Integration (Async)

• Platzieren Sie das Modul API Integration (Async) in Ihrem Fluss.
• Wählen Sie den aufzurufenden Endpunkt aus.
• Verbinden Sie die nächsten Schritte — dies geschieht sofort.
• Hinweis: Jeder für die Integration benötigte Eingabe-$context muss zu diesem Zeitpunkt vorhanden sein — der Bot benötigt ihn, um die Anfrage zu senden.

Schritt 2: API Integration (Await)

• Verwenden Sie das Await-Modul weiter im Fluss, an der Stelle, an der Sie prüfen möchten, ob die Antwort eingetroffen ist, und davon ausgehen, dass genügend Zeit vergangen ist, um sie zu erhalten.
• Legen Sie das Timeout des Moduls fest (wie lange der Bot auf die Antwort warten soll, falls sie noch nicht eingetroffen ist). Beachten Sie, dass das für diesen Endpunkt in der Verwaltung der API-Integrationen festgelegte Timeout weiterhin gilt (um Endlosschleifen zu verhindern). Stellen Sie daher sicher, dass das Timeout des Moduls nicht länger ist als das Timeout des Endpunkts.

• Verbinden Sie:

• Success → Antwort ist bereit, zugeordnete Kontexte können verwendet werden

• Waiting for response → Antwort nicht rechtzeitig bereit (Sie können es erneut versuchen, aber achten Sie darauf, keine Endlosschleife zu erzeugen — verwenden Sie das Counter-Modul, um wiederholte Timeouts abzuleiten)
• Failure → ein Fehler ist aufgetreten
• Hinweis: Zwischen dem Async- und dem Await-Modul muss ein roter Pfeil oder eine andere Art von Pause liegen. Der Bot verarbeitet alle mit grünen Pfeilen verknüpften Module gleichzeitig, sodass er ohne eine Pause nicht genügend Zeit hätte, die Antwort zu empfangen.