SharePoint-Agent

Diese Seite bietet detaillierte Konfigurationsanweisungen für den SharePoint-Agenten, der die Integration mit SharePoint Online für Datei- und Site-Verwaltung ermöglicht

Übersicht

• In SharePoint Online gespeicherte Dokumente und Dateien über Blockbrain suchen und abrufen

• Auf Inhalte in SharePoint-Websites und Dokumentbibliotheken zugreifen, sie lesen und verwalten

• Dateiinhalte und Metadaten für Berichte oder KI-Analysen extrahieren und zusammenfassen

• In SharePoint-Website-Strukturen, Listen und Bibliotheken navigieren

• Dokumentenverwaltung und Workflow-Prozesse mithilfe von SharePoint-Daten automatisieren

Voraussetzungen

• Vervollständigen Sie die allgemeinen Einrichtungsschritte auf der Hauptseite der KI-Agenten

• Stellen Sie sicher, dass Benutzer über aktive Microsoft-365-Konten mit Zugriff auf SharePoint Online verfügen

• Überprüfen Sie die passende Microsoft-365-Lizenzierung für SharePoint Online und zugehörige Dienste

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigungen

Fügen Sie Ihrer App-Registrierung die folgenden Microsoft-Graph-Berechtigungen hinzu:

Berechtigung	Typ	Beschreibung
offline_access	Delegiert	Den Zugriff auf Daten beibehalten, für die Sie ihm Zugriff gewährt haben
User.Read	Delegiert	Anmelden und Benutzerprofil lesen
Files.Read.All	Delegiert	Alle Dateien lesen, auf die der Benutzer zugreifen kann
Sites.Read.All	Delegiert	Elemente in allen Websitesammlungen lesen
User.ReadBasic.All	Delegiert	Nach Benutzerinformationen suchen
Tasks.Read	Delegiert	Die Aufgaben und Aufgabenlisten des angemeldeten Benutzers lesen
GroupMember.Read.All	Delegiert	Die Mitglieder aller Gruppen in einer Organisation lesen
Group-Conversation.Read.All	Delegiert	Unterhaltungen in Microsoft-365-Gruppen lesen

Alternativ können Sie die .default Bereichsangabe (verwendet alle in der App festgelegten Bereiche).

Umleitungs-URL

• Hinzufügen https://nango.theblockbrain.ai/oauth/callback als zulässige Umleitungs-URL zu Ihrer App-Registrierung hinzufügen

Schritte zur Berechtigungskonfiguration

1. Gehen Sie in Ihrer Azure-App-Registrierung zu API-Berechtigungen

2. Klicken Sie auf "Berechtigung hinzufügen" > Microsoft Graph > Delegierte Berechtigungen

3. Suchen Sie jede erforderliche Berechtigung und wählen Sie sie aus

4. Klicken Sie auf "Berechtigungen hinzufügen"

5. Klicken Sie auf "Admin-Zustimmung erteilen" (empfohlen für eine organisationsweite Bereitstellung)

Agentenkonfiguration in Blockbrain

1. Auf die Agenteneinstellungen zugreifen:

   • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

   • Gehen Sie zu Agenten > SharePoint-Agent

   • Klicken Sie auf "Konfigurieren"

2. Azure-Anmeldeinformationen eingeben:

   • Client-ID: Geben Sie die Anwendungs-ID aus Ihrer Azure-App-Registrierung ein

   • Client-Geheimnis: Fügen Sie das von Ihnen generierte Client-Geheimnis ein

   • Mandant: Geben Sie Ihre Azure-Mandanten-ID ein

3. OAuth-Bereiche konfigurieren:

   • Fügen Sie jeden erforderlichen Bereich einzeln mithilfe der "Hinzufügen" Schaltfläche hinzu, wie erwähnt hier

   • Jeder Bereich wird als entfernbares Tag angezeigt

   • Verwenden Sie die "X" Schaltfläche, um falsche Bereiche zu entfernen

4. Zusätzliche Konfiguration (Optional):

   • Fügen Sie bei Bedarf benutzerdefinierte Schlüssel-Wert-Paare für spezifische Anforderungen hinzu

   • Konfigurieren Sie organisationsspezifische Einstellungen

5. Konfiguration speichern:

   • Klicken Sie auf "Speichern" um die Einstellungen anzuwenden

   • Warten Sie auf die Bestätigungsmeldung

