Skip to main content

​
Überblick

Das Gmail Toolset ermöglicht Agenten, Nachrichten zu suchen und zu lesen, Anhänge abzurufen, Entwürfe anzulegen sowie E-Mails zu senden oder zu beantworten. Der Gmail Konnektor importiert dagegen Nachrichten für die Suche. Novaplan übernimmt den Großteil der Einrichtung. Diese Schritte sind auch als Referenz für die zuständigen Administratoren gedacht.

​
Einrichtung

  1. Öffnen Sie die Google Cloud Console und erstellen oder wählen Sie ein Projekt.
Google Cloud Projekt für Gmail auswählen
  1. Aktivieren Sie unter APIs & Services → Library die Gmail API.
Gmail API aktivieren
  1. Richten Sie unter APIs & Services → OAuth consent screen die Einwilligungsseite ein. Wählen Sie den passenden Nutzertyp (External oder Internal für Google Workspace) und tragen Sie etwa Novaplan AI Gmail Toolset als App-Namen sowie die zuständigen Kontaktadressen ein.
  2. Prüfen Sie die von der zugänglichen Toolset-Implementierung angeforderten Berechtigungen:
Das zugängliche Toolset erstellt Entwürfe über users.drafts.create. Google akzeptiert dafür gmail.modify, aber auch den engeren Scope gmail.compose. Eine Aktion zum Bearbeiten von Labels ist nicht aufgeführt; Google stuft gmail.modify als „Restricted Scope“ ein. Lassen Sie vor der Freigabe die Scope-Anfrage der bereitgestellten Enterprise-Version und eine mögliche engere Berechtigung für Entwürfe prüfen. Eine Änderung der Scopes erfordert auch einen Test von Implementierung und Einwilligung.
  1. Öffnen Sie in Novaplan AI Workspace Settings → Actions → Gmail → + Setup oder Configure und kopieren Sie die Redirect URI.
Redirect URI für das Gmail Toolset kopieren
  1. Erstellen Sie unter APIs & Services → Credentials eine OAuth client ID für eine Web application und fügen Sie die kopierte URI unter Authorized redirect URIs hinzu. Kopieren Sie anschließend Client ID und Client Secret.
Die Redirect URI muss exakt mit dem Wert aus Ihrem Novaplan AI Workspace übereinstimmen. Verwenden Sie keine Beispieladresse aus einem Screenshot.
  1. Tragen Sie die OAuth-Zugangsdaten in Novaplan AI ein und wählen Sie Authenticate.
OAuth-Zugangsdaten für Gmail eintragen
  1. Melden Sie sich im Google-Fenster an, prüfen Sie die angeforderten Rechte und wählen Sie Allow. Danach sollte das Toolset in Novaplan AI den Status Authenticated anzeigen.
Google-Einwilligungsseite für Gmail

​
Konnektor oder Toolset?

Für eine Suche können Sie einen entsprechend berechtigten Agenten nach Absender, Betreff oder Stichwort fragen. Für eine neue Nachricht nennen Sie Empfänger, Betreff und Inhalt.