Excel-Agent

Ü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

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

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigungen

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

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

   • 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