> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/fur-administratoren/agenten/google-agent.md). # Google-Agent
Titelbild
Übersicht
  • E-Mails, Kalenderereignisse und Drive-Dateien aus Google über Blockbrain suchen und abrufen
  • Gmail-Nachrichten direkt in Blockbrain verfassen, senden, als Entwurf speichern, lesen und organisieren
  • Google-Kalenderereignisse erstellen, lesen, aktualisieren und löschen, einschließlich Verfügbarkeits- und Frei/Gebucht-Prüfungen
  • Google-Drive-Dokumente für Berichte oder KI-Analysen suchen, abrufen und zusammenfassen (nur lesend)
  • E-Mail- und Kalender-Workflows mit Google-Workspace-Daten automatisieren
/files/8e2d91078527b6e8c217ab72731c4498aed2fe68
Voraussetzungen
  • Schließen Sie die allgemeinen Einrichtungsschritte von der Hauptseite der AI Agents
  • Stellen Sie sicher, dass Benutzer aktive Google-Workspace- (oder Google-)Konten mit aktiviertem Gmail, Kalender und Drive haben
/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032
#### Google Cloud OAuth-Konfiguration **Erforderliche APIs** Aktivieren Sie in der Google Cloud Console die folgenden APIs für Ihr Projekt: | API | Verwendet für | | ------------------- | ---------------------------------------------- | | Gmail API | E-Mail-Suche, Lesen, Senden, Entwürfe, Labels | | Google Calendar API | Kalender- und Ereignisverwaltung, Frei/Gebucht | | Google Drive API | Dateisuche und -download (nur lesend) | **Google Cloud OAuth-Konfiguration** > **Empfohlen: Verwenden Sie eine „interne“ App (Google Workspace).** > > Mehrere der Scopes, die der Google Agent verwendet, werden von Google als **eingeschränkt** (Gmail und Drive) oder **sensibel** (Kalender). Für eine **externe** App lösen diese Scopes die OAuth-Verifizierung von Google aus *und* eine jährliche, kostenpflichtige Sicherheitsbewertung durch einen von Google zugelassenen Dritten (CASA); bis zur Verifizierung ist die App außerdem begrenzt auf **100 Benutzer für die gesamte Laufzeit des Projekts** (dieses Limit kann nicht zurückgesetzt werden). > > Apps, die als **intern** — im Besitz der eigenen Google-Workspace-Organisation des Kunden und auf Benutzer in dieser Organisation beschränkt — sind **vollständig von der Verifizierung, der CASA-Sicherheitsbewertung und dem 100-Benutzer-Limit ausgenommen**. **Erforderliche OAuth-Scopes** Fügen Sie die folgenden Google-OAuth-Scopes Ihrer OAuth-Zustimmungsseite hinzu, gruppiert nach dem Dienst, den sie aktivieren: | Dienst | Scope | Typ | Beschreibung | | --------------- | --------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------- | | Gmail | `https://www.googleapis.com/auth/userinfo.email` | Delegiert | Die E-Mail-Adresse des Benutzers anzeigen (Anmeldung / Identität) | | Gmail | `https://www.googleapis.com/auth/gmail.compose` | Delegiert | Nachrichten verfassen und senden sowie Entwürfe erstellen und verwalten | | Gmail | `https://www.googleapis.com/auth/gmail.readonly` | Delegiert | Nachrichten, Threads, Labels und Anhänge lesen und durchsuchen | | Google Calendar | `https://www.googleapis.com/auth/calendar` | Delegiert | Vollständiger Lese-/Schreibzugriff auf Kalender und Ereignisse, einschließlich Frei/Gebucht | | Google Drive | `https://www.googleapis.com/auth/drive.readonly` | Delegiert | Drive-Dateien und -Inhalte lesen und herunterladen | | Google Drive | `https://www.googleapis.com/auth/drive.metadata.readonly` | Delegiert | Drive-Dateimetadaten (Namen, Besitzer, Typen, Daten) für die Suche lesen | > **Hinweise** > > * Der Google Agent liest nur aus Google Drive (Suche und Download), daher sind die Drive-Scopes per Design nur lesend. > * Der Gmail-Zugriff ist aufgeteilt in `gmail.readonly` (Lesen und Suchen) und `gmail.compose` (Verfassen, Senden und Verwalten von Entwürfen). > * `userinfo.email` um den angemeldeten Benutzer zu identifizieren und muss auf der Zustimmungsseite nur einmal hinzugefügt werden. > * Der Offline-Zugriff (Refresh-Token) wird vom OAuth-Broker von Blockbrain (Nango) über `access_type=offline` — es gibt keinen separaten „offline“-Scope, der hinzugefügt werden muss. **Schritte zur Scope-Konfiguration** 1. Gehen Sie in der Google Cloud Console zu **APIs & Dienste** > **Aktivierte APIs & Dienste** und aktivieren Sie die Gmail-, Google Calendar- und Google Drive-APIs. 2. Gehen Sie zu **APIs & Dienste** > **OAuth-Zustimmungsseite** und konfigurieren Sie die Zustimmungsseite (Intern für einen einzelnen Workspace oder Extern je nach Bedarf). 3. Unter **Scopes**, klicken Sie auf **Scopes hinzufügen oder entfernen** und fügen Sie jeden oben aufgeführten erforderlichen Scope hinzu. 4. Gehen Sie zu **APIs & Dienste** > **Anmeldedaten** > **Anmeldedaten erstellen** > **OAuth-Client-ID**, wählen Sie **Webanwendung**, und erstellen Sie den Client. 5. Notieren Sie sich die **Client-ID** und **Client Secret** — Sie geben diese in Blockbrain ein. ### Google-Agent-Konfiguration in Blockbrain #### Gmail * Scopes (in der App) * `https://www.googleapis.com/auth/userinfo.email` * `https://www.googleapis.com/auth/gmail.compose` * `https://www.googleapis.com/auth/gmail.readonly`
#### GCalender Scopes (in der App) * `https://www.googleapis.com/auth/calendar`
#### GDrive Scopes (in der App) * `https://www.googleapis.com/auth/drive.readonly` * `https://www.googleapis.com/auth/drive.metadata.readonly`
#### Konfigurationsschritte 1. **Agent-Einstellungen aufrufen**: * Navigieren Sie zu Ihrem Blockbrain-Admin-Panel * Gehen Sie zu **Agenten** > **Gmail-/Google-Calendar-/Google-Drive-Agent** * Klicken Sie auf **"Installieren"** 2. **Google-Anmeldedaten eingeben**: * **Client-ID**: Geben Sie die Client-ID aus Ihrem Google-OAuth-Client ein * **Client Secret**: Fügen Sie den von Ihnen generierten Client Secret ein 3. **OAuth-Scopes konfigurieren**: * Fügen Sie jeden erforderlichen Scope einzeln mit der **"Hinzufügen"** Schaltfläche hinzu, wie oben aufgeführt * Jeder Scope erscheint als entfernbares Tag mit visuellen Indikatoren * Verwenden Sie die **"X"** Schaltfläche, um falsche Scopes zu entfernen 4. **Konfiguration speichern**: * Klicken Sie auf **"Speichern"** um alle Einstellungen anzuwenden #### Häufige Anwendungsfälle für Google-Integrationen **E-Mail-Verwaltung** * **Automatisierte Antworten**: KI-gestützte E-Mail-Antworten und Entwürfe * **E-Mail-Analyse**: Inhaltsanalyse und Zusammenfassung * **Suche & Abruf**: Bestimmte E-Mails finden und zusammenfassen **Kalender-Integration** * **Terminplanung**: KI-gestützte Besprechungskoordination mit Erkennung von Überschneidungen * **Ereigniserstellung**: Automatische Erstellung von Kalenderereignissen mit sinnvollen Standarddauern * **Verfügbarkeitsanalyse**: Frei/Gebucht-Abfragen, um freie Zeitfenster vorzuschlagen **Dokumentenverwaltung** * **Dateisuche**: Dokumente nach Name, Inhalt, Typ, Besitzer oder Datum finden * **Inhaltsanalyse**: Aus abgerufenen Dokumenten zusammenfassen und Schlüsselpunkte extrahieren * **Querverweise**: Informationen über verwandte Dateien hinweg für Berichte verknüpfen #### Fehlerbehebung **E-Mail-Berechtigungsfehler** **Problem**: E-Mails können nicht gesendet oder gelesen werden * **Lösung**: Bestätigen Sie beide `gmail.readonly` (Lesen/Suche) und `gmail.compose` (Senden und Entwürfe) dass die Scopes gewährt wurden * **Prüfen**: Prüfen Sie, ob der Benutzer ein aktives Gmail-Postfach hat und die Gmail API aktiviert ist * **Validieren**: Testen Sie mit einem anderen Benutzerkonto, um Berechtigungsprobleme einzugrenzen **Probleme beim Kalenderzugriff** **Problem**: Kalenderereignisse nicht zugänglich * **Lösung**: Stellen Sie sicher, dass der `https://www.googleapis.com/auth/calendar` Scope korrekt konfiguriert ist * **Prüfen**: Prüfen Sie, ob der Benutzer Kalenderzugriff hat und die Google Calendar API aktiviert ist * **Testen**: Versuchen Sie, Kalender aufzulisten, um den Lesezugriff vor Schreibtests zu bestätigen **Probleme beim Drive-Zugriff** **Problem**: Dokumente nicht gefunden oder nicht herunterladbar * **Lösung**: Stellen Sie sicher, dass der `drive.readonly` und `drive.metadata.readonly` Scopes gewährt wurden und die Google Drive API aktiviert ist * **Prüfen**: Bestätigen Sie, dass die Datei dem verbundenen Benutzer gehört oder mit ihm geteilt wurde * **Hinweis**: Der Agent hat nur lesenden Zugriff auf Drive — er kann suchen und herunterladen, aber keine Dateien erstellen oder bearbeiten #### Sicherheit und Compliance **Datenschutz** * **E-Mail-Sicherheit**: Alle E-Mail-Daten werden gemäß den Sicherheitsrichtlinien von Blockbrain behandelt * **Kalender-Datenschutz**: Der Kalenderzugriff berücksichtigt die Datenschutzeinstellungen und Freigabeberechtigungen des Benutzers * **Dokumentenvertraulichkeit**: Auf Drive-Inhalte wird nur lesend zugegriffen, und sie werden mit angemessenen Vertraulichkeitsmaßnahmen verarbeitet **Compliance-Aspekte** * **DSGVO-Compliance**: Die Verarbeitung von E-Mail-, Kalender- und Dokumentendaten erfolgt gemäß den Anforderungen der DSGVO * **Datenaufbewahrung**: Konfigurieren Sie geeignete Richtlinien zur Datenaufbewahrung für E-Mail- und Kalenderdaten * **Audit-Protokollierung**: Alle Aktivitäten des Google Agenten werden für Compliance-Berichte protokolliert **Zugriffskontrolle** * **Benutzerberechtigungen**: Der Agent übernimmt die Google-Berechtigungen des authentifizierten Benutzers * **Delegierung**: Berücksichtigt die Freigabeberechtigungen von Google Drive und Kalender * **Domänenkontrollen**: Kann über Zugriffskontrollen der Google-Workspace-API und die App-Zulassungsliste gesteuert werden #### Nächste Schritte Nach erfolgreicher Konfiguration des Google Agenten: * **Benutzerschulung**: Bieten Sie Schulungen zu KI-Funktionen für E-Mail, Kalender und Dokumente an * **Integrations-Einrichtung**: Konfigurieren Sie die Integration mit bestehenden Geschäftsabläufen * **Überwachung**: Richten Sie die Überwachung der Agentenleistung und -nutzung ein * **Ergänzende Agenten**: Berücksichtigen Sie den Outlook Agent für Organisationen, die sowohl Google- als auch Microsoft-365-Umgebungen betreiben #### Support und Ressourcen Für Unterstützung bei der Konfiguration des Google Agenten: * **Blockbrain-Support**: Wenden Sie sich an Ihren Customer Success Manager für Hilfe zu bestimmten Funktionen * **Google-Dokumentation**: Lesen Sie die Dokumentation zu den Gmail-, Google Calendar- und Google Drive-APIs für detaillierte Informationen zu den Scopes * **Google Cloud-Fehlerbehebung**: Verwenden Sie die Google Cloud Console und die Audit-Logs des Workspace-Admins für Diagnosezwecke bei der Authentifizierung --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.blockbrain.ai/de/fur-administratoren/agenten/google-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.