Übersicht

Mit dem Microsoft SharePoint-Datenspeicher für Gemini Enterprise können Sie in Ihren Microsoft SharePoint Online-Daten, einschließlich Dokumenten, Listen und Websites, suchen und Aktionen ausführen.

Unterstützte Microsoft SharePoint-Versionen

Der Microsoft SharePoint-Datenspeicher unterstützt die aktuelle Cloud-Version von Microsoft SharePoint Online.

Unterstützte Aktionen

Wenn der Microsoft SharePoint-Datenspeicher aktiviert ist, können Endnutzer in Gemini Enterprise Befehle in natürlicher Sprache verwenden, um die folgenden Aktionen auszuführen.

Aktion Beschreibung
Ordner erstellen Erstellt einen neuen Ordner in einem angegebenen Pfad.
Liste hinzufügen Erstellt eine neue Liste mit strukturierten Daten (z. B. Aufgaben, Kontakte) auf der Microsoft SharePoint-Website.
Dokument hochladen Lädt ein Dokument auf eine Microsoft SharePoint-Website oder in eine Bibliothek hoch.
Dokument herunterladen Lädt ein Dokument von einer Microsoft SharePoint-Website oder -Bibliothek herunter.
Seite hinzufügen Erstellt eine neue Seite auf der Microsoft SharePoint-Website.
Dokument auschecken Dokumente aus einer Microsoft SharePoint-Bibliothek auschecken
Im Dokument prüfen Checken Sie ein Dokument in eine Microsoft SharePoint-Bibliothek ein.
Anhang oder Dokument umbenennen Anhang oder Dokument in einer Microsoft SharePoint-Bibliothek umbenennen
Anhang oder Dokument verschieben Verschieben Sie ein Dokument aus einer Microsoft SharePoint-Bibliothek in eine Zielbibliothek, einen Zielordner oder eine andere SharePoint-Website.
Ausgechecktes Dokument verwerfen Bricht das Auschecken eines Dokuments ab und macht die Änderungen rückgängig, ohne sie zu speichern.
Ressource freigeben Gibt ein Dokument, einen Ordner oder eine Ressource für bestimmte Empfänger frei oder generiert einen Freigabelink.
Dateieigenschaften aktualisieren Aktualisiert die Metadateneigenschaften eines Dokuments in einer Microsoft SharePoint-Bibliothek.
Seite aktualisieren Aktualisiert eine vorhandene Seite auf der Microsoft SharePoint-Website.
Liste aktualisieren Aktualisiert die Einstellungen einer vorhandenen Liste mit strukturierten Daten auf der Microsoft SharePoint-Website.
Listenelement erstellen Erstellt ein neues Element in einer angegebenen Liste auf der Microsoft SharePoint-Website.
Listeneintrag aktualisieren Aktualisiert Felder eines vorhandenen Elements in einer angegebenen Liste.
Listen auflisten Ruft alle Listen und Dokumentbibliotheken auf einer angegebenen Microsoft SharePoint-Website ab.
Listenelement abrufen Gibt ein einzelnes Listenelement zurück, einschließlich aller zugehörigen Spaltenwerte.
Listenfelder abrufen Gibt das Schema einer angegebenen Liste zurück, einschließlich aller Felder und ihrer Eigenschaften.

Erforderliche Berechtigungen

Damit Gemini Enterprise Suchvorgänge und die Datenaufnahme über den Microsoft SharePoint-Datenspeicher ausführen kann, benötigen Sie die folgenden Berechtigungen:

Microsoft Graph API-Berechtigungen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die einzelnen Verbindungsmodi erforderlich sind.

Hinweis:In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die einzelnen Verbindungsmodi erforderlich sind. Wenn Sie Aktionen für den Verbindungsmodus Föderierte Suche oder Datenaufnahme aktivieren, wählen Sie auch die in der Zeile Aktionen aufgeführten Berechtigungen aus.

