Konnektor-Zugriff hat drei getrennte Ebenen: die Verbindung eines Mitglieds, die Autorisierung eines Agents und die benannten Berechtigungen, die diesem Agent erteilt werden. Einen Dienst zu verbinden erteilt nicht stillschweigend jedem Agent jede Aktion.
Verbindung, Autorisierung und Berechtigung
| Ebene | Was sie steuert |
|---|---|
| Verbindung | Welches Mitgliedskonto oder welche Zugangsdaten für den Dienst verwendet werden dürfen. |
| Agent-Autorisierung | Welcher Agent den verbundenen Dienst nutzen darf. |
| Berechtigungserteilung | Welche benannten Aktionen dieser Agent anfragen darf, und für wie lange. |
Bei Diensten mit Zugangsdaten je Mitglied verbindet jedes Mitglied sein eigenes Konto. Ein geteilter Agent handelt weiterhin über das verbundene Konto und die Erteilungen des Mitglieds, das ihn ausführt; er erbt weder den Posteingang noch das Token noch den privaten Chatverlauf einer Kollegin.
Zugriff erteilen
Wenn ein Agent eine Konnektor-Berechtigung braucht, die er nicht hat, zeigt Okou eine Berechtigungsanfrage. Prüfe Konnektor, Agent, Berechtigungsnamen und Begründung, bevor du Allow oder Deny wählst.
Eine erteilte Berechtigung kann eine der im Produkt angebotenen Laufzeiten haben:
- Allow for 1h
- Allow for 24h
- Allow for 7d
- Allow always
Läuft eine zeitlich begrenzte Erteilung ab, muss der Agent sie erneut anfragen. Eine einzelne Berechtigung abzulehnen trennt nicht das Konto und entfernt keine unabhängigen Berechtigungen.
Den aktuellen Konnektor-Zugriff eines Agents verwaltest du in seinen Autorisierungseinstellungen. Die Konnektor-Zugriffsansicht zeigt, welche Agenten autorisiert sind und ob ihr Berechtigungsstand erlaubt, verweigert oder gemischt ist.
Umgang mit Zugangsdaten
OAuth-Token und manuell eingegebene Geheimnisse werden auf der Plattform gespeichert. Bei Konnektor-Anfragen injiziert die Firewall die Zugangsdaten an der Netzwerkgrenze; das Geheimnis wird dem Agent-Code nicht als Umgebungsvariable offengelegt.
Füge keine API-Keys, OAuth-Token, Passwörter oder Client-Secrets in einen Chat, eine Agent-Anweisung, eine Workflow-Anweisung oder eine angehängte Datei ein. Nutze stattdessen den Verbindungsablauf des Konnektors.
Trennt ein Mitglied seinen Konnektor, entfällt diese Verbindung für künftige Runs. Eine Agent-Autorisierung zu entfernen hindert diesen Agent an der Nutzung des Konnektors, lässt andere autorisierte Agenten aber unberührt.
Grenzen der Freigabe
Die durchsetzbare Grenze ist die benannte Berechtigungserteilung des Konnektors. Verlass dich nicht auf eine allgemeine Aktionskategorie als Garantie, dass jede E-Mail, jeder Post, jede Zahlung, jede Infrastrukturänderung oder jede Löschung immer auf dieselbe Weise anhält.
Für Arbeit, die von Menschen geprüft bleiben muss:
- Erteile nur die Lese- oder Entwurfsberechtigung und verweigere die abschließende Schreib- oder Sendeberechtigung, wo der Konnektor sie getrennt anbietet.
- Halte die Prüfpflicht in der Agent- oder Workflow-Anweisung fest.
- Lass die abschließende Aktion beim Menschen, etwa indem ein Gmail-Entwurf oder ein Änderungsvorschlag erzeugt wird, statt zu senden oder anzuwenden.
Nutze zusätzlich die Kontrollen des vorgelagerten Dienstes: eingeschränkte API-Keys, OAuth-Scopes nach dem Prinzip der geringsten Rechte, Repository-Berechtigungen und getrennte Produktions-Zugangsdaten.
Chats, Protokolle und Admin-Einblick
Mitglieder greifen auf ihre eigenen Chat-Threads zu. Einen Agent oder Workflow zu veröffentlichen veröffentlicht nicht den privaten Chatverlauf oder die Konnektor-Zugangsdaten des Mitglieds. Teile eine Unterhaltung oder ein Artefakt nur über eine ausdrückliche Freigabefunktion.
Workspace-Admins sehen Nutzungsaggregate je Mitglied, die für Abrechnung und Kapazitätsplanung dienen. Das verschafft keinen automatischen Einblick in private Chat-Inhalte anderer Mitglieder.
Innerhalb des eigenen Chats hält die Aktivitätsansicht den sichtbaren Ablauf des Runs fest: Konnektor-Aktivität, Artefakte, Status und Fehler. Nutze sie, um zu prüfen, ob eine angeforderte Konnektor-Aktion ausgeführt wurde und ob sie erfolgreich war.
Prüfliste
- Ist der Konnektor mit dem beabsichtigten Mitgliedskonto verknüpft?
- Ist der beabsichtigte Agent autorisiert?
- Sind nur die für diese Aufgabe nötigen Berechtigungen erlaubt?
- Kann die Erteilung nach 1 Stunde, 24 Stunden oder 7 Tagen ablaufen, statt dauerhaft zu bleiben?
- Hält der Workflow unumkehrbare oder nach außen wirkende Aktionen in einem von Menschen geprüften Schritt?
- Lassen sich die vorgelagerten Zugangsdaten noch weiter einschränken?
Wie es weitergeht
- Siehe Chat dafür, was innerhalb einer Chat-Grenze passiert.
- Siehe Connectors für den Katalog und was jeder Konnektor kann.
- Siehe For teams für die Einrichtung von Berechtigungen auf Org-Ebene.
