# Excel-Agent
Titelbild
Übersicht
  • Excel-Arbeitsmappen, die in OneDrive oder SharePoint gespeichert sind, über Blockbrain suchen und abrufen
  • Daten innerhalb von Excel-Arbeitsblättern und -tabellen lesen, aktualisieren und analysieren
  • Tabelleninhalte für Berichte oder KI-Analysen extrahieren und zusammenfassen
  • Auf Arbeitsmappeneigenschaften und Dateimetadaten zugreifen
  • Datenverarbeitungs- und Bericht-Workflows mithilfe von Excel-Dateien 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 OneDrive oder SharePoint haben
  • Die geeignete Microsoft-365- oder Office-Lizenzierung für Excel Online und den Dateizugriff ü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 | | `Files.Read` | Delegiert | Alle Dateien lesen, auf die der angemeldete Benutzer zugreifen kann, einschließlich Excel-Arbeitsmappen in OneDrive oder SharePoint | | `Files.ReadWrite` | Delegiert | Alle Dateien lesen und schreiben, auf die der angemeldete Benutzer zugreifen kann, einschließlich des Bearbeitens von Excel-Arbeitsmappen | | `openid` | Delegiert | Melden Sie den Benutzer an und erlauben Sie der App, die grundlegenden Profilinformationen des Benutzers zu lesen | | `User.Read` | Delegiert | Das Profil des angemeldeten Benutzers lesen, einschließlich grundlegender Informationen wie Name und E-Mail-Adresse | | `Sites.Selected` | Delegiert | Auf Inhalte in bestimmten SharePoint-Sites zugreifen, die vom Administrator ausgewählt wurden, einschließlich Excel-Dateien | > Für Excel-spezifische Vorgänge sind die relevantesten Berechtigungen `Files.Read`, `Files.ReadWrite`, und `Sites.Selected`, da diese den Zugriff auf in OneDrive oder SharePoint gespeicherte Excel-Arbeitsmappen steuern. #### 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** > **Excel 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 Microsoft-Konto verbinden * Versuchen, auf eine bekannte Excel-Datei in OneDrive oder SharePoint zuzugreifen * Dateiabruf, Zugriff auf Arbeitsblätter sowie Lese-/Schreibfunktionalität für Daten überprüfen 3. **Berechtigungsvalidierung**: * Prüfen, ob der Agent auf die entsprechenden Excel-Dateien und Speicherorte zugreifen kann * Bestätigen, dass Lese- und Schreibberechtigungen korrekt funktionieren ### Häufige Anwendungsfälle für die Excel-Integration * **Arbeitsmappen-Suche**: Excel-Dateien in OneDrive und SharePoint finden * **Datenextraktion**: Daten aus bestimmten Arbeitsblättern oder Tabellen abrufen und analysieren * **Dateibearbeitung**: Daten in Excel-Arbeitsmappen aktualisieren oder schreiben * **Metadatenabruf**: Arbeitsmappeneigenschaften und Dateimetadaten extrahieren ### 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 Excel-Dateien * **Lösung**: Stellen Sie sicher, dass die App-Registrierung `Files.Read`, `Files.ReadWrite`, und `Sites.Selected` Berechtigungen hat * **Prüfen Sie**: Verifizieren, dass der Benutzer Zugriff auf die relevanten OneDrive- oder SharePoint-Speicherorte 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 Microsoft-365-Dateiberechtigungen des Benutzers * **Speicherortbereich**: Der Zugriff ist auf Dateien und Sites beschränkt, auf die der authentifizierte Benutzer zugreifen kann * **Datenschutz**: Dateien werden gemäß den Datenverarbeitungsrichtlinien von Blockbrain verarbeitet * **Prüfprotokoll**: Der Zugriff auf Excel-Dateien wird sowohl in den Azure-AD- als auch in den Microsoft-365-Audit-Logs protokolliert ### Nächste Schritte Nach erfolgreicher Excel-Agent-Konfiguration: * Benutzer in den Funktionen der Excel-Integration schulen * Konfigurieren Sie bei Bedarf zusätzliche Agenten (z. B. SharePoint, Outlook) * Ü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/excel-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.