Übersicht

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

Unterstützte Microsoft SharePoint-Versionen

Der Microsoft SharePoint-Datenspeicher unterstützt die neueste 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 Microsoft SharePoint-Bibliothek hoch.
Dokument herunterladen Lädt ein Dokument von einer Microsoft SharePoint-Website oder aus einer Microsoft SharePoint-Bibliothek herunter.
Seite hinzufügen Erstellt eine neue Seite auf der Microsoft SharePoint-Website.
Dokument auschecken Checken Sie ein Dokument aus einer Microsoft SharePoint-Bibliothek aus.
Dokument einchecken Dokument in eine Microsoft SharePoint-Bibliothek einchecken.
Anhang oder Dokument umbenennen Anhang oder Dokument in einer Microsoft SharePoint-Bibliothek umbenennen
Anhang oder Dokument verschieben Dokumente aus einer Microsoft SharePoint-Bibliothek in eine Zielbibliothek, einen Zielordner oder eine andere SharePoint-Website verschieben
Ausgechecktes Dokument verwerfen Verwirft das Auschecken eines Dokuments und setzt es zurück, ohne Änderungen zu speichern.
Ressource freigeben Gibt ein Dokument, einen Ordner oder eine Ressource für bestimmte Empfänger frei oder generiert einen Freigabelink.
Dateiattribute aktualisieren Aktualisiert die Metadatenattribute 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 einschließlich aller Spaltenwerte zurück.
Listenfelder abrufen Gibt das Schema einer angegebenen Liste zurück, einschließlich aller Felder und ihrer Attribute.

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 für die einzelnen Verbindungsmodi erforderlichen Berechtigungen aufgeführt.

Hinweis: In der folgenden Tabelle sind die für die einzelnen Verbindungsmodi erforderlichen Berechtigungen aufgeführt. 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 (Föderierte Anmeldedaten 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 angemeldeter Nutzer 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)		 (Föderierte Anmeldedaten und OAuth 2.0-Aktualisierungstoken) Option 1 ermöglicht dem Datenspeicher die vollständige Kontrolle über alle Websitesammlungen. Mit Option 2 kann der Datenspeicher auf eine Teilmenge der Websitesammlungen zugreifen. Die spezifischen Websitesammlungen und die gewährten 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. Mit Option 2 kann der Datenspeicher einen grundlegenden Satz von Profilattributen anderer Nutzer in der Organisation lesen.
Aktionen Sites.ReadWrite.All (Föderierte Suche und Datenaufnahme) Ermöglicht dem Datenspeicher, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen 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, auf die der angemeldete Nutzer zugreifen kann, zu lesen, zu erstellen, zu aktualisieren, zu löschen, hochzuladen und herunterzuladen.
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 für die einzelnen Verbindungsmodi erforderlichen Berechtigungen aufgeführt.

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, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu lesen.
Sites.Selected (Option 2, Delegiert) Ermöglicht dem Datenspeicher, mit einem angemeldeten Nutzer auf eine Teilmenge von Websitesammlungen zuzugreifen. Die spezifischen Websitesammlungen und die gewährten 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, auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer zuzugreifen. Die spezifischen Websitesammlungen und die gewährten 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, auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer zuzugreifen. Die spezifischen Websitesammlungen und die gewährten Berechtigungen können in SharePoint Online konfiguriert werden.
Aktionen AllSites.Write (delegiert) Ermöglicht dem Datenspeicher, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu erstellen, zu lesen, zu aktualisieren, zu löschen, hochzuladen und herunterzuladen.

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 Anwendung erstellen oder einer vorhandenen Anwendung einen Datenspeicher hinzufügen, sollten Sie nur einen Datenspeicher mit Aktionen verknüpfen, die zu einem einzelnen Connector-Typ gehören.
  • Das Erzwingen eines VPC Service Controls-Perimeters für vorhandene Microsoft SharePoint-Datenspeicher wird nicht unterstützt. Wenn Sie VPC Service Controls erzwingen möchten, müssen Sie die Datenspeicher löschen und neu erstellen. Weitere Informationen zu VPC Service Controls und zur Verwendung von Aktionen nach dem Aktivieren von VPC Service Controls finden Sie unter Anwendung mit VPC Service Controls sichern.
  • Der Microsoft SharePoint-Datenspeicher wird nur in den Standorten global, us und eu unterstützt.

  • Voraussetzung für die Suchqualität: Um optimale Suchergebnisse zu erzielen und die Knowledge Graph-Funktionen vollständig zu nutzen, empfehlen wir, zusätzlich zum Microsoft SharePoint-Datenspeicher 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 für alle Dateitypen umfassend. Inhalte in archivierten oder verschlüsselten Ordnern sind möglicherweise nicht für die Suche zugänglich. 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ür die föderierte Suche: Der Layoutparser ist zwar Standard, seine Effektivität bei komplexen PDFs (mit Tabellen, mehrspaltigen Layouts oder solchen, die OCR erfordern) ist im Modus für die föderierte Suche jedoch eingeschränkt. 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 Layout-Parser während der Datenaufnahme durchführt.
  • Nicht unterstützte PDF-Funktionen: Komplexe PDF-Strukturen werden daher möglicherweise nicht vollständig analysiert oder durchsucht. Dazu gehören:
    • Mehrspaltige Textlayouts
    • Daten in eingebetteten Tabellen und Diagrammen
    • Text in gescannten Dokumenten, für die eine optische Zeichenerkennung (OCR) erforderlich ist
    • Dokumente mit nicht linearer Lesereihenfolge oder komplexer Formatierung.

