Google Drive-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Google Drive mit Gemini Enterprise verbinden. Über diese Verbindung kann Gemini Enterprise Informationen direkt aus Google Drive abrufen. Da keine Daten in den Gemini Enterprise-Index kopiert werden, müssen Sie sich nicht um den Datenspeicher kümmern.

Hinweis

So bereiten Sie Ihre Google Drive-Umgebung vor, bevor Sie den Datenspeicher erstellen:

  • Sie müssen in der Google Cloud Console mit demselben Konto angemeldet sein, das Sie für die Google Drive-Instanz verwenden, die Sie verbinden möchten. Gemini Enterprise verwendet Ihre Google Workspace-Kunden-ID, um eine Verbindung zu Google Drive herzustellen. Private Google-Konten (Nutzerkonten, die auf @gmail.com enden) haben keine Kundennummer und werden nicht unterstützt.

  • Wenn Sie die Zugriffssteuerung für Datenquellen erzwingen und Daten in Gemini Enterprise schützen möchten, müssen Sie Ihren Identitätsanbieter konfigurieren.

  • Achten Sie darauf, dass die Dokumente zugänglich sind, indem Sie diese entweder in einer geteilten Ablage platzieren, die der Domain gehört, oder die Inhaberschaft einem Nutzer in der Domain zuweisen.

  • Gemini Enterprise-Zugriff in Google Workspace aktivieren: In derGoogle Admin-Konsole muss ein Google Workspace-Administrator für die Organisation, in der sich Ihre Nutzer und Google Drive-Daten befinden, die Option Gemini Enterprise den Zugriff auf Google Workspace-Daten erlauben aktivieren. Wenn diese Einstellung deaktiviert ist, werden bei Google Drive-Suchen keine Ergebnisse in der Gemini Enterprise-Web-App zurückgegeben. In der API kann ein 403 Permission Denied: Workspace access for Agentspace disabled by organization admin.-Fehler zurückgegeben werden. Eine Anleitung finden Sie unter Zugriff von Gemini Enterprise auf Google Workspace-Daten verwalten.

  • Smarte Funktionen aktivieren: Aktivieren Sie in Ihrem Google Workspace-Konto sowohl Smarte Funktionen in Google Workspace als auch Smarte Funktionen in anderenGoogle -Produkten. Weitere Informationen finden Sie im Hilfeartikel Smarte Funktionen in Google Workspace aktivieren/deaktivieren.

  • Fügen Sie die OAuth-App Ihrer Zulassungsliste hinzu: Der Google Drive-Datenspeicher verwendet eine von Googleverwaltete OAuth-App, um auf Ihre Daten zuzugreifen. Wenn Ihre Organisation den Zugriff auf OAuth-Apps einschränkt, muss Ihr Google Workspace-Administrator diese App auf die Zulassungsliste Ihrer Organisation setzen. Weitere Informationen finden Sie unter Von Googleverwaltete OAuth-App auf die Zulassungsliste setzen.

  • Organisationsübergreifenden Zugriff konfigurieren (falls zutreffend): Standardmäßig können Nutzer mit Gemini Enterprise nur dann in einem Google Drive-Datenspeicher suchen, wenn die Google Workspace-Kundennummer des Nutzers mit der Organisation des Google Drive-Datenspeichers und des Google Cloud -Projekts übereinstimmt. Wenn Ihre Nutzer oder Google Drive-Daten zu einer anderen Google Workspace-Organisation gehören (z. B. wenn sich Ihr Google Cloud -Projekt in einer Domain befindet und sich Nutzer über eine oder mehrere separate Google Workspace-Domains oder Testmandanten anmelden), führen Sie die folgenden Schritte aus:

    1. Wenden Sie sich an den Cloud Customer Care, um die Kundennummer der Google Workspace-Organisation jedes Nutzers (z. B. C01234567) der Zulassungsliste für Ihr Google Cloud Projekt hinzuzufügen.
    2. Ein Google Workspace-Administrator in jeder Google Workspace-Organisation muss in der Google Admin-Konsole der jeweiligen Organisation die Option Gemini Enterprise den Zugriff auf Google Workspace-Daten erlauben aktivieren. Es reicht nicht aus, diese Einstellung nur in der Organisation des Projekts Google Cloud zu aktivieren. Weitere Informationen finden Sie unter Zugriff von Gemini Enterprise auf Google Workspace-Daten steuern.

    Wenn Nutzer Dokumente finden müssen, die sich außerhalb ihrer eigenen Organisation befinden, aktivieren Sie außerdem Domainübergreifende Dokumente einbeziehen für Ihre App. Sie können diese Option auswählen, wenn Sie die App erstellen, oder sie später unter Web-App-Funktionen verwalten aktivieren.