Alternative: Konfiguration der Administratorzustimmung

Für eine vereinfachte Bereichsverwaltung mit vorab erteilter Administratorfreigabe:

1. Erteilen Sie in Azure die Administratorzustimmung für alle erforderlichen Berechtigungen

2. Verwenden Sie in der Blockbrain-Konfiguration .default den Bereich statt einzelner Bereiche

3. Dadurch müssen Benutzer keinen einzelnen Berechtigungen zustimmen

SharePoint-REST-Konfiguration

Einige SharePoint-Inhalte können nicht über Microsoft Graph gelesen werden. Dies gilt für klassische Web-Part-Seiten und für in Wiki-Seiten eingebettete Web Parts. SharePoint REST ist eine zweite, optionale Verbindung, mit der der SharePoint-Agent auch diese Inhalte lesen kann.

SharePoint REST ist optional. Ohne sie funktioniert der SharePoint-Agent weiterhin wie bisher. Wenn ein Benutzer eine klassische Seite öffnet, gibt der Agent die Inhalte zurück, die er lesen kann, und weist darauf hin, dass die Web Parts der Seite die SharePoint-REST-Verbindung benötigen.

Voraussetzungen

• Der SharePoint-Agent ist bereits wie oben beschrieben konfiguriert

• SharePoint REST ist für Ihre Organisation aktiviert (wenden Sie sich an Ihren Blockbrain Customer Success Manager)

• Sie kennen Ihren SharePoint-Mandantennamen. Er ist der erste Teil Ihrer SharePoint-Adresse. Für https://contoso.sharepoint.com, lautet der Mandantenname contoso

Schritt 1: Die SharePoint-Berechtigung in Microsoft Azure erteilen

SharePoint REST verwendet dieselbe Azure-App-Registrierung wie der SharePoint-Agent. Es benötigt eine zusätzliche Berechtigung von der SharePoint API (nicht Microsoft Graph).

1. Öffnen Sie im Azure-Portal die App-Registrierung, die Sie für den SharePoint-Agenten verwenden

2. Gehen Sie zu API-Berechtigungen

3. Klicken Sie auf "Berechtigung hinzufügen" > SharePoint > Delegierte Berechtigungen

4. Suchen Sie und wählen Sie AllSites.Read

5. Klicken Sie auf "Berechtigungen hinzufügen"

6. Klicken Sie auf "Admin-Zustimmung erteilen"

Berechtigung	API	Typ	Beschreibung
AllSites.Read	SharePoint	Delegiert	Elemente in allen Websitesammlungen lesen, auf die der Benutzer zugreifen kann

AllSites.Read ist unter der SharePoint API aufgeführt. Die Microsoft-Graph-Berechtigung Sites.Read.All hat einen ähnlichen Namen, deckt SharePoint REST jedoch nicht ab.

Schritt 2: SharePoint REST in Blockbrain konfigurieren

1. Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

2. Gehen Sie zu Agenten > Werkzeuge und wählen Sie das SharePoint Tool

3. Wechseln Sie zum "SharePoint REST" Tab oben

4. Azure-Anmeldeinformationen eingeben. Verwenden Sie dieselben Werte wie im "SharePoint" Tab:

   • Client-ID: die Anwendungs-ID aus Ihrer Azure-App-Registrierung

   • Client-Geheimnis: das Client-Geheimnis dieser App-Registrierung

   • Mandant: Ihre Azure-Mandanten-ID

5. OAuth-Bereiche konfigurieren. Fügen Sie jeden Bereich einzeln mithilfe der "Hinzufügen" Schaltfläche hinzu:

Bereich	Zweck
offline_access	Hält die Verbindung aktiv, ohne Benutzer erneut zur Anmeldung aufzufordern
openid	Meldet den Benutzer an
https://<tenant>.sharepoint.com/.default	Gewährt Zugriff auf SharePoint REST mit den in Schritt 1 zugestimmten Berechtigungen

Ersetzen Sie <tenant> durch Ihren SharePoint-Mandantennamen. Beispiel: Wenn Ihre SharePoint-Adresse https://contoso.sharepoint.com, lautet der Bereich https://contoso.sharepoint.com/.default.

1. Klicken Sie auf "Speichern" um die Einstellungen anzuwenden

Schritt 3: Verbinden und testen