Verbindungsmodus Bereich Purpose
Föderierte Suche – Es sind keine Graph API-Berechtigungen erforderlich.
Datenaufnahme GroupMember.Read.All (Verbundanmeldedaten und OAuth 2.0-Aktualisierungstoken) Ermöglicht dem Datenspeicher, Mitgliedschaften und grundlegende Gruppeneigenschaften für alle Gruppen ohne angemeldeten Nutzer zu lesen.
User.Read (Föderierte Anmeldedaten und OAuth 2.0-Aktualisierungstoken) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen. Außerdem kann der Datenspeicher grundlegende Unternehmensinformationen von angemeldeten Nutzern lesen.
User.Read.All (Nur OAuth 2.0-Aktualisierungstoken) Ermöglicht dem Datenspeicher, Nutzerprofile zu lesen.
Sites.FullControl.All (Option 1)
Sites.Selected (Option 2)		 (Verbundanmeldedaten und OAuth 2.0-Aktualisierungstoken) Bei Option 1 hat der Datenspeicher die vollständige Kontrolle über alle Websitesammlungen. Bei Option 2 kann der Datenspeicher auf eine Teilmenge von Websitesammlungen zugreifen. Die spezifischen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden.
User.Read.All (Option 1)
User.ReadBasic.All (Option 2)		 (Nur föderierte Anmeldedaten) Mit Option 1 kann der Datenspeicher Nutzerprofile lesen. Bei Option 2 kann der Datenspeicher eine grundlegende Gruppe von Profileigenschaften anderer Nutzer in der Organisation lesen.
Aktionen Sites.ReadWrite.All (Föderierte Suche und Datenaufnahme) Ermöglicht dem Datenspeicher, Dokumente und Listenelemente in allen Websitesammlungen im Namen des angemeldeten Nutzers zu bearbeiten oder zu löschen.
Sites.Read.All (Föderierte Suche und Datenaufnahme) Ermöglicht dem Datenspeicher, im Namen des angemeldeten Nutzers Listen, Listenelemente und Listenschemas in allen Websitesammlungen zu lesen. Erforderlich für die Aktionen „Listen auflisten“, „Listenelement abrufen“ und „Listenfelder abrufen“.
Files.ReadWrite Ermöglicht dem Datenspeicher, die Dateien des angemeldeten Nutzers zu lesen, zu erstellen, zu aktualisieren und zu löschen.
Files.ReadWrite.All Ermöglicht dem Datenspeicher, alle Dateien zu lesen, zu erstellen, zu aktualisieren, zu löschen, hochzuladen und herunterzuladen, auf die der angemeldete Nutzer zugreifen kann.
Sites.Manage.All Ermöglicht dem Datenspeicher, im Namen des Nutzers Dokumentbibliotheken und Listen in allen Websitesammlungen zu erstellen oder zu löschen.

Microsoft SharePoint-API-Berechtigungen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die einzelnen Verbindungsmodi erforderlich sind.

Verbindungsmodus Bereich Purpose
Föderierte Suche Sites.Search.All (Delegiert) Ermöglicht dem Datenspeicher, Suchanfragen auszuführen und grundlegende Websiteinformationen im Namen des aktuell angemeldeten Nutzers zu lesen. Die Suchergebnisse basieren auf den Berechtigungen des Nutzers und nicht auf den Berechtigungen der App.
AllSites.Read (Option 1, delegiert) Ermöglicht dem Datenspeicher, Dokumente und Listenelemente in allen Websitesammlungen im Namen des angemeldeten Nutzers zu lesen.
Sites.Selected (Option 2, delegiert) Ermöglicht dem Datenspeicher den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die spezifischen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden.
Datenaufnahme (föderierte Anmeldedaten) Sites.FullControl.All (Option 1, Anwendung) Ermöglicht dem Datenspeicher die vollständige Kontrolle über alle Websitesammlungen.
Sites.Selected (Option 2, Anwendung) Ermöglicht dem Datenspeicher den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die spezifischen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden.
Datenaufnahme (OAuth 2.0-Aktualisierungstoken) AllSites.FullControl (Option 1, delegiert) Ermöglicht dem Datenspeicher, im Namen des angemeldeten Nutzers die vollständige Kontrolle über alle Websitesammlungen zu haben.
Sites.Selected (Option 2, delegiert) Ermöglicht dem Datenspeicher den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die spezifischen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden.
Aktionen AllSites.Write (Delegiert) Ermöglicht dem Datenspeicher, Dokumente und Listenelemente in allen Websitesammlungen im Namen des angemeldeten Nutzers zu erstellen, zu lesen, zu aktualisieren, zu löschen, hochzuladen und herunterzuladen sowie aufzulisten.

Informationen zum Hinzufügen der Berechtigungen für Microsoft SharePoint finden Sie unter Microsoft SharePoint konfigurieren und die erforderlichen Berechtigungen festlegen.

Beschränkungen

In diesem Abschnitt werden bekannte Probleme und Einschränkungen beschrieben, die sich auf die Verwendung des Microsoft SharePoint-Datenspeichers auswirken können.

  • Wenn Sie eine neue App erstellen oder einer vorhandenen App einen Datenspeicher hinzufügen, empfehlen wir, nur einen Datenspeicher mit Aktionen zu verknüpfen, die zu einem einzelnen Connectortyp gehören.
  • Das Erzwingen eines VPC Service Controls-Perimeters für vorhandene Microsoft SharePoint-Datenspeicher wird nicht unterstützt. Damit VPC Service Controls erzwungen werden, müssen Sie die Datenspeicher löschen und neu erstellen. Weitere Informationen zu VPC Service Controls und dazu, wie Sie Aktionen nach dem Aktivieren von VPC Service Controls verwenden, finden Sie unter App mit VPC Service Controls schützen.
  • Der Microsoft SharePoint-Datenspeicher wird nur in den folgenden Regionen unterstützt: global, us und eu.

  • Voraussetzung für die Suchqualität:Um optimale Suchergebnisse zu erzielen und die Knowledge Graph-Funktionen optimal zu nutzen, empfehlen wir, zusätzlich zum Microsoft SharePoint-Datenspeicher auch den Datenspeicher für die Personensuche zu konfigurieren und zu synchronisieren.