Empfehlung

Für Microsoft SharePoint-Daten, die PDFs mit komplexen Funktionen (wie Tabellen, mehrspaltigen Layouts oder OCR-abhängigen Inhalten) enthalten, empfehlen wir die Verwendung des Standardaufnahmemodus für eine effektive Suche. In diesem Modus kann der Layout-Parser den gesamten Dokumentinhalt gründlich verarbeiten und indexieren.

Fehlerbehebung bei Suchergebnissen des SharePoint-Connectors

Wenn Sie Probleme mit fehlenden Dokumenten, falschen Ergebnissen oder schlechter Suchrelevanz haben, prüfen Sie die folgenden Diagnosebereiche:

  • Datenspeicher für Personendaten prüfen: Wenn Sie Probleme mit der Relevanz oder dem Entitätsabgleich haben, prüfen Sie, ob der Datenspeicher für die Personensuche eingerichtet ist und synchronisiert wird.
  • Authentifizierungsfehler: Dauerhafte Authentifizierungsfehler wie „Fehler beim Abrufen des Graph API-Zugriffstokens“ verhindern, dass Suchanfragen funktionieren. Prüfen Sie die Microsoft Entra ID-Protokolle auf Details und authentifizieren Sie die Verbindung dann noch einmal.
  • Nicht übereinstimmende Identität: 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 Nichtübereinstimmungen werden keine Ergebnisse zurückgegeben.
  • Gezielte Ordnersuchen (.aspx-URLs): Wenn Sie mit vollständigen Browser-URLs suchen, die auf /Forms/AllItems.aspx enden, wird die Suche auf der gesamten Website ausgeführt, nicht nur im angegebenen Ordner. Verwenden Sie für gezielte Suchanfragen immer absolute Ordnerpfade.
  • Ergebnislimits: Beachten Sie, dass bei föderierten Suchen die Anzahl der pro Abfrage zurückgegebenen Dokumente begrenzt sein kann (in der Regel auf etwa 20 Ergebnisse).
  • Probleme mit Quellenangaben: Es kann gelegentlich zu falschen Quellenangaben kommen. Wenn das Problem weiterhin besteht, melden Sie es dem Support und geben Sie Ihre Diagnosetokens an.
  • Kompatibilität von Connector und Modell: Achten Sie darauf, dass Sie die neuesten Gemini-Modellversionen verwenden. Bei einigen älteren Modellen (z. B. 3.x) gibt es bekannte Probleme beim Auflösen von Tools für SharePoint-Aktionen wie download_document in Agent Builder.

Nächste Schritte