Dokumente
Google Drive
Sucht und liest Dateien von Google Drive (Docs, Sheets, PDF, Office); erstellt Textdateien mit Bestätigung.
- Zugang mit Verbinden (OAuth)
- Aktionen mit Bestätigung
- Synchronisierbare Quelle
- Beachtet Dateiberechtigungen
Tools für den Agenten
Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.
| Tool | Funktion | Typ |
|---|---|---|
search_files | Sucht Dateien nach Name oder Inhalt, auch in einem einzelnen Ordner. | Lesen |
read_file | Text einer Datei: Docs und Slides als Text, Sheets als Tabelle, PDF, Word und Excel extrahiert. | Lesen |
list_folder | Inhalt eines Ordners (auch «Meine Ablage»). | Lesen |
create_text_file | Erstellt eine Textdatei (oder ein Google-Dokument) in einem Ordner. Erfordert Bestätigung. | Mit Bestätigung |
Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option Erstellung von Dateien erlauben (mit Bestätigung) aktiviert; danach zeigt jede Aktion im Chat eine Zusammenfassung und wird erst mit Bestätigen und ausführen ausgeführt.
Einrichtung Schritt für Schritt
Öffnen Sie in Kaiross Integrationen, wählen Sie Google Drive und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- console.cloud.google.com → neues Projekt → APIs & Dienste → Bibliothek → Google Drive API aktivieren.
- OAuth-Zustimmungsbildschirm: Typ Intern (Google Workspace), damit nur Nutzer der Domain autorisieren können.
- Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID → Webanwendung; fügen Sie unter Autorisierte Weiterleitungs-URIs den unten angezeigten Redirect URI ein.
- Kopieren Sie Client ID und Client secret, speichern Sie und klicken Sie auf Verbinden mit dem zu verwendenden Konto. Erforderliche Berechtigungen: Dateien lesen und neue Dateien erstellen.
Felder des Formulars: OAuth-Client-ID.
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Client secret.
Dateiberechtigungen (synchronisierte Quellen): Mit Berechtigungen der Quelle respektieren ist jedes Dokument im Chat nur für Personen sichtbar, die es in Drive öffnen können (Nutzer, Domains, Gruppen, «Jeder mit dem Link»). Keine zusätzlichen Scopes: Die oben genannten genügen.
Google Groups: Die Mitglieder werden über die Admin SDK API gelesen (Scope https://www.googleapis.com/auth/admin.directory.group.member.readonly, Administratorkonto). Der Scope ist standardmässig nicht erforderlich, damit die Zustimmung für normale Nutzer nicht blockiert wird: Falls das Token ihn nicht enthält, bleiben Dokumente, die nur mit einer Gruppe geteilt sind, nicht aufgelöst (nur für Personen sichtbar, die die Knowledge verwalten), und die Quelle weist darauf hin.
Zugang mit «Verbinden» (OAuth)
- Kopieren Sie im Formular der Verbindung den Wert Rücksprungadresse (Redirect URI), die in der OAuth-App registriert werden muss (Symbol Rücksprungadresse kopieren).
- Registrieren Sie die OAuth-App beim Anbieter (Schritte oben) und fügen Sie diese Redirect URI ein.
- Geben Sie in Kaiross Client ID und Client secret ein und klicken Sie auf Speichern und verbinden: Das Fenster des Anbieters öffnet sich, melden Sie sich mit dem gewünschten Konto an und erteilen Sie die Berechtigung.
- Meldet der Test später «Zugang abgelaufen», klicken Sie in der Verbindung auf Neu verbinden.
Erforderliche Berechtigungen (Scopes)
Kaiross verlangt beim Anbieter nur diese Berechtigungen; Schreibaktionen bleiben deaktiviert, bis Sie sie einschalten.
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.file
Gut zu wissen
- Auch als synchronisierte Quelle des Knowledge nutzbar: Agent → Tab Synchronisierung → Quelle hinzufügen. Siehe Synchronisierte Quellen.
- Mit Berechtigungen der Quelle beachten (standardmässig aktiv) ist jedes synchronisierte Dokument im Chat nur für Personen sichtbar, die es im Dienst öffnen können.
Mit einem Agenten verbinden
- Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
- Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
- Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
- Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.
Häufige Fehler
- Konto nicht verbunden oder Zugang abgelaufen
- Die OAuth-Verbindung wurde nie abgeschlossen oder ist nicht mehr gültig: Klicken Sie in der Verbindung auf Verbinden oder Neu verbinden.
- Unzureichende Berechtigungen
- Dem Konto fehlen Scopes: Vergleichen Sie sie mit der Liste oben.
- Zu viele Anfragen
- Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.
Nützliche Links
In den Schritten genannte Konsolen des Anbieters: