Hinweis: Operator ist Teil des Pro-Add-ons. Sie benötigen das Pro-Add-on, um es zu verwenden.

Die Einrichtung eines Data Connectors bedeutet normalerweise, API-Dokumentationen zu lesen und jedes Feld manuell auszufüllen. Mit Operator beschreiben Sie, was Fin abrufen 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 wird als Vorschlag eingereicht. Sie prüfen ihn, genehmigen jeden Testaufruf und entscheiden, ob Sie ihn veröffentlichen oder als Entwurf speichern. Operator kann einen Connector nicht eigenständig ändern oder eine API aufrufen.

Hinweis: Für den Chat mit Operator benötigen Sie die Berechtigung Can access Fin Operator. Um eine Connector-Änderung anzuwenden, benötigen Sie außerdem Can manage Automation settings and inbound Workflows und Can manage data connectors and authentication tokens.

Wenn Sie neu bei Data Connectors sind, beginnen Sie mit Data Connectors für Fin AI Agent hinzufügen.

So erstellen oder reparieren Sie einen Data Connector mit Operator

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 der Nummer abruft.“
„Fin sagt immer, es kann die Bestellung nicht finden. Kannst du den Get Order Connector reparieren?“

Schritt 2: Operator untersucht

Bevor Operator einen Vorschlag macht, kann er in Ihrem Workspace nachsehen:

Durchsuchen Sie Ihre Connectoren und lesen Sie deren vollständige Einrichtung.
Lesen Sie eine gespeicherte Testantwort oder eine Mock-Antwort eines Connectors.
Sehen Sie, welche workflows und Verfahren einen Connector verwenden.
Überprüfen Sie die aktuellen 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.

Der Kopf zeigt den Connector-Namen und ein Abzeichen Neu, Live, Entwurf oder Pausiert. Eine Umbenennung zeigt den alten Namen durchgestrichen.
API zeigt Methode, URL, Dateneingaben, Header, Payload, Test und Authentifizierungstoken.
Daten zeigt die Antwortfelder, Python-Code und Objektzuordnungen.
Fin zeigt den Prompt, den Fin liest, und die Zielgruppe.
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 mit 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 den Vorgang.
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-Chat stellen, so wie ein Kunde es tun würde. Dies zeigt, ob Fin den Connector auswählt und wie es die Antwort verwendet. In der Vorschau antwortet Fin, als ob die ausstehenden Connector-Änderungen bereits angewendet wären, und verwendet die gespeicherte Testantwort oder eine Mock-Antwort, 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 (URL, Methode, Header, Body, Eingaben und Authentifizierungstoken) unverändert lässt, behält den früheren bestandenen Test des Connectors.
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?“. Neuere 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. 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 ihn 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, z. B. 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 Test- oder 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 Beispielantwortkörper, der verwendet wird, um die Antwortfelder vor dem Testen der API zu erstellen.
Objektzuordnungen — Schreiben Sie Antwortwerte in Gesprächs-, Benutzer- oder benutzerdefinierte Objektattribute.
Wie Fin es verwendet — Ob Fin den Connector selbst auswählen kann, den Prompt, den Fin liest, um zu entscheiden, wann er ihn verwendet, ob Fin darüber schreiben kann, und eine Zielgruppe, die 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 Kundenattribute, wie die E-Mail-Adresse 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 keine Token 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 Token auf, nicht in URL oder 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 den 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 Objekttypen 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 eine Mock-Antwort, anstatt die API aufzurufen. Ausstehende Löschungen werden nicht in der Vorschau angezeigt, und eine Änderung ohne Testantwort oder Mock hat nichts zurückzugeben.
Einstellungslink — In der „Sie haben angewendet“-Liste im Chat verlinkt der Connector-Name nicht auf die Einstellungsseite. Öffnen Sie den Connector stattdessen über Ihre Data Connectors-Einstellungen.

FAQs

Warum ist die Schaltfläche Veröffentlichen deaktiviert?

Es gibt keinen bestandenen Test für die neueste 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, keinen Test bestehen. Token des Typs USER senden stattdessen ihren statischen Testwert.

Was kann Operator in meinem Connector sehen?

Operator sieht niemals die Werte von Authentifizierungstoken. Er sieht die URL, den Body und den Codeblock vollständig, genauso wie Ihre Connector-Einstellungen es Ihnen zeigen, 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