SharePoint-Agent

Übersicht

• Dokumente und Dateien, die in SharePoint Online gespeichert sind, über Blockbrain suchen und abrufen

• Auf Inhalte innerhalb von SharePoint-Sites und Dokumentbibliotheken zugreifen, sie lesen und verwalten

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

• SharePoint-Sitestrukturen, Listen und Bibliotheken navigieren

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

Voraussetzungen

• Schließe die allgemeinen Einrichtungsschritte von der Hauptseite der AI Agents

• Sicherstellen, dass Benutzer aktive Microsoft-365-Konten mit Zugriff auf SharePoint Online haben

• Die entsprechende Microsoft-365-Lizenzierung für SharePoint Online und zugehörige Dienste überprüfen

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigungen

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

Alternativ können Sie den .default -Bereich verwenden (nutzt 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

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 und wählen Sie jede erforderliche Berechtigung aus

4. Klicken Sie auf „Berechtigungen hinzufügen“

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

Agentenkonfiguration in Blockbrain

1. Agenteneinstellungen aufrufen:

   • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

   • Gehen Sie zu Agents > SharePoint-Agent

   • Klicken Sie auf „Konfigurieren“

2. Azure-Anmeldedaten eingeben:

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

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

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

3. OAuth-Bereiche konfigurieren:

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

   • Jeder Bereich wird als entfernbares Tag angezeigt

   • Verwenden Sie das „X“ Schaltfläche, um falsche Bereiche zu entfernen

4. Zusätzliche Konfiguration (Optional):

   • Bei Bedarf benutzerdefinierte Schlüssel-Wert-Paare hinzufügen, um spezifische Anforderungen zu erfüllen

   • Alle organisationsspezifischen Einstellungen konfigurieren

5. Konfiguration speichern:

   • Klicken Sie auf „Speichern“ um die Einstellungen zu übernehmen

   • Warten Sie auf die Bestätigungsmeldung

Alternative: Konfiguration der Admin-Zustimmung

Für eine vereinfachte Bereichsverwaltung mit vorab genehmigter Admin-Zustimmung:

1. In Azure die Administratorzustimmung für alle erforderlichen Berechtigungen erteilen

2. In der Blockbrain-Konfiguration verwenden Sie .default Bereich anstelle einzelner Bereiche

3. Dadurch entfällt für Benutzer die Notwendigkeit, einzelnen Berechtigungen zuzustimmen

Den SharePoint-Agenten testen

Überprüfungsschritte

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 Dateiaufruf- und Suchfunktionalität

3. Berechtigungsvalidierung:

   • Prüfen, ob der Agent auf die entsprechenden SharePoint-Sites zugreifen kann

   • Bestätigen, dass die Dateileseberechtigungen korrekt funktionieren

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

• Dokumentsuche: Dateien über mehrere SharePoint-Sites hinweg finden

• Dateiaufruf: Spezifische Dokumente für die KI-Analyse aufrufen

• Site-Navigation: SharePoint-Sitestrukturen und Bibliotheken durchsuchen

• Metadatenextraktion: Dateieigenschaften und Metadaten abrufen

Fehlerbehebung

Authentifizierungsprobleme

Problem: „Zugriff verweigert“ oder Authentifizierungsfehler

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

• Prüfen Sie: Sicherstellen, dass die Umleitungs-URL genau https://nango.theblockbrain.ai/oauth/callback

Berechtigungsfehler

Problem: „Unzureichende Berechtigungen“ beim Zugriff auf SharePoint

• Lösung: Stellen Sie sicher, dass die App-Registrierung Sites.Read.All und Files.Read.All Berechtigungen hat

• Prüfen Sie: Stellen Sie sicher, dass 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

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

Sicherheitsaspekte

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

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

• Datenschutz: Dateien werden gemäß den Datenverarbeitungsrichtlinien von Blockbrain verarbeitet

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

Nächste Schritte

:

• Benutzer in den Funktionen der SharePoint-Integration schulen

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

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