# SharePoint-Agent
Titelbild
Ü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
/files/8e2d91078527b6e8c217ab72731c4498aed2fe68
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
/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032
### 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 | Auf Daten zugreifen und diesen Zugriff beibehalten, für die Sie der App 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 den `.default` -Bereich verwenden (nutzt alle in der App festgelegten Bereiche). #### Umleitungs-URL * Hinzufügen 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](#required-api-permissions) * 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](/de/fur-administratoren/agenten/outlook-agent.md) falls eine E-Mail-Integration erforderlich ist * Überwachen Sie Nutzung und Leistung über Azure-AD-Berichte --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.en.theblockbrain.ai/de/fur-administratoren/agenten/sharepoint-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.