Für den föderierten Microsoft SharePoint-Datenspeicher gelten die folgenden Einschränkungen:

  • Einschränkungen bei der Suche: Die Suchergebnisse können variieren und sind nicht immer umfassend für alle Dateitypen. Inhalte in archivierten oder verschlüsselten Ordnern sind möglicherweise nicht für die Suche verfügbar. Die föderierte Suche unterstützt keine Suche in Anhängen.
  • Delegierter Zugriff:Für den Zugriff auf freigegebene Websites oder Bibliotheken sind möglicherweise bestimmte Berechtigungen erforderlich, die nicht durch die Standardnutzerautorisierung abgedeckt sind.
  • Layoutparser im Modus „Föderierte Suche“:Der Layoutparser ist zwar Standard, seine Effektivität bei komplexen PDFs (mit Tabellen, mehrspaltigen Layouts oder OCR-Anforderungen) ist im Modus „Föderierte Suche“ jedoch begrenzt. Die Echtzeit-API-Aufrufe dieses Modus liefern möglicherweise nicht die vollständigen Daten oder die Zeit, die für die detaillierte Analyse erforderlich ist, die der Layoutparser während der Datenaufnahme durchführt.
  • Nicht unterstützte PDF-Funktionen:Komplexe PDF-Strukturen können daher möglicherweise nicht vollständig analysiert oder durchsucht werden. Dazu gehören:
    • Mehrspaltige Textlayouts
    • Daten in eingebetteten Tabellen und Diagrammen
    • Text in gescannten Dokumenten, für den die optische Zeichenerkennung (OCR) erforderlich ist
    • Dokumente mit nicht linearen Lesereihenfolgen oder komplexer Formatierung.

Empfehlung

Für Microsoft SharePoint-Daten, die PDFs mit komplexen Funktionen (z. B. Tabellen, mehrspaltige Layouts oder OCR-abhängige Inhalte) enthalten, empfehlen wir die Verwendung des Standardaufnahmemodus für eine effektive Suche. In diesem Modus kann der Layoutparser den gesamten Dokumentinhalt gründlich verarbeiten und indexieren.

Fehlerbehebung bei SharePoint-Connector-Suchergebnissen

Wenn Probleme mit fehlenden Dokumenten, falschen Ergebnissen oder einer schlechten Suchrelevanz auftreten, sehen Sie sich die folgenden Diagnosebereiche an:

  • Datenspeicher für Personen prüfen:Wenn Sie Probleme mit der Relevanz oder dem Abgleich von Rechtssubjekten haben, prüfen Sie, ob der Datenspeicher für die Personensuche eingerichtet ist und synchronisiert wird.
  • Authentifizierungsfehler:Bei dauerhaften Authentifizierungsfehlern wie „Fehler beim Abrufen des Graph API-Zugriffstokens“ können keine Suchanfragen ausgeführt werden. Sehen Sie in den Microsoft Entra ID-Protokollen nach, um das Problem zu beheben, und authentifizieren Sie die Verbindung dann noch einmal.
  • Identitätskonflikt:Wenn Sie Google Identity verwenden, prüfen Sie, ob die Google-E-Mail-Adresse des Nutzers genau mit seiner Microsoft SharePoint-E-Mail-Adresse übereinstimmt. Bei einem nicht übereinstimmenden Pre-Targeting werden keine Ergebnisse zurückgegeben.
  • Gezielte Ordnersuchen (.aspx-URLs): Wenn Sie mit vollständigen Browser-URLs suchen, die mit /Forms/AllItems.aspx enden, wird die gesamte Website durchsucht, nicht nur der jeweilige Ordner. Verwenden Sie für gezielte Suchvorgänge immer absolute Ordnerpfade.
  • Ergebnislime: Bei föderierten Suchvorgängen kann die Anzahl der Dokumente, die pro Anfrage zurückgegeben werden, begrenzt sein (in der Regel auf etwa 20 Ergebnisse).
  • Probleme mit Quellenangaben:Gelegentlich können falsche Quellenangaben auftreten. Wenn das Problem weiterhin besteht, melden Sie es dem Support und geben Sie Ihre Diagnosetokens an.
  • Kompatibilität von Connectors und Modellen:Achten Sie darauf, dass Sie die neuesten Gemini-Modellversionen verwenden. Bei einigen älteren Modellen (z. B. 3.x) sind Probleme beim Auflösen von Tools für SharePoint-Aktionen wie download_document in Agent Builder bekannt.

Nächste Schritte