1. Lassen Sie einen Testbenutzer verbinden SharePoint REST über seine Agentenverbindungen

2. Bitten Sie den Agenten, eine klassische SharePoint-Seite mit Web Parts zu lesen

3. Überprüfen Sie, ob die Antwort den Inhalt der Web Parts enthält

Fehlerbehebung

Problem: Der Agent sagt, dass die Web Parts der Seite die SharePoint-REST-Verbindung benötigen

• Lösung: Der Benutzer hat SharePoint REST noch nicht verbunden, oder die Verbindung wurde nicht gespeichert. Verbinden Sie sie und versuchen Sie es erneut

Problem: „Zugriff verweigert“ oder 401-Fehler auf klassischen Seiten

• Lösung: Überprüfen Sie, ob AllSites.Read aus der SharePoint API hinzugefügt wurde und die Administratorzustimmung erteilt wurde

• Überprüfen Sie: Der Mandant im .default Bereich muss exakt zu Ihrer SharePoint-Adresse passen, beispielsweise https://contoso.sharepoint.com/.default und nicht https://contoso.onmicrosoft.com/.default

Den SharePoint-Agenten testen

Verifizierungsschritte

1. Verbindungstest:

   • Verwenden Sie den integrierten Verbindungstest in Blockbrain

   • Überprüfen Sie die erfolgreiche Authentifizierung mit Microsoft Graph

2. Benutzertest:

   • Lassen Sie einen Testbenutzer sein SharePoint-Konto verbinden

   • Versuchen Sie, auf eine bekannte SharePoint-Datei oder -Website zuzugreifen

   • Überprüfen Sie die Dateiabfrage- und Suchfunktionalität

3. Berechtigungsvalidierung:

   • Überprüfen Sie, ob der Agent auf die entsprechenden SharePoint-Websites zugreifen kann

   • Bestätigen Sie, dass die Leseberechtigungen für Dateien korrekt funktionieren

Häufige Anwendungsfälle für die SharePoint-Integration

• Dokumentsuche: Dateien in mehreren SharePoint-Websites finden

• Dateiabruf: Auf bestimmte Dokumente für KI-Analysen zugreifen

• Website-Navigation: In SharePoint-Website-Strukturen und Bibliotheken navigieren

• Metadatenextraktion: Dateieigenschaften und Metadaten abrufen

Fehlerbehebung

Authentifizierungsprobleme

Problem: „Zugriff verweigert“ oder Authentifizierungsfehler

• Lösung: Prüfen Sie, ob für alle erforderlichen Berechtigungen die Administratorzustimmung erteilt wurde

• Überprüfen Sie: Stellen Sie sicher, dass die Umleitungs-URL genau https://nango.theblockbrain.ai/oauth/callback

Berechtigungsfehler

Problem: „Unzureichende Berechtigungen“ beim Zugriff auf SharePoint

• Lösung: Bestätigen Sie, dass die App-Registrierung Sites.Read.All und Files.Read.All Berechtigungen

• Überprüfen Sie: Überprüfen Sie, ob der Benutzer in Ihrer Organisation Zugriff auf SharePoint hat

Probleme bei der Bereichskonfiguration

Problem: Bereiche werden nicht korrekt gespeichert

• Lösung: Fügen Sie jeden Bereich einzeln mit der Schaltfläche „Hinzufügen“ hinzu

• Überprüfen Sie: Entfernen Sie doppelte oder falsche Bereiche mit der Schaltfläche „X“

Sicherheitsaspekte

• Dateizugriff: Der Agent übernimmt die SharePoint-Berechtigungen des Benutzers

• Website-Bereich: Der Zugriff ist auf Websites beschränkt, auf die der authentifizierte Benutzer zugreifen kann

• Datenschutz: Dateien werden gemäß den Richtlinien von Blockbrain zur Datenverarbeitung verarbeitet

• Prüfprotokoll: Der SharePoint-Zugriff wird sowohl in den Azure-AD- als auch in den SharePoint-Prüfprotokollen protokolliert

Nächste Schritte

Nach erfolgreicher Konfiguration des SharePoint-Agenten:

• Schulen Sie Benutzer in den SharePoint-Integrationsfunktionen

• Konfigurieren Outlook-Agent wenn eine E-Mail-Integration erforderlich ist

• Überwachen Sie Nutzung und Leistung über Azure-AD-Berichte