Der Integration Builder ist ein leistungsstarkes Tool, mit dem Sie einen AI Agent ohne Programmierung mit jeder beliebigen API oder Datenquelle verbinden können – auch wenn Sie über keine besonderen technischen Kenntnisse verfügen. In diesem Beitrag finden Sie Antworten auf häufig gestellte Fragen (FAQs) zum Integration Builder.
In diesem Beitrag werden folgende Themen behandelt:
- Häufig gestellte Fragen zu Parametern und Daten
- Häufig gestellte Fragen zu Umgebungen
- Häufig gestellte Fragen zu Karten und Karussells
- Häufig gestellte Fragen zur Authentifizierung
Verwandte Beiträge:
Häufig gestellte Fragen zu Parametern und Daten
Wie werden die Sitzungsdaten aus der Konversation erfasst?
Die Erfassung der Sitzungsdaten in AI Agent-Konversationen beginnt am Anfang der Sitzung mit der automatischen Erfassung der Benutzermetadaten und wird mit der Aufzeichnung aller Eingaben, Antworten und Entitäten während der gesamten Interaktion mit dem AI Agent fortgesetzt.
Beim Einleiten einer Chatsitzung – insbesondere durch einen angemeldeten Benutzer – werden automatisch bestimmte Metadaten erfasst. Diese beinhalten in der Regel benutzerspezifische Details wie zum Beispiel Benutzer-ID oder Kontoinformationen, Sitzungs-ID, Standort und Zeitstempel. Diese Daten können dann in Form einer Konversationsaktion gespeichert werden.
Während der Konversation können Sie bei Bedarf bestimmte Antworten des Benutzers erfassen, die dieser entweder in Textform oder durch Klicken auf Schaltflächen übermittelt. Dies kann auf zwei Arten geschehen:
- Mit einem Parameter mit der Einstellung „Parameter erfassen“ in einem konditionalen Block
- Mit einer Entität
Diese Parameter können dann an die Integration übergeben und als Anfrageparameter im URL-Endpunkt oder Anfragetext verwendet werden.
Was ist ein URL-Parameter und wie verwende ich ihn?
Ein URL-Parameter ist ein dynamischer Bestandteil der URL, dessen Wert von den Informationen abhängt, die in den Anfrageparametern aus der Konversation an die Integration übergeben werden.
Im folgenden Beispiel wird eine Benutzer-ID als Parameter verwendet:
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}Der Parameter user_id wird in doppelten geschweiften Klammen zur URL hinzugefügt.
Wie kann ich auf Daten aus der Konversation zugreifen, um sie in der API zu verwenden?
Daten aus der Konversation, die Sie verwenden möchten, müssen wie oben beschrieben als Parameter in der Sitzung gespeichert werden; Sie können entweder die Parameter erfassen oder Metadaten als Parameter in den Sitzungsdaten speichern. Die Daten müssen als Anfrageparameter im Integration Builder gespeichert werden, wenn sie aus der Konversation stammen, oder als Sitzungsdaten/Metadaten, die an die API gesendet werden. Anschließend können Sie diesen Parameter auch dynamisch im Anfragetext übermitteln.
Wie kann ich auf die Parameter oder Daten aus der API-Antwort zugreifen, um sie in der Konversation zu verwenden?
Wenn Sie Parameter oder Daten aus der API-Antwort verwenden möchten, müssen Sie sie als Sitzungsparameter in der Umgebung (meist im Erfolgsszenario) speichern. Wenn die API dann in einem bestimmten Szenario landet, können Sie auf den Sitzungsparameter zugreifen und ihn in einer AI Agent-Nachricht oder als Parameter für einen konditionalen Block verwenden:
- In einer AI Agent-Nachricht wird er als {{parameterName}} referenziert.
- In einem konditionalen Block wird er über den Parameternamen referenziert.
Wie sende ich Anfrageparameter im Anfragetext?
Wenn Sie einen Anfrageparameter im Anfragetext senden möchten, müssen Sie ihn in doppelte geschweifte Klammern setzen.
{{exampleParameter}}Kann ich ein Array im Anfragetext senden?
Ja, Sie können beim Definieren der Anfrageparameter den Datentyp „Array“ auswählen. Formatieren Sie den Wert beim Testen mit der JSONata-Funktion $eval($) neu. Die Funktion „eval“ analysiert und wertet eine Zeichenfolge, die einen JSON- oder einen JSONata-Ausdruck enthält, wie jeden anderen JSON-Code aus.
In diesem Fall nehmen wir eine in einem Array enthaltene Zeichenfolge und parsen sie mit $eval() als Array. Am häufigsten wird diese Funktion zum Senden eines Arrays von Bestellungen verwendet.
Warum erhalte ich beim Testen keine oder die falschen Anfrageparameter?
Beim Testen müssen Sie als Anfrageparameter im Integration Builder einen Testwert verwenden, der mit realen Daten in Ihrem Endpunkt übereinstimmt. In einer Live-Konversation wird der Wert dieses Parameters dagegen aus der Konversation selbst übernommen. Wenn Sie den Parameter und seinen Wert beim Testen nicht in den Sitzungsdaten sehen können, sollten Sie sich vergewissern, dass Sie ihn im Dialog als den richtigen Parameter speichern.
Beachten Sie, dass bereinigte Sitzungsdaten nicht in den Konversationsprotokollen angezeigt werden. In diesem Fall müssen Sie sie möglicherweise vorübergehend in einer AI Agent-Nachricht protokollieren und stattdessen diese debuggen.
Warum sehe ich [Object, object]?
[Object, object] bedeutet, dass Sie versuchen, ein Objekt auszugeben, für dessen Anzeige dem System keine strukturierte Möglichkeit zur Verfügung steht. Um dieses Problem zu beheben, müssen Sie das Objekt in ein Zeichenfolgenformat konvertieren.
Werden erfolgreiche Anrufe protokolliert?
Nein, zum Schutz personenbezogener Daten und zur Einhaltung der DSGVO werden erfolgreiche Datenanrufe nicht protokolliert. Wir protokollieren erfolglose Anrufe, damit wir bei Bedarf weitere Informationen für die Fehlerbehebung bereitstellen können.
Häufig gestellte Fragen zu Umgebungen
Warum brauche ich möglicherweise verschiedene Umgebungen?
Zum Testen von Integrationen sollten Sie keine realen Daten oder Live-Daten verwenden. Wenn Sie Zugang zu einer Sandbox-, Staging- oder Entwicklungsumgebung haben (fragen Sie gegebenenfalls Ihr technisches Team oder sehen Sie in der API-Dokumentation nach), können Sie diese im Integration Builder einrichten.
In den Umgebungen werden dieselben Anfrageparameter und Ausgaben verwendet, sie weisen aber unterschiedliche Endpunkte und Authentifizierungsdetails auf. Im Dialoggenerator können Sie mühelos zwischen verschiedenen Umgebungen für den API-Knoten wechseln. Sie brauchen beim Testen also nur einen Dialog zu erstellen und können dann zu einer Produktionsumgebung wechseln, sobald Sie bereit sind, die Integration in Betrieb zu nehmen.
Häufig gestellte Fragen zu Karten und Karussells
Muss ich eine maximale Anzahl von Karten festlegen?
Für die Sunshine Conversations-Integration gilt eine maximale Anzahl von 10 Karten.
Wir empfehlen, die Anzahl der Karten in einem Karussell auf 9 (oder 8 Karten plus eine Fallback-Karte) zu begrenzen. Eine Fallback-Karte bietet dem Benutzer die Möglichkeit, das Karussell zu verlassen, wenn es das gewünschte Element nicht enthält.
Muss ich auf den Karten in einem Karussell Bilder anzeigen?
Ja, das Bild ist ein erforderliches Datenfeld. Sie können im Bildfeld aber einen generischen Bildlink einrichten, wenn Sie keine dynamischen Bilder benötigen (z. B. ein Bild pro Produkt).
Häufig gestellte Fragen zur Authentifizierung
Welche Authentifizierungsmethoden kann ich verwenden?
Sie können die folgenden Authentifizierungsmethoden verwenden:
- API-Schlüssel
- Inhaber-Token
- Temporäres Token
- Standardauthentifizierung
- OAuth 2.0
- IP-Zulassungslisten
Weitere Informationen zur Authentifizierung für den Integration Builder finden Sie unter Technische Anforderungen an Integrationen.
Kann ich eine Integration mit einem Endpunkt aus der Zulassungsliste erstellen?
Ja. Dazu müssen Sie unsere IP-Adressen in Ihre Zulassungsliste aufnehmen. Eine Liste der IP-Adressen finden Sie unter Zulassen von IP-Adressen zum Verbinden von AI Agents mit Ihrem CRM-System.
Was ist eine „Nur-Authentifizierung“-Integration und wann brauche ich sie?
Weitere Informationen zu „Nur-Authentifizierung“-Integrationen finden Sie unter Verwenden der angepassten Autorisierung mit dem Integration Builder.
Kann ich Durchsatzbeschränkungen und Drosselung einrichten?
Wir beschränken oder drosseln den Durchsatz nicht direkt. Die Durchsatzbeschränkung wird in der Regel durch die integrierten Systeme oder APIs (z. B. durch Ihr Backend-System) erzwungen. Diese Limits sind von der Konfiguration Ihres Backends abhängig.
Was geschieht, wenn meine API länger als neun Sekunden braucht, um zu antworten?
Im Arbeitsbereich für AI Agents ist ein Timeout von neun Sekunden für API-Antworten festgelegt. Wenn Ihre API in dieser Zeit keine Antwort sendet, wird die Anfrage abgebrochen und der Fehler ECONNABORTED zurückgegeben. Außerdem können längere Antwortzeiten das Benutzererlebnis beeinträchtigen, da sie von Benutzern häufig als frustrierend empfunden werden.
Wenn Sie damit rechnen, dass bestimmte API-Antworten länger als neun Sekunden dauern werden, sollten Sie die erforderlichen API-Aufrufe nach Möglichkeit zu Beginn der Konversation (beispielsweise beim Ereignis „Chat gestartet“) durchführen und die relevanten Informationen in der Sitzung speichern. Auf diese Weise stellen Sie sicher, dass die Daten bereitstehen, wenn sie benötigt werden, und im Konversationsfluss keine Verzögerungen auftreten.