Google-Agent

Ü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

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

Google Cloud OAuth-Konfiguration

Erforderliche APIs

Aktivieren Sie in der Google Cloud Console die folgenden APIs für Ihr Projekt:

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:

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