Eine Fake-Integration ermöglicht das Hinzufügen von angepassten Funktionen zu Dialogen mit Daten, die bereits in der Konversation vorhanden sind – ohne tatsächliche API-Aufrufe oder den Abruf externer Daten. Auf diese Weise können Sie mithilfe von JSONata im Dialogfluss Logik für Datenmanipulationen, Vergleiche und andere Aufgaben implementieren.
Eine solche Integration eignet sich für Aufgaben, die keine externen Echtzeitdaten erfordern, und dient als Hilfsintegration zur Erweiterung des Funktionsumfangs eines AI Agent.
In diesem Beitrag werden folgende Themen behandelt:
- Überblick über Fake-Integrationen
- Erstellen einer Fake-Integration
- Hinzufügen einer Fake-Integration zu einem Dialog
Überblick über Fake-Integrationen
Eine Fake-Integration ist hilfreich, wenn Sie in der Konversation bereits verfügbare Daten verarbeiten oder manipulieren möchten. So können Sie mit einer Fake-Integration beispielsweise folgende Aufgaben ausführen:
- Daten in ein besser geeignetes Format transformieren
- Komplexe CRM- oder API-Daten formatieren und filtern
- Daten vergleichen, um das jüngste Datum zu bestimmen
- Aktuelles Datum und Uhrzeit abrufen
- Prüfen, ob ein Datum in einem bestimmten Zeitraum liegt
- Prüfen, ob eine URL bestimmte Wörter enthält
- Nullwerte finden und ersetzen
- Buchstaben oder Symbole in Ihren Daten ersetzen
- Daten ohne Berücksichtigung der Groß- und Kleinschreibung filtern und den ersten übereinstimmenden Wert oder – wenn keine Übereinstimmungen vorhanden sind – eine Fallback-Antwort zurückgeben
Wenn Sie Logik mit JSONata definieren können, haben Sie die Möglichkeit, Ihre Konversationen mit diesen hilfreichen Integrationen zu erweitern.
Erstellen einer Fake-Integration
Eine Fake-Integration wird genauso erstellt wie eine reguläre API-Integration. Allerdings werden in diesem Fall keine Daten angefordert.
So erstellen Sie eine Fake-Integration
- Klicken Sie im Hauptmenü auf API-Integrationen.
- Klicken Sie oben rechts auf Integration hinzufügen.
- Führen Sie im Fenster Integration hinzufügen die folgenden Schritte aus:
- Geben Sie in das Feld Integrationsname einen aussagekräftigen Namen für Ihre Integration ein.
- (Optional) Geben Sie in das Feld Beschreibung eine Beschreibung ein, die die Funktion der Integration angibt.
- Klicken Sie auf Speichern.
- Wählen Sie in der linken Seitenleiste unter „Umgebungen“ eine Umgebung aus (z. B. Produktion).
- Setzen Sie den Methodentyp auf GET.
- Geben Sie in das Feld URL eine Dummy-URL ein (z. B.https://dummyjson.com/http/200).
Hinweis: Da Fake-Integrationen im Integrations-Framework gehostet werden, müssen sie auf eine gültige URL verweisen. Im oben stehenden Beispiel wird die URL „https://dummyjson.com/http/200“ verwendet. Die Verfügbarkeit dieser URL kann aber nicht garantiert werden. Sie können eine beliebige Dummy-URL verwenden, die in Ihrem Fall sinnvoll ist. Die Fake-Integration führt zwar einen API-Aufruf an die angegebene URL-Adresse durch, verarbeitet aber keine Daten aus der Antwort.
- Stellen Sie sicher, dass der Autorisierungstyp auf Keine Autorisierung eingestellt ist.
- (Optional) Setzen Sie den Mauszeiger in der linken Seitenleiste unter Szenarien auf Fehler und klicken Sie im Optionsmenü (
) auf Löschen. Für eine Fake-Integration wird kein Fehlerszenario benötigt. - Klicken Sie in der linken Seitenleiste unter Szenarien auf Erfolg.
- Führen Sie je nach Ihrem Szenario einen der folgenden Schritte aus:
- Wenn Sie eine einfache Query haben, geben Sie diese in das Feld Szenarioabfrage ein. Wenn Sie beispielsweise nur eine Boolesche Antwort benötigen, reicht die Abfrage allein aus.
- Wenn Sie Logik definieren müssen, die auf Anfrageparametern (aus der Konversation) basiert:
- Geben Sie in das Feld Szenarioabfrage den Wert requestParameters ein.
- Geben Sie unter Sitzungsparameter die Parameter für Ihre Fake-Integration ein. Der folgende Screenshot enthält Beispielparameter und JSONata-Ausdrücke für die Rückgabe des Wochentags und der aktuellen Uhrzeit.
- Klicken Sie auf Speichern.
Hinzufügen einer Fake-Integration zu einem Dialog
Im Dialoggenerator können Sie einen API-Integrationsblock hinzufügen und Ihre Fake-Integration auswählen.
So fügen Sie eine Fake-Integration zu einem Dialog hinzu
- Wählen Sie oben rechts im Dropdownfeld „AI Agent“ den AI Agent aus, für den Sie den Dialog aktualisieren möchten.
- Klicken Sie im Hauptmenü auf der linken Seite auf Inhalt > Absichten.
- Wählen Sie die Absicht aus, für die Sie den Dialog aktualisieren möchten.
- Klicken Sie auf die Registerkarte Antworten.
- Wählen Sie die Antwort aus, für die Sie den Dialog aktualisieren möchten, und klicken Sie dann auf Dialog bearbeiten.
- Klicken Sie im Dialog an der gewünschten Stelle auf das Pluszeichen (+) und fügen Sie einen API-Integrationsblock hinzu.
- Wählen Sie die Fake-Integration aus, die Sie oben erstellt haben.
Wenn die Konversation den Zweig der Fake-Integration einschlägt, wird nun Ihre Fake-API-Integration aufgerufen, sodass die in Ihrem Erfolgsszenario definierten Sitzungsparameter für den Dialog verfügbar sind. Das folgende Beispiel zeigt eine Fake-Integration, deren Daten über einen von ihr zurückgegebenen Wochentagsparameter in einen konditionalen Block übernommen werden.