> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/for-admins/agenten/sharepoint-agent.md).

# 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

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Titelbild</th></tr></thead><tbody><tr><td><strong>Übersicht</strong></td><td><ul><li>In SharePoint Online gespeicherte Dokumente und Dateien über Blockbrain suchen und abrufen</li><li>Auf Inhalte in SharePoint-Websites und Dokumentbibliotheken zugreifen, sie lesen und verwalten</li><li>Dateiinhalte und Metadaten für Berichte oder KI-Analysen extrahieren und zusammenfassen</li><li>In SharePoint-Website-Strukturen, Listen und Bibliotheken navigieren</li><li>Dokumentenverwaltung und Workflow-Prozesse mithilfe von SharePoint-Daten automatisieren</li></ul></td><td><a href="https://1293758209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FUwHxKX9rpt3NC6yRBTXA%2FScreenshot%202025-12-04%20at%2013.51.34.png?alt=media&amp;token=c5a58bce-5ede-4ad9-985e-556b4ebeed5e">Screenshot 2025-12-04 at 13.51.34.png</a></td></tr><tr><td><strong>Voraussetzungen</strong></td><td><ul><li>Vervollständigen Sie die <a href="https://docs.en.theblockbrain.ai/for-users/agents">allgemeinen Einrichtungsschritte</a> auf der Hauptseite der KI-Agenten</li><li>Stellen Sie sicher, dass Benutzer über aktive Microsoft-365-Konten mit Zugriff auf SharePoint Online verfügen</li><li>Überprüfen Sie die passende Microsoft-365-Lizenzierung für SharePoint Online und zugehörige Dienste</li></ul></td><td><a href="https://1293758209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2Fvi22Kf04WdMUhdg0dI0h%2FScreenshot%202025-12-04%20at%2013.51.48.png?alt=media&amp;token=cc189408-a272-40e5-988b-b7486983d97e">Screenshot 2025-12-04 at 13.51.48.png</a></td></tr></tbody></table>

### 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

<div data-with-frame="true"><figure><img src="https://1293758209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FYDD88tH94jV3rWXarKIo%2Fimage.png?alt=media&amp;token=b46c04ed-62ec-439a-9347-01e93ecd33b0" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1293758209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2Fq4T77hWPCgG2WecvAJRc%2Fimage.png?alt=media&amp;token=c731bd25-3948-4fbb-885c-b1d40cb6637a" alt=""><figcaption></figcaption></figure></div>

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](#required-api-permissions)
   * 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.

{% hint style="info" %}
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.
{% endhint %}

**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 |

{% hint style="warning" %}
`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.
{% endhint %}

**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`.

6. 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](/de/for-admins/agenten/outlook-agent.md) wenn eine E-Mail-Integration erforderlich ist
* Überwachen Sie Nutzung und Leistung über Azure-AD-Berichte


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.blockbrain.ai/de/for-admins/agenten/sharepoint-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.