Hinzufügen angepasster Funktionen in Konversationsabläufen von AI Agents – Advanced mithilfe gefälschter Integrationen

Welchen Plan habe ich

Add-on

AI Agents – Advanced

Mit einer gefälschten Integration können angepasste Funktionen basierend auf bereits in der Konversation vorhandenen Daten zu Dialogen hinzugefügt werden, ohne dass tatsächliche API-Aufrufe durchgeführt oder externe Daten abgerufen würden. Dadurch können Sie JSONata-Logik zur Datenmanipulation und für Vergleiche und andere Aufgaben des Dialogflusses implementieren.

Diese Art der Integration eignet sich für Aufgaben, für die keine externen Echtzeitdaten erforderlich sind, da sie als „Helper“ die Funktionen eines AI Agent über die Standardfunktionen hinaus erweitert.

In diesem Beitrag werden folgende Themen behandelt:

• Überblick über gefälschte Integrationen
• Erstellen einer fiktiven Integration
• Hinzufügen einer fiktiven Integration in einem Dialogfeld

Überblick über gefälschte Integrationen

Eine fiktive Integration ist hilfreich, wenn Sie bereits in der Konversation verfügbare Daten verarbeiten oder manipulieren möchten. Zum Beispiel können Sie mithilfe einer fiktiven Integration folgende Aufgaben ausführen:

• Daten in ein geeigneteres Format umwandeln.
• Komplexe CRM oder API-Daten formatieren und filtern
• Datumswerte vergleichen, um das jüngste Datum zu finden
• Den aktuellen Tag und die aktuelle Uhrzeit abrufen
• Prüfen, ob ein Datum in einem bestimmten Zeitraum liegt
• Prüfen, ob eine URL bestimmte Wörter enthält
• Suchen nach Nullwerten und deren Ersatz
• Ersetzen von Buchstaben oder Symbolen in Ihren Daten
• Verwenden Sie einen die Groß-/Kleinschreibung ignorierenden Filter, um Daten zu durchforsten und den ersten übereinstimmenden Wert zurückzugeben oder eine alternative Antwort zu liefern, falls es keine Übereinstimmungen gibt.

Falls Sie Logik mit JSONatadefinieren können, können Sie Ihre Konversationen mit diesen hilfreichen Integrationen erweitern.

Erstellen einer fiktiven Integration

Tipp: Bevor Sie eine fiktive Integration erstellen, sollten Sie sich mit dem Integration Builder und der Verwendung von JSONata vertraut machen. Weitere Informationen finden Sie unter JSONata Enablement.

Um eine fiktive Integration zu erstellen, erstellen Sie wie gewohnt eine API-Integration. Es findet jedoch nie eine Datenabfrage statt.

Zum Erstellen einer fiktiven Integration

1. Klicken Sie im Hauptmenü auf API-Integrationen.
2. Klicken Sie oben rechts auf Add Integration.
3. Führen Sie im Fenster „Integration hinzufügen“ folgende Schritte aus:
   
   1. Geben Sie im Feld Integrationsname einen aussagekräftigen Namen ein.
   2. (Optional) Geben Sie im Feld Beschreibung eine Beschreibung der Integration ein, damit Sie sich besser daran erinnern können, wozu sie dient.
   3. Klicken Sie auf Speichern.
4. Wählen Sie in der linken Seitenleiste unter Umgebungen eine Umgebung aus (z. B. Production).
5. Setzen Sie den Methodentyp auf GET.
6. Geben Sie im Feld URL eine Dummy-URL ein (z. B. https://dummyjson.com/http/200).
   

   • Hinweis: Da fiktiven Integrationen im Integrations-Framework gehostet werden, müssen sie auf eine gültige URL verweisen. Im Beispiel oben wird https://dummyjson.com/http/200 verwendet. Die Verfügbarkeit kann aber nicht garantiert werden. Sie können jede beliebige Dummy-URL verwenden, Während ein API-Aufruf an die angegebene URL gesendet wird, werden keine Daten aus der Antwort in der fiktiven Integration verarbeitet.

7. Stellen Sie sicher, dass der Autorisierungstyp auf Keine Autorisierunggesetzt ist.
8. (Optional) Setzen Sie in der linken Seitenleiste unter Szenarienden Mauszeiger auf Fehlerund wählen Sie das Optionsmenü () aus und klicken Sie auf Löschen. Für eine fiktive Integration ist kein Fehlerszenario erforderlich.
9. Klicken Sie in der linken Seitenleiste unter Szenarienauf Erfolg.
10. Gehen Sie je nach Szenario wie folgt vor:
    
    • Falls Sie eine einfache Query haben, geben Sie sie in das Feld Szenario-Query ein. Falls Sie beispielsweise nur eine boolesche Antwort benötigen, reicht die Query aus.
    • Falls Sie Logik basierend auf Anfrageparametern (aus der Konversation) definieren müssen:
      
      1. Geben Sie requestParameters in das Feld Szenario-Query ein.
      2. Geben Sie unter Sitzungsparameterdie Parameter für die fiktive Integration ein. Der folgende Screenshot enthält Beispielparameter und JSONata-Ausdrücke zur Eingabe des Wochentags und der aktuellen Uhrzeit.
         
11. Klicken Sie auf Speichern.

Hinzufügen einer fiktiven Integration in einem Dialogfeld

Im Dialoggeneratorkönnen Sie einen API-Integrationsknoten hinzufügen und die fiktive Integration auswählen.

So fügen Sie eine fiktive Integration in ein Dialogfeld ein:

1. Wählen Sie oben rechts im Dropdownfeld „AI Agent“ den AI Agent aus, dessen Dialogfeld Sie aktualisieren möchten.
2. Wählen Sie im Hauptmenü links die Option Inhalte aus > Absichten.
3. Wählen Sie die Absicht aus, deren Dialogfeld Sie aktualisieren möchten.
4. Wählen Sie die Registerkarte Antworten aus.
5. Wählen Sie die Antwort aus, deren Dialogfeld Sie aktualisieren möchten, und klicken Sie dann auf Dialogfeld bearbeiten.
6. Klicken Sie an der entsprechenden Stelle im Dialogfeld auf das Pluszeichen (+) und fügen Sie einen API-Integrationsblock hinzu.
   
7. Wählen Sie die oben erstellte fiktive Integration aus.
   

Wenn nun in der Konversation ein Zweig der fiktiven Integration aufgerufen wird, wird die fiktive API-Integration abgerufen und die im Erfolgsszenario definierten Sitzungsparameter werden in der Konversation bereitgestellt. Das folgende Beispiel zeigt eine fiktive Integration, die in einen konditionalen Block einfließt und dabei tagesabhängige Parameter nutzt, die von der fiktiven Integration zurückgegeben werden.