Google Workspace

Eine einzige Google-Anmeldung verbindet Drive, Sheets und Docs, 14 Tools zum Lesen, Erstellen und Aktualisieren von Dateien. Gmail und Calendar werden separat verbunden.

Eine einzige Google-Anmeldung verbindet Drive, Sheets und Docs mit deinem Agenten, und beim Verbinden wird ein schreibgeschützter Modus angeboten. Vierzehn Tools lassen ihn deine Dateien lesen und in deinem Namen Tabellen und Dokumente erstellen oder aktualisieren. Gmail und Google Calendar sind separate Verbindungen, beide unten verlinkt.

Verbinden

Öffne Integrationen und wähle Google (Drive · Sheets · Docs).
Melde dich mit Google an und erteile den Zugriff. Um alles schreibgeschützt zu halten, aktiviere die Option read-only, der Agent kann dann lesen, aber niemals etwas erstellen, aktualisieren oder verschieben.
Der Agent kann nun mit deinen Drive, Sheets und Docs arbeiten.

Die eine Stolperfalle, über die viele stolpern: der drive.file-Scope. Zum Schutz deiner Privatsphäre zeigt die Drive-Auflistung immer nur Dateien, die der Agent erstellt hat, sowie Dateien oder Ordner, die du mit dem verbundenen Google-Konto ausdrücklich freigegeben hast, niemals dein gesamtes Drive. Sheets und Docs bleiben kontoweit per Link oder ID erreichbar, daher ist der schnellste Weg, den Agenten an einem vorhandenen Dokument arbeiten zu lassen, seine URL einzufügen (oder die Datei freizugeben). Wenn der Agent eine Tabelle „nicht findet“, von der du weißt, dass sie existiert, liegt es an diesem Scope.

Was der Agent tun kann

Tool	Zugriff	Typ	Funktion
`gdrive_list_files`	Öffentlich sicher	Read	Listet Dateien und Ordner auf, auf die der Agent zugreifen kann, die von ihm erstellten plus alle, die du freigegeben hast; nach Namen filtern oder einen Ordner auflisten.
`gdrive_read_file`	Öffentlich sicher	Read	Liest den Text einer Drive-Datei; native Docs, Sheets und Slides werden als reiner Text oder CSV exportiert.
`gsheets_read`	Öffentlich sicher	Read	Liest Zellwerte aus einem Sheet per URL oder ID, anhand eines Bereichs in A1-Notation.
`gsheets_get_metadata`	Öffentlich sicher	Read	Ruft Titel und Tabs eines Sheets ab, Namen, IDs sowie Zeilen-/Spaltenzahlen.
`gdocs_read`	Öffentlich sicher	Read	Liest den vollständigen Text eines Google Doc per URL oder ID.
`gdrive_create_file`	Nur Inhaber	Write	Erstellt eine reine Textdatei (txt, csv, markdown, html) in Drive, optional in einem Ordner.
`gdrive_create_folder`	Nur Inhaber	Write	Erstellt einen neuen Ordner, optional in einem übergeordneten Ordner.
`gdrive_update_file`	Nur Inhaber	Write	Benennt eine Drive-Datei um, ersetzt ihren Inhalt oder verschiebt sie in einen anderen Ordner.
`gsheets_append_rows`	Nur Inhaber	Write	Hängt Zeilen nach der letzten Datenzeile in einem Sheet-Tab an.
`gsheets_update_cells`	Nur Inhaber	Write	Überschreibt einen bestimmten Zellbereich mit neuen Werten.
`gsheets_create`	Nur Inhaber	Write	Erstellt ein neues Sheet mit einem Titel, optionalen Tabs und optionalen Startzeilen.
`gdocs_create`	Nur Inhaber	Write	Erstellt ein neues Google Doc mit einem Titel und optionalem Anfangstext.
`gdocs_insert_text`	Nur Inhaber	Write	Fügt Text in ein Doc ein, standardmäßig am Ende oder an einer festgelegten Position.
`gdocs_replace_text`	Nur Inhaber	Write	Sucht und ersetzt jedes Vorkommen einer Zeichenfolge in einem Doc.

Public-safe vs owner-only

Die fünf Lese-Tools sind public-safe, ein Agent, der mit einem Website-Besucher spricht, kann sie nutzen, um aus einer freigegebenen Tabelle oder einem Dokument zu antworten. Die neun Schreib-Tools sind owner-only: Sie erscheinen niemals für einen öffentlichen Besucher, und beim Verbinden im read-only-Modus werden alle neun ausgeblendet, sodass der Agent lesen, aber nichts ändern kann.

Praxisbeispiel

Du sagst deinem internen Agenten: „Lies den Leads-Tab in dieser Tabelle [link] und beginne ein Follow-up-Dokument, das die Top fünf zusammenfasst.“ Er ruft gsheets_read für den freigegebenen Link auf, dann gdocs_create, um das Dokument zu erstellen, und gdocs_insert_text, um es zu füllen, eine neue Datei, die in deinem Drive erscheint, erstellt unter deinem Konto.

Grenzen & Ehrlichkeit

Bewusst eng gefasst. Der drive.file-Scope bedeutet, dass der Agent nur erstellte und freigegebene Dateien sieht, nicht dein gesamtes Drive. Das ist ein Feature, kein Fehler.
Das richtige Tool für native Dateien. gdrive_create_file erstellt reine Textdateien; nutze gsheets_create / gdocs_create für echte Sheets und Docs.
KI-Arbeit wird in ABT abgerechnet, wie jede Agenten-Aktivität, siehe Abrechnung & ABT.

Gmail & Calendar (separate Verbindungen)

Gmail wird als E-Mail-Konto über dieselbe Google-Anmeldung verbunden und gibt dem Agenten owner-only E-Mail-Tools. Lesen und Durchsuchen von E-Mails funktionieren im Rahmen des erteilten Scopes.

Calendar ist eine eigene Integration, Verfügbarkeit und Terminbuchung findest du auf der Seite Google Calendar.

Fehlerbehebung

„Meine Datei wird nicht gefunden.“ Sie wurde nicht vom Agenten erstellt und nicht freigegeben. Füge den Link/die ID des Dokuments ein oder gib die Datei/den Ordner für das verbundene Google-Konto frei.
Schreib-Tools fehlen. Die Verbindung ist im read-only-Modus, verbinde ohne diesen Modus neu, um Erstellen/Aktualisieren/Verschieben zu aktivieren.
Das Dokument ist leer geblieben. gdocs_create ohne Text erstellt ein leeres Dokument; bitte um den Inhalt oder ergänze anschließend mit gdocs_insert_text.

FAQ

Kann der Agent mein gesamtes Drive sehen? Nein, nur Dateien, die er erstellt hat, plus solche, die du ausdrücklich freigegeben hast (der drive.file-Scope).

Kann er E-Mails senden? Lesen funktioniert; Senden ist ein eingeschränkter Scope, siehe die Anmerkung oben und E-Mail, bevor du dich darauf verlässt.

Blockiert der schreibgeschützte Modus wirklich alle Schreibvorgänge? Ja, alle neun Schreib-Tools sind ausgeblendet, solange die Verbindung schreibgeschützt ist.

Weiter

Google Calendar, freie Zeitfenster anbieten und Termine buchen
E-Mail, Gmail-Anmeldung, IMAP/SMTP und die E-Mail-Tool-Familie
Agenten-Fähigkeiten, wie Tools an einen Agenten angehängt werden
Integrationen – Übersicht

Auf dieser Seite