Fehlerbehebung bei Verbindungen
Ein Connector, der gestern noch lief und heute scheitert, ist meist über eine von fünf Ursachen gestolpert. Diese Seite ist die Kurzliste, in der Reihenfolge, in der sie auftreten.
Hier anfangen
Abschnitt betitelt „Hier anfangen“Öffne die Connectors des Agenten im Agent Builder. Eine Verbindung, die Aufmerksamkeit braucht, ist dort markiert, und die Lösung ist fast immer, sie erneut zu autorisieren.
Erneutes Autorisieren behält deine Zuweisungen. Verbindest du denselben Dienst mit demselben Konto, wird die bestehende Verbindung neu autorisiert, statt eine zweite anzulegen. Du musst sie danach also nicht jedem Agenten neu zuweisen.
Die fünf Ursachen
Abschnitt betitelt „Die fünf Ursachen“Die Autorisierung ist abgelaufen
Abschnitt betitelt „Die Autorisierung ist abgelaufen“Anbieter lassen den Zugriff nach einer gewissen Zeit ablaufen, manche schnell, manche erst nach Monaten. Die Verbindung wird dann mit dem Hinweis markiert, dass sie neu autorisiert werden muss, und die Tools des Agenten für diesen Dienst funktionieren nicht mehr.
Lösung: Verbinde dich erneut mit demselben Konto.
Der Zugriff wurde beim Anbieter widerrufen
Abschnitt betitelt „Der Zugriff wurde beim Anbieter widerrufen“Jemand hat endue in den Einstellungen des Google-Kontos entfernt, die Slack-App deinstalliert oder das API-Token gelöscht. endue kann das erst beim nächsten Aufrufversuch von einem Ablauf unterscheiden.
Lösung: Autorisiere erneut oder erstelle ein neues Token und verbinde dich neu. War der Widerruf gewollt, entferne die Verbindung auch in endue, damit der Zustand stimmt.
Du hast das falsche Konto verbunden
Abschnitt betitelt „Du hast das falsche Konto verbunden“Der Klassiker: Du warst mit einem privaten Google-Konto angemeldet, als du einen Connector für die Arbeit autorisiert hast. Es gibt keinen Fehler, aber der Agent findet nichts, weil er im falschen Posteingang sucht.
Lösung: Melde dich beim Anbieter vom falschen Konto ab oder nutze ein privates Fenster und verbinde dich erneut mit dem gewünschten Konto. Prüfe, bevor du zustimmst, welches Konto der Zustimmungsbildschirm anzeigt.
Dem Agenten fehlt der Zugriff auf die konkrete Ressource
Abschnitt betitelt „Dem Agenten fehlt der Zugriff auf die konkrete Ressource“Die Verbindung ist in Ordnung, aber die Ressource ist nicht mit ihr geteilt.
| Dienst | Symptom | Lösung |
|---|---|---|
| Slack | „Nicht im Kanal“ beim Lesen des Verlaufs | Lade die App in Slack in diesen Kanal ein |
| Notion | Die Suche findet eine Seite nicht, die du sehen kannst | Teile die Seite in Notion mit der Integration |
| GitLab | Ein Projekt oder Issue wird als nicht gefunden gemeldet | Der Benutzer des Tokens hat eventuell keinen Zugriff. Prüfe die Berechtigungen, nicht die Schreibweise |
| Eine Datei wird nicht gefunden | Das verbundene Konto hat eventuell keinen Zugriff darauf |
Ein selbst gehosteter Dienst ist umgezogen oder nicht erreichbar
Abschnitt betitelt „Ein selbst gehosteter Dienst ist umgezogen oder nicht erreichbar“Connectors, die nach einer Adresse fragen (GitLab, Jenkins, Discourse, WordPress, Mattermost, Grafana, Elasticsearch), brauchen eine Adresse, die aus dem Internet erreichbar ist.
Lösung: Prüfe, ob die Adresse stimmt und öffentlich erreichbar ist, und verbinde dich dann neu. Ein Dienst hinter einem VPN ist nicht erreichbar.
Wenn der Connector funktioniert und der Agent trotzdem scheitert
Abschnitt betitelt „Wenn der Connector funktioniert und der Agent trotzdem scheitert“- Die Operation gibt es nicht. Jeder Connector bietet einen festen Satz an Operationen, siehe Verfügbare Connectors. Ein Agent kann keinen Teil der API eines Anbieters nutzen, den endue nicht anbietet.
- Die Verbindung ist diesem Agenten nicht zugewiesen. Verbinden geschieht auf Kontoebene, Nutzen pro Agent.
- Die Tool-Gruppe ist ausgeschaltet. Prüfe die integrierten Tools des Agenten, wenn die fehlende Fähigkeit Gedächtnis, Outputs, Routinen oder Webabruf ist und kein Connector.
- Die Aktion wurde an der Schranke für Freigaben abgelehnt, auch automatisch, wenn die Ausführung unbeaufsichtigt lief.
Eine Verbindung entfernen
Abschnitt betitelt „Eine Verbindung entfernen“Entfernst du sie in endue, verlieren alle Agenten, denen sie zugewiesen ist, diese Tools sofort. Bestehende Unterhaltungen behalten ihren Verlauf, aber der Agent kann diese Aufrufe nicht mehr ausführen.
Eine Verbindung in endue zu entfernen, widerruft den Zugriff von endue beim Anbieter nicht. Für einen sauberen Schnitt erledige beides.