Verwenden Sie diesen Artikel, um Datenconnector-Protokolle zu lesen und zu interpretieren, die Ursache von Connector-Fehlern zu identifizieren und die richtigen Schritte zur Behebung zu unternehmen. Dieser Artikel richtet sich an Teammitglieder, die mindestens einen Datenconnector eingerichtet haben und diagnostizieren müssen, warum dieser fehlschlägt.
So greifen Sie auf Datenconnector-Protokolle zu
Datenconnector-Protokolle zeigen eine Historie jeder Anfrage, die der Connector gestellt hat. Um die Protokolle für einen Connector zu öffnen, gehen Sie zu Einstellungen > Integrationen > Datenconnectoren, wählen Sie einen Connector aus und öffnen Sie dann den Protokolle-Tab.
So finden Sie Protokolle für ein bestimmtes Gespräch
Um zu sehen, welche Datenconnectoren während eines bestimmten Gesprächs ausgeführt wurden (und ob welche fehlgeschlagen sind), öffnen Sie das Gespräch im Inbox und aktivieren Sie die Ereignisverlaufsansicht in der Gesprächs-Timeline. Fehlgeschlagene Datenconnector-Ausführungen werden rot hervorgehoben.
So lesen Sie Protokolle
Der Protokollbereich hat drei Hauptkomponenten. Wählen Sie eine beliebige Anfrage in der Liste aus, um das Detailfenster zu öffnen:
Filter: Sie können die Protokolle nach verschiedenen Werten und Zeiträumen filtern.
Liste der Anfragen: Jeder Eintrag zeigt Datum und Uhrzeit, was den Connector ausgelöst hat und ob die Anfrage erfolgreich war oder fehlgeschlagen ist.
Anfragedetails: Zeigt eine Aufschlüsselung jeder Phase, die die Anfrage durchlaufen hat, und in welcher Phase sie fehlgeschlagen ist.
Filter
Verwenden Sie den Datumsbereich-Auswähler, um Protokolle nach einem bestimmten Zeitraum zu filtern.
Sie können auch nach einem der folgenden Werte filtern:
Ausführungs-ID: Eine eindeutige Kennung für jede Connector-Anfrage. Unser Support-Team kann diese bei der Fehlerdiagnose anfordern.
Gesprächs-ID
Status (Erfolg/Fehler)
Fehlertyp:
Fehler in der Anfragekonfiguration: Der Connector ist falsch eingerichtet – zum Beispiel fehlt die URL oder ein erforderliches Feld ist falsch – sodass Fin den Aufruf nicht einmal versuchen konnte.
Faraday-Fehler: Ein Netzwerkverbindungsfehler – Fin konnte den externen Dienst überhaupt nicht erreichen. Dies wird typischerweise durch ein Timeout, DNS-Ausfall oder einen nicht erreichbaren Server verursacht. Prüfen Sie, ob der externe Dienst online ist und die Connector-URL korrekt ist.
3rd party API (application programming interface) error: Fin hat den externen Dienst erfolgreich erreicht, aber der Dienst hat als Antwort einen Fehler zurückgegeben – zum Beispiel wurde die Anfrage abgelehnt oder der Dienst war vorübergehend nicht verfügbar. Kontaktieren Sie den externen Dienstanbieter und teilen Sie die Fehlermeldung zur Untersuchung mit.
Fehler bei der Antwortzuordnung: Der externe Dienst hat erfolgreich geantwortet, aber Fin konnte die Daten aus der Antwort nicht wie erwartet lesen oder extrahieren.
Token-Aktualisierungsfehler: Das OAuth (Open Authorization)-Token, das zur Authentifizierung beim externen Dienst verwendet wird, ist abgelaufen, und der automatische Erneuerungsversuch ist fehlgeschlagen. Verwenden Sie die Reauthenticate-Schaltfläche in den Connector-Einstellungen, um den Zugriff wiederherzustellen.
Fehler bei der Anforderungsvalidierung: Die Daten, die Fin senden wollte, wurden überprüft und als ungültig oder unvollständig befunden, bevor die Anfrage überhaupt gestellt wurde.
Fehler bei der Codeblock-Transformation: Ein benutzerdefinierter Code-Snippet, den der Connector verwendet, um Daten vor dem Senden oder nach dem Empfangen neu zu formatieren, ist abgestürzt oder hat ein unerwartetes Ergebnis geliefert.
Ausgeführt in:
Fin: Der Connector wurde von Fin AI ausgelöst, während es ein Kundengespräch bearbeitete.
Procedure: Der Connector wurde durch eine Procedure ausgelöst – eine strukturierte Aufgabe oder ein Workflow, dem Fin Schritt für Schritt folgt.
Inbox: Der Connector wurde manuell von einem Teammitglied direkt aus einem Gespräch im inbox ausgelöst.
Inbox Automation Rule: Der Connector wurde automatisch durch eine Regel ausgelöst, die Aktionen ausführt, wenn bestimmte Bedingungen im inbox erfüllt sind.
Custom Bot: Der Connector wurde durch einen Bot-Flow ausgelöst, der im Workflows-Builder erstellt wurde, um Gespräche zu automatisieren.
Resolution Bot: Der Connector wurde durch den älteren Resolution Bot ausgelöst, während er versuchte, automatisch eine Kundenfrage zu beantworten.
Macros (Saved Reply): Der Connector wurde ausgelöst, als ein Teammitglied eine gespeicherte Antwort (macro) in einem Gespräch verwendete.
Anfragedetails
Die Auswahl einer Anfrage aus der Liste öffnet das Detailfenster. Die folgenden vier Abschnitte decken jede Phase der Datenconnector-Ausführung ab:
Ausführung
Anfrage
Antwort
Antwortverarbeitung
Jeder der vier Abschnitte repräsentiert eine eigene Phase der Datenconnector-Anfrage:
Ausführung umfasst den gesamten Lebenszyklus der Anfrage von Anfang bis Ende. Es zeigt, was den Datenconnector ausgelöst hat – zum Beispiel Fin AI Agent, eine Procedure oder ein Teammitglied im Inbox.
Anfrage ist das, was Fin an das externe System sendet. Wenn hier ein Fehler auftritt, wurde die Anfrage nie gesendet. Dies wird normalerweise durch ein Problem mit der URL, der Anfragedaten oder der Connector-Konfiguration verursacht. Wenn die Ursache unklar ist, wenden Sie sich mit den Ausführungsprotokollen an den Support.
Antwort ist das, was das externe System an Fin zurückgibt. Ein Statuscode von 200 zeigt Erfolg an. Statuscodes im 5XX-Bereich (wie 500 oder 502) weisen auf einen serverseitigen Fehler im externen System hin – teilen Sie die Fehlermeldung mit dem externen Dienstanbieter zur Untersuchung. Statuscodes im 4XX-Bereich weisen auf einen clientseitigen Fehler hin: 404 bedeutet, die angeforderte Ressource wurde nicht gefunden, während 401 und 403 Authentifizierungs- oder Autorisierungsprobleme anzeigen. Im Allgemeinen bedeuten 4XX-Fehler, dass die Anfrage ungültige, unvollständige oder nicht autorisierte Daten gesendet hat.
Antwortverarbeitung ist der Schritt, in dem Fin die in der Datenconnector-Konfiguration festgelegte Antwortzuordnung anwendet. Wenn dieser Schritt fehlschlägt, bedeutet dies meist, dass die API-Antwort eine andere Struktur hat als vom Connector erwartet. Überprüfen Sie die Antwortzuordnung in den Connector-Einstellungen und wenden Sie sich bei anhaltenden Problemen mit den Protokolldetails an den Support.
Warum führt mein Datenconnector erfolgreich aus, aber Fin sagt, es findet nichts?
Ein Datenconnector kann erfolgreich ausgeführt werden – mit einem Statuscode 200 – aber dennoch dazu führen, dass Fin AI Agent sagt, er habe nichts gefunden. Dies passiert meist, wenn die API-Antwortdaten zu groß oder unstrukturiert sind, als dass Fin die relevanten Daten extrahieren könnte. Um dies zu beheben, optimieren Sie die API-Antwort, sodass nur die spezifischen Felder zurückgegeben werden, die Fin benötigt, anstatt ein vollständiges Datenobjekt zu senden. Wenn das Problem nach der Reduzierung der Antwortgröße weiterhin besteht, wenden Sie sich an den Support.
Tipp: Für Probleme mit Datenconnectoren, die innerhalb einer Procedure ausgeführt werden, siehe Fehlerbehebung bei Fin Procedures und Datenconnectoren.