Das Einrichten eines Data Connectors bedeutet normalerweise, API-Dokumentationen zu lesen und jedes Feld manuell auszufüllen. Mit Operator beschreiben Sie, was Fin nachschlagen oder aktualisieren soll, und Operator entwirft einen neuen Connector oder repariert einen, der nicht funktioniert. Nutzen Sie diesen Artikel, um zu erfahren, was Operator einrichten kann, wie Sie seine Vorschläge prüfen und testen und welche Einschränkungen zu beachten sind.

Jede Änderung kommt als Vorschlag an. Sie prüfen ihn, genehmigen jeden Testaufruf und entscheiden, ob Sie ihn veröffentlichen oder als Entwurf speichern. Operator kann einen Connector nicht selbst ändern oder eine API aufrufen.

Hinweis: Operator ist im Pro-Add-on enthalten. Um mit Operator zu chatten, benötigen Sie die Berechtigung Can access Fin Operator. Um eine Connector-Änderung anzuwenden, benötigen Sie außerdem die Berechtigungen Fin AI Agent & Automation und Can access Developer Hub.

Wenn Sie neu bei Data Connectors sind, beginnen Sie mit Wie man Data Connectors einrichtet.

Wie man mit Operator einen Data Connector erstellt oder repariert

Der gesamte Prozess findet in einem Operator-Chat statt, vom ersten Auftrag bis zum veröffentlichten Connector.

Schritt 1: Bitten Sie Operator

Beschreiben Sie in einem Operator-Chat, was Fin benötigt. Zum Beispiel:

„Erstelle einen Connector, der eine Shopify-Bestellung anhand ihrer Nummer nachschlägt.“
„Fin sagt ständig, dass es die Bestellung nicht finden kann. Kannst du den Get Order Connector reparieren?“

Schritt 2: Operator untersucht

Bevor Operator etwas vorschlägt, kann es in Ihrem Workspace nachschlagen:

Durchsuchen Sie Ihre Connectoren und lesen Sie die vollständige Einrichtung jedes einzelnen.
Lesen Sie die gespeicherte Testantwort oder die Mock-Antwort eines Connectors.
Sehen Sie, welche workflows, Verfahren und Makros einen Connector verwenden.
Überprüfen Sie die jüngsten Erfolgsraten und die Ausführungshistorie. Es sieht Status und Zeit, nicht was gesendet oder empfangen wurde.
Listen Sie die Attribute auf, die es in der Anfrage oder als Zuordnungsziele verwenden kann.
Listen Sie Ihre Authentifizierungstoken nach Name und Typ auf. Das Geheimnis sieht es nie.

Schritt 3: Vorschlag prüfen

Der Vorschlag erscheint im Chat als Data connector-Karte.

Die Kopfzeile zeigt den Connector-Namen und ein Abzeichen Neu, Live, Entwurf oder Pausiert. Eine Umbenennung zeigt den alten Namen durchgestrichen.
API zeigt die Methode, URL, Dateneingaben, Header, Payload, Test und Authentifizierungstoken.
Daten zeigt die Antwortfelder, Python-Code und Objektzuordnungen.
Fin zeigt die Eingabeaufforderung, die Fin liest, und das Publikum.
Sicherheit zeigt die Kundenauthentifizierungseinstellung.
Bei einer Bearbeitung zeigt die Karte die Änderungen gegenüber der Live-Version. Unveränderte Abschnitte sind eingeklappt, und jeder Abschnitt zeigt, wie viele Zeilen hinzugefügt und entfernt wurden.
Authentifizierungstoken werden nur nach Namen angezeigt.

Schritt 4: Test genehmigen

Bevor ein Test ausgeführt wird, zeigt Operator eine Karte mit dem Titel Test „Connector-Name“ und den Werten, die gesendet werden.

Überprüfen Sie die Werte. Es wird nichts gesendet, bis Sie auf Test ausführen klicken. Abbrechen stoppt es.
Der Test ruft die echte API auf. Das Ergebnis wird z. B. als „Test bestanden (HTTP 200)“ oder „Test fehlgeschlagen (HTTP 401)“ angezeigt.
Operator liest die Antwort und verwendet sie, um die Antwortfelder einzurichten.

Operator kann Fin auch eine Testfrage in einem Vorschau-Gespräch stellen, so wie ein Kunde es tun würde. Dies zeigt, ob Fin den Connector auswählt und wie es die Antwort verwendet. In einer Vorschau antwortet Fin, als ob die ausstehenden Connector-Änderungen bereits angewendet wären, und verwendet die gespeicherte Testantwort oder Mock, anstatt die API aufzurufen.