Google Drive-Datenspeicher erstellen

So erstellen Sie den Google Drive-Datenspeicher:

  1. Rufen Sie in der Google Google Cloud Console die Seite Gemini Enterprise auf.

    Gemini Enterprise

  2. Projekt auswählen oder erstellen Google Cloud .

  3. Klicken Sie im Navigationsmenü auf Datenspeicher.

  4. Klicken Sie auf Datenspeicher erstellen.

  5. Suchen Sie im Abschnitt Quelle nach Google Drive und klicken Sie auf Auswählen.

  6. Optional: Konfigurieren Sie im Abschnitt Daten Filter, um festzulegen, welche Google Drive-Inhalte im Datenspeicher durchsucht werden. Wählen Sie eine der folgenden Optionen aus, um Filter mit der Google Cloud Console oder der REST API zu konfigurieren:

    Console

    1. Geben Sie im Feld IDs der geteilten Ablage, im Feld Ordner-IDs oder in beiden Feldern die IDs ein, nach denen Sie filtern möchten.
    2. Wählen Sie für jedes Feld Einschließen aus, um nur die angegebenen IDs zu durchsuchen, oder Ausschließen, um sie von der Suche auszuschließen. Konfigurieren Sie für jedes Feld entweder den Modus Einschließen oder Ausschließen, aber nicht beide.
    3. Wenn Sie die ID eines Ordners oder einer geteilten Ablage finden möchten, öffnen Sie den Ordner oder die geteilte Ablage in Google Drive und kopieren Sie die ID aus der URL. Die URL hat folgendes Format: https://drive.google.com/drive/folders/ID. Beispiel: https://drive.google.com/drive/folders/123456789012345678901.

    REST API

    Rufen Sie die Methode setUpDataConnector auf, um einen Datenspeicher mit Filtern zu erstellen.

    Einschlusslisten werden unter admin_filter und Ausschlusslisten unter admin_exclusion_filter festgelegt. Füllen Sie für jeden Filtertyp die Liste unter admin_filter oder unter admin_exclusion_filter aus, aber nicht beide.

       curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
           "collectionId": "COLLECTION_ID",
           "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
           "dataConnector": {
             "dataSource": "google_drive",
             "params": {
               "FILTER_TYPE": {
                 "FILTER_KEY": [
                   "FILTER_VALUE_1",
                   "FILTER_VALUE_2"
                 ]
               }
             },
             "entities": [
               {
                 "entityName": "google_drive"
               }
             ],
             "connectorModes": [
               "FEDERATED"
             ]
           }
       }'
       

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die Projekt-ID.
    • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  7. LOCATION: der multiregionale Standort Ihres Datenspeichers: global oder us
  8. COLLECTION_ID: die eindeutige ID des Datenspeichers.
  9. COLLECTION_DISPLAY_NAME: Der Anzeigename des Datenspeichers.
  10. FILTER_TYPE: der Filtertyp, entweder admin_filter für den Einschluss oder admin_exclusion_filter für den Ausschluss. Füllen Sie die Liste unter admin_filter oder unter admin_exclusion_filter aus, aber nicht unter beiden.
  11. FILTER_KEY: die Drive-Entität, nach der gefiltert werden soll, entweder SharedDriveIds oder FolderIds.
  12. FILTER_VALUE_1, FILTER_VALUE_2: Die IDs der geteilten Ablagen oder Ordner, nach denen gefiltert werden soll.