Übersicht

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

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 Microsoft SharePoint-Mediathek hoch.
Dokument herunterladen Lädt ein Dokument von einer Microsoft SharePoint-Website oder aus einer Microsoft SharePoint-Mediathek herunter.
Seite hinzufügen Erstellt eine neue Seite auf der Microsoft SharePoint-Website.
Dokument auschecken Checkt ein Dokument aus einer Microsoft SharePoint-Mediathek aus.
Dokument einchecken Checkt ein Dokument in eine Microsoft SharePoint-Mediathek ein.
Anhang oder Dokument umbenennen Benennt einen Anhang oder ein Dokument in einer Microsoft SharePoint-Mediathek um.
Anhang oder Dokument verschieben Verschiebt ein Dokument aus einer Microsoft SharePoint-Mediathek in eine andere Mediathek, einen anderen Ordner oder auf eine andere SharePoint-Website.
Auschecken des Dokuments verwerfen Verwirft das Auschecken eines Dokuments und stellt es wieder her, ohne Änderungen 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-Mediathek.
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.
Listenelement aktualisieren Aktualisiert die Felder eines vorhandenen Elements in einer angegebenen Liste.
Listen auflisten Ruft alle Listen und Dokumentmediatheken auf einer angegebenen Microsoft SharePoint-Website ab.
Listenelement abrufen Gibt ein einzelnes Listenelement zurück, einschließlich aller Spaltenwerte.
Listenfelder abrufen Gibt das Schema einer angegebenen Liste zurück, einschließlich aller Felder und ihrer Eigenschaften.

Erforderliche Berechtigungen

Damit Gemini Enterprise mit dem Microsoft SharePoint-Datenspeicher suchen und Daten aufnehmen 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 für den Verbindungsmodus Föderierte Suche oder Datenaufnahme die Option Aktionen aktivieren, wählen Sie auch die Berechtigungen aus, die in der Zeile Aktionen aufgeführt sind.

Verbindungsmodus Bereich Zweck
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) Mit Option 1 hat der Datenspeicher die vollständige Kontrolle über alle Websitesammlungen. Mit Option 2 kann der Datenspeicher auf eine Teilmenge von 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 eine grundlegende Gruppe von Profileigenschaften 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 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 Dokumentmediatheken 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 Zweck
Föderierte Suche Sites.Search.All (Delegiert) Ermöglicht dem Datenspeicher, im Namen des aktuell angemeldeten Nutzers Suchanfragen auszuführen und grundlegende Websiteinformationen 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 zu haben.
Sites.Selected (Option 2, Anwendung) 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 (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, 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.
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 Beschränkungen beschrieben, die sich auf die Verwendung des Microsoft SharePoint-Datenspeichers auswirken können.

  • Wenn Sie eine neue App erstellen oder einem vorhandenen Datenspeicher 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 App mit VPC Service Controls schützen.
  • Der Microsoft SharePoint-Datenspeicher wird nur an den global, us, und eu Standorten 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 auch den Datenspeicher für die Personensuche zu konfigurieren und zu synchronisieren.

Die folgenden Beschränkungen gelten für den föderierten Microsoft SharePoint-Datenspeicher:

  • Beschränkungen bei der Suche: Die Suchergebnisse können variieren und sind nicht immer umfassend für alle Dateitypen. Auf Inhalte in archivierten oder verschlüsselten Ordnern kann möglicherweise nicht gesucht werden. Die föderierte Suche unterstützt keine Suche in Anhängen.
  • Delegierter Zugriff:Für den Zugriff auf freigegebene Websites oder Mediatheken 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 OCR-Anforderungen) ist im Modus für die föderierte Suche jedoch begrenzt. Die Echtzeit-API-Aufrufe dieses Modus liefern möglicherweise nicht alle Daten oder die Zeit, die für die detaillierte Analyse erforderlich ist, die der Layoutparser bei der Datenaufnahme durchführt.
  • Nicht unterstützte PDF-Funktionen:Daher können komplexe PDF-Strukturen 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 nichtlinearer Lesereihenfolge oder komplizierter Formatierung.

Empfehlung

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

Fehlerbehebung bei Suchergebnissen des SharePoint-Connectors

Wenn Probleme mit fehlenden Dokumenten, falschen Ergebnissen oder einer schlechten Suchrelevanz auftreten, prüfen Sie die folgenden Diagnosebereiche:

  • Datenspeicher für die Personensuche prüfen:Achten Sie darauf, dass der Datenspeicher für die Personensuche eingerichtet ist und synchronisiert wird, wenn Probleme mit der Relevanz oder dem Abgleich von Entitäten auftreten.
  • Authentifizierungsfehler:Bei anhaltenden Authentifizierungsfehlern, z. B. „Fehler beim Abrufen des Graph API-Zugriffstokens“, funktionieren Suchanfragen nicht. Weitere Informationen finden Sie in den Microsoft Entra ID-Protokollen. 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 Konflikten werden keine Ergebnisse zurückgegeben.
  • Gezielte Ordnersuchen (.aspx-URLs) : Wenn Sie mit vollständigen Browser-URLs suchen, die auf /Forms/AllItems.aspx enden, wird eine Suche auf der gesamten Website und nicht nur im jeweiligen Ordner ausgeführt. Verwenden Sie für gezielte Suchanfragen immer absolute Ordnerpfade.
  • Ergebnislimits:Bei föderierten Suchanfragen kann es Beschränkungen für die Anzahl der Dokumente geben, die pro Anfrage zurückgegeben werden (in der Regel maximal 20 Ergebnisse).
  • Probleme mit Quellenangaben:Es können gelegentlich falsche Quellenangaben auftreten. Wenn das Problem weiterhin besteht, melden Sie es dem Support und fügen Sie Ihre Diagnosetokens hinzu.
  • Kompatibilität von Connector-Modellen:Achten Sie darauf, dass Sie die neuesten Gemini-Modellversionen verwenden. Bei einigen älteren Modellen (z. B. 3.x) gibt es bekannte Probleme mit der Auflösung von Tools für SharePoint-Aktionen, z. B. download_document in Agent Builder.

Nächste Schritte