Wichtig: Tests senden echte Anfragen an das verbundene System. Wenn ein Connector Daten erstellt, aktualisiert oder löscht, bewirkt der Test diese Änderung. Verwenden Sie Testdatensätze. Operator bittet vor jedem Test um Ihre Zustimmung.

Schritt 5: Änderung anwenden

Sie entscheiden, wie die Änderung angewendet wird:

Bei einem Live-Connector ist die Hauptschaltfläche Veröffentlichen. Als Entwurf speichern (oder Entwurf aktualisieren, falls ein Entwurf existiert) befindet sich im Menü.
Bei einem neuen, Entwurfs- oder pausierten Connector ist die Hauptschaltfläche Als Entwurf speichern (oder Entwurf aktualisieren). Veröffentlichen befindet sich im Menü.
Veröffentlichen fragt zuerst „Bereit zum Veröffentlichen?“. Es bleibt deaktiviert, bis der Test von Operator bestanden ist, es sei denn, der Connector verwendet eine Mock-Antwort. Eine Bearbeitung, die die Anfrage unverändert lässt (URL, Methode, Header, Body, Eingaben und Authentifizierungstoken), behält den früheren bestandenen Test des Connectors bei.
Eine Löschung zeigt eine rote Löschen-Schaltfläche und eine Warnung, dass dies nicht rückgängig gemacht werden kann.
Das Papierkorbsymbol (Änderung verwerfen) verwirft den Vorschlag.
Alle anwenden wendet jede Änderung im Chat an. Ein neuer Connector wird als Entwurf gespeichert, und eine Bearbeitung behält ihren aktuellen Live- oder Entwurfsstatus.

Wenn jemand den Connector bearbeitet hat, während der Vorschlag aussteht, zeigt die Karte „Diese Änderung basiert auf einer veralteten Version“ und das Anwenden fragt „Über neuere Änderungen anwenden?“. Die neueren Bearbeitungen werden nur überschrieben, wenn Sie auf Trotzdem anwenden klicken.

Schritt 6: Nach dem Anwenden

Eine Meldung „Änderungen erfolgreich angewendet“ erscheint, und der Chat protokolliert „Sie haben 1 Änderung angewendet“ mit dem Connector als Veröffentlicht oder Entwurf markiert. Klicken Sie auf den Connector-Namen, um die Einstellungsseite zu öffnen. Jede angewendete Änderung erscheint auch im Aktivitätsprotokoll der Teammitglieder als „Operator-Vorschlag angewendet“.

Eine veröffentlichte Änderung funktioniert wie jeder manuell erstellte Connector, und Fin verwendet sie sofort in Gesprächen. Ein Entwurf hat keine Auswirkungen auf Gespräche, bis er veröffentlicht wird. Kunden sehen Operator oder seine Vorschläge nie.

Was Operator einrichten kann

Name und Beschreibung — Teammitglieder sehen die Beschreibung in den Connector-Einstellungen.
Die Anfrage — URL, Methode, Header und Body. Die URL muss HTTPS sein.
Dateneingaben — Die Werte, die Fin vom Kunden sammelt, wie eine Bestellnummer. Jede Eingabe hat einen Namen, Typ und Beschreibung, ist als erforderlich oder optional markiert und kann einen Standardwert haben.
Authentifizierungstoken — Operator kann vorhandene Token anhängen oder entfernen. Jeder Token wird als eigener Header gesendet.
Antwortfelder — Basieren auf einer Testantwort oder einer Mock-Antwort. Sie bestimmen, welche Felder Fin sieht, wie sie heißen, ihr Format und wie codierte Werte in Wörter übersetzt werden. Ein Python-Codeblock kann stattdessen die Antwort umformen.
Eine Mock-Antwort — Ein Beispiel-Antwort-Body, der verwendet wird, um die Antwortfelder zu erstellen, bevor die API getestet werden kann.
Objektzuordnungen — Schreiben Sie Antwortwerte in Gesprächs-, Benutzer- oder benutzerdefinierte Objektattribute.
Wie Fin es verwendet — Ob Fin den Connector selbst auswählen kann, die Eingabeaufforderung, die Fin liest, um zu entscheiden, wann er verwendet wird, ob Fin darüber schreiben kann, und ein Publikum, das aus Segmenten erstellt wird.
Kundenverifizierung — Ob Fin den Connector nur für Kunden aufruft, die eine Identitätsprüfung bestanden haben.

Tipp: Operator fügt Intercom-Attribute, wie die E-Mail des Kunden, direkt in die Anfrage ein, anstatt sie als Dateneingaben hinzuzufügen. Das ist die empfohlene Einrichtung. Jede Dateneingabe, die Operator hinzufügt, ist ein Wert, den Fin vom Kunden sammelt.

Bekannte Einschränkungen

Operator-Credits — Operator-Chats verwenden Operator-Credits wie jede andere Operator-Arbeit.
Sie wenden jede Änderung an — Operator kann einen Connector nicht selbst veröffentlichen, speichern oder löschen.
Tests senden echte Anfragen — Wenn ein Connector Daten erstellt, aktualisiert oder löscht, bewirkt der Test diese Änderung im verbundenen System. Verwenden Sie Testdatensätze.
Token — Operator kann die Werte von Authentifizierungstoken nicht sehen und kann Token nicht erstellen, bearbeiten oder löschen. Fügen Sie einen neuen Token in den Authentifizierungseinstellungen hinzu und bitten Sie dann Operator, ihn anzuhängen. Bewahren Sie API-Schlüssel in Tokens auf, nicht in der URL oder im Body, wo Operator sie lesen kann.
Anwenden ersetzt unveröffentlichte Entwurfsänderungen — Operator baut seine Änderung auf der Live-Version auf. Das Anwenden, egal ob mit Veröffentlichen oder Als Entwurf speichern, ersetzt alle seitdem im Editor vorgenommenen Entwurfsänderungen. Veröffentlichen oder verwerfen Sie zuerst Ihre eigenen Entwurfsänderungen.
Live-Connectoren können nicht gelöscht werden — Operator kann nur Entwurfs- oder pausierte Connectoren löschen. Um einen Live-Connector zu löschen, pausieren Sie ihn zuerst in seinen Einstellungen. Operator kann Connectoren nicht pausieren, fortsetzen, duplizieren, archivieren oder auf eine frühere Version zurücksetzen.
MCP-Connectoren — Operator kann Connectoren, die von einem MCP-Server stammen, nicht bearbeiten, testen oder löschen. Verwalten Sie diese in den Einstellungen des MCP-Servers.
Keine Vorlagen — Operator kann keinen Connector aus einer Vorlage installieren.
Eingabetypen — Operator kann keine statischen Eingabewerte oder Listen- und Objekt-Eingabetypen hinzufügen.
Releases — Connector-Änderungen von Operator werden direkt auf den Connector angewendet. Sie können nicht zu einem Fin Release hinzugefügt werden.
Fin-Vorschau — Wenn Operator Fin eine Testfrage stellt, verwendet Fin die gespeicherte Testantwort oder Mock, anstatt die API aufzurufen. Ausstehende Löschungen werden nicht in der Vorschau angezeigt, und eine Änderung ohne Testantwort oder Mock hat nichts zurückzugeben.

Wenn ein Connector nach der Veröffentlichung in Gesprächen fehlschlägt, siehe Verstehen von Data Connector-Fehlern.

FAQs

Warum ist die Schaltfläche Veröffentlichen deaktiviert?

Es gibt keinen bestandenen Test in der neuesten Version der Änderung. Das Ändern von URL, Methode, Headern, Body, Eingaben oder Authentifizierungstoken löscht einen früheren Test. Bitten Sie Operator, einen Test durchzuführen, oder verwenden Sie eine Mock-Antwort. Als Entwurf speichern funktioniert immer.

Warum schlägt ein Test mit 401 fehl, obwohl der Connector in Gesprächen funktioniert?

Tests tragen keine Endbenutzer-Identität, daher können Connectoren, die prüfen, wer der Kunde ist, einen Test nicht bestehen. Tokens vom Typ USER senden stattdessen ihren statischen Testwert.

Was kann Operator in meinem Connector sehen?

Operator sieht niemals die Werte von Authentifizierungstoken. Es sieht die URL, den Body und den Codeblock vollständig, genauso wie es der Developer Hub Ihnen zeigt, und nur die ersten vier Zeichen von Header-Werten. In Testantworten wird jeder Token oder jede Anmeldeinformation, die die API zurückgibt, maskiert.

Data Connectors mit Operator erstellen und reparieren