Microsoft SharePoint-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Microsoft SharePoint mit Gemini Enterprise verbinden.

Hinweis

Achten Sie vor dem Einrichten der föderierten Microsoft SharePoint-Verbindung auf Folgendes:

  1. Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

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

      IAM aufrufen

    2. Lokalisieren Sie das Nutzerkonto und klicken Sie auf das Symbol Bearbeiten.
    3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu: Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

  2. Registrieren Sie Gemini Enterprise als OAuth 2.0-Anwendung in Microsoft Entra ID und erfassen Sie die folgenden Anmeldedaten:

    • Client-ID

    • Clientschlüssel

    • Mandanten-ID

    • Instanz-URI

  3. Konfigurieren Sie die Microsoft-API-Berechtigungen mit der Einwilligung eines Microsoft SharePoint-Administrators.

Microsoft SharePoint-Datenspeicher erstellen

So erstellen Sie einen Microsoft SharePoint-Datenspeicher:

  1. Rufen Sie in der 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 Bereich Quelle nach Microsoft SharePoint und klicken Sie auf Auswählen.

  6. Im Abschnitt Daten:

    1. Wählen Sie im Abschnitt Connector-Modus als Verbindungsmodus Föderierte Suche oder Datenaufnahme aus.

    2. Klicken Sie auf Weiter.

    3. Konfigurieren Sie im Abschnitt Authentifizierungseinstellungen die Authentifizierung entsprechend dem ausgewählten Verbindungsmodus.

      1. Geben Sie die folgenden Authentifizierungsdetails an, falls erforderlich:
        • Client-ID: Die eindeutige Kennung der Anwendung, die in der Microsoft Entra ID Ihrer Organisation registriert ist.
        • Clientschlüssel: Der geheime Schlüssel, der während der Registrierung der OAuth 2.0-Anwendung in Microsoft Entra ID generiert wurde.
        • Mandanten-ID: Die eindeutige Kennung für Ihre Organisation im Microsoft Entra Admin Center.
        • Instanz-URI: Die Basis-URL für Ihre Microsoft SharePoint-Instanz (z. B. https://{your-domain}.sharepoint.com).

        Weitere Informationen finden Sie unter Client-Anmeldedaten abrufen.

      • Wenn Sie die Datenaufnahme mit der Authentifizierungsmethode Föderierte Anmeldedaten gewählt haben, kopieren Sie die Subjekt-ID und verwenden diese, um föderierte Anmeldedaten für die Datenerfassung hinzuzufügen.

        • Subjekt-ID: Die eindeutige ID des Dienstkontos, das Sie verwenden möchten.

      • Wenn Sie Föderierte Suche ausgewählt haben, klicken Sie auf Anmelden und schließen die Anmeldung bei einem Drittanbieter ab.

    4. Klicken Sie auf Weiter.

    5. Wenn Sie Föderierte Suche ausgewählt haben, wird der Bereich Ziele angezeigt. Geben Sie die Basis-URL der Website ein.

    6. Klicken Sie auf Weiter.

    7. Wenn Sie Föderierte Suche ausgewählt haben, können Sie im Bereich Erweiterte Optionen den Suchbereich optimieren, indem Sie angeben, welche Microsoft SharePoint-Websites oder bestimmten Pfade in die Ergebnisse einbezogen oder daraus ausgeschlossen werden sollen.

      Sie können dem Datenspeicher Filter über die Google Cloud Console oder die API hinzufügen:

      Console

      Hinweis: Wenn Sie mehrere Websites eingeben, trennen Sie die einzelnen URLs durch ein Komma. Sie können auch eine Liste von URLs direkt aus einer CSV-Datei kopieren und einfügen.

      1. Im Bereich „Websitefilter“:
        • Wählen Sie den Filtertyp aus: In die Suche einbeziehen oder Aus der Suche ausschließen.
        • Geben Sie im Feld Filter für Website-URLs die genauen Microsoft SharePoint-Website-URLs ein, die gefiltert werden sollen, im Format https://{your-tenant}.sharepoint.com/sites/{your-site-name}.

          Hinweis:Geben Sie die genauen Website-URLs ein. Unterpfade, Ordner oder Dokumentbibliotheken werden in diesem Feld nicht unterstützt.

      2. Im Abschnitt „Pfadfilter“:
        • Wählen Sie den Filtertyp aus: In die Suche einbeziehen oder Aus der Suche ausschließen.
        • Geben Sie im Feld Pfadfilter die vollständigen SharePoint-Pfade ein.

          Hinweis: Dieses Feld unterstützt Unterpfade, Ordner und Dokumentbibliotheken im Format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Alle Inhalte unter dem angegebenen Pfad werden gefiltert.

      REST

      Rufen Sie die Methode setUpDataConnector auf, um beim Erstellen eines Datenspeichers Filter hinzuzufügen.

      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": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "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.
    8. LOCATION: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.
    9. COLLECTION_ID: die eindeutige ID des Datenspeichers.
    10. COLLECTION_DISPLAY_NAME: Der Anzeigename des Datenspeichers.
    11. CLIENT_ID: Die Client-ID für die SharePoint-Authentifizierung.
    12. CLIENT_SECRET: Der Clientschlüssel für die SharePoint-Authentifizierung.
    13. INSTANCE_URI: Der Instanz-URI für SharePoint.
    14. TENANT_ID: die Mandanten-ID für SharePoint.
    15. FILTER_TYPE: Der Typ des Filters, der Ihren Microsoft SharePoint-Datenspeichern hinzugefügt wurde. Weitere Informationen finden Sie unter Filtertypen.
    16. FILTER_KEY: Der Schlüssel für den Filter, der einem Feld in Ihren Daten entspricht. Weitere Informationen finden Sie unter Filterschlüssel.
    17. FILTER_VALUES: Der Wert oder die Werte, nach denen für den angegebenen FILTER_KEY gefiltert werden soll.