OneNote-Agent

Übersicht

• Notizbücher, Abschnitte und Seiten aus OneNote über Blockbrain suchen und abrufen

• Notizen (Seiten) direkt in Blockbrain erstellen, lesen und verwalten

• Zugriff auf die Organisation von Notizbüchern und Abschnitten und deren Aktualisierung für eine optimierte Informationsverwaltung

• Den Inhalt von Notizen extrahieren und zusammenfassen – einschließlich Text und Bildern – für Berichte oder KI-Analysen

Voraussetzungen

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

• Stellen Sie sicher, dass die Benutzer aktive Microsoft 365-Konten mit aktiviertem OneNote haben

• Überprüfen Sie die passende Microsoft 365-Lizenzierung für OneNote und zugehörige Dienste

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigungen

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

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

Konfigurationsschritte

1. Agenteneinstellungen aufrufen:

   • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

   • Gehen Sie zu Agents > OneNote-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 (verwenden Sie das Augensymbol, um die Sichtbarkeit umzuschalten)

   • 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 Scope wird als entfernbares Tag mit visuellen Hinweisen angezeigt

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

4. Zusätzliche Konfiguration (Optional):

   • Konfigurieren Sie benutzerdefinierte Schlüssel-Wert-Paare für spezifische organisatorische Anforderungen

   • Beliebige spezialisierte Regeln für die E-Mail-Verarbeitung einrichten

5. Konfiguration speichern:

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

   • Warten Sie auf die Bestätigungsmeldung

Alternative: Konfiguration der Admin-Zustimmung

Für eine optimierte Bereitstellung mit vorab genehmigten Berechtigungen:

1. Erteilen Sie in Azure die Admin-Zustimmung für alle erforderlichen Microsoft-Graph-Berechtigungen

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

3. Dieser Ansatz vereinfacht das Onboarding von Benutzern, da einzelne Zustimmungsabfragen entfallen

Testen des OneNote-Agents

Überprüfungsschritte

1. Authentifizierungstest:

   • Verwenden Sie das integrierte Verbindungstest-Tool von Blockbrain

   • Erfolgreichen OAuth-Flow mit Microsoft Graph überprüfen

2. Zugriff auf Notizbücher und Abschnitte:

   • Das Auflisten aller Notizbücher und Abschnitte über den Agenten testen

   • Zugriff auf Notizbücher, Abschnitte und deren Metadaten überprüfen

3. Seitenverwaltung (Notiz):

   • Eine Testseite in einem Notizbuchabschnitt erstellen

   • Das Lesen, Aktualisieren und Löschen von Seiteninhalten überprüfen

   • Die Fähigkeit zum Auflisten und Suchen von Seiten prüfen

4. Inhaltsextraktion und -analyse:

   • Das Extrahieren und Zusammenfassen von Inhalten aus einer Beispielnotiz testen

   • Die Fähigkeiten zur Bilderkennung und -analyse überprüfen (falls zutreffend)

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

Notiz- und Wissensmanagement

• Automatisierte Notizerstellung: Erstellen Sie mithilfe von KI-Prompts sofort Besprechungsnotizen, Projektprotokolle oder Brainstorming-Seiten

• Inhaltszusammenfassung: Fassen Sie umfangreiche Notizen zusammen oder extrahieren Sie die wichtigsten Punkte und Aufgaben aus Seiten

• Suche & Abruf: Finden Sie schnell bestimmte Notizbücher, Abschnitte oder Seiten anhand von Schlüsselwörtern oder Themen

Organisation und Zusammenarbeit

• Organisation von Notizbüchern und Abschnitten: Erstellen und strukturieren Sie Notizbücher und Abschnitte für Projekte, Teams oder den persönlichen Gebrauch

• Verwaltung freigegebener Notizen: Arbeiten Sie gemeinsam an freigegebenen Notizbüchern, aktualisieren Sie Inhalte und verfolgen Sie Änderungen

• Querverweise: Verknüpfen Sie verwandte Notizen und Abschnitte für eine einfache Navigation und besseren Kontext

Inhaltsautomatisierung

• Vorlagenerstellung: Erstellen Sie automatisch Seiten mit vordefinierten Vorlagen für Besprechungen, Berichte oder Checklisten

• Massenaktualisierungen: Wenden Sie Änderungen an oder fügen Sie Inhalte gleichzeitig zu mehreren Seiten oder Abschnitten hinzu

• Bild- und Dateianalyse: Extrahieren und analysieren Sie Text oder Daten aus in Notizen eingebetteten Bildern

Fehlerbehebung

Authentifizierungsprobleme

Problem: OAuth-Authentifizierungsfehler

• Lösung: Überprüfen Sie, ob die Umleitungs-URL exakt https://nango.theblockbrain.ai/oauth/callback

• Prüfen Sie: Stellen Sie sicher, dass die Admin-Zustimmung für alle erforderlichen Berechtigungen erteilt wurde

• Überprüfen: Das Client-Geheimnis ist nicht abgelaufen und korrekt eingegeben

OneNote-Berechtigungsfehler

Problem: Kann nicht auf Notizbücher, Abschnitte oder Seiten zugreifen oder sie ändern

• Lösung: Bestätigen Notes.Read.All und Notes.ReadWrite.All Berechtigungen sind erteilt

• Prüfen Sie: Überprüfen Sie, ob der Benutzer ein aktives Microsoft 365-Konto mit aktiviertem OneNote hat

• Validieren: Testen Sie mit einem anderen Benutzerkonto, um Berechtigungsprobleme einzugrenzen

Probleme beim Zugriff auf Notizbücher oder Seiten

Problem: Notizbücher, Abschnitte oder Seiten nicht zugänglich

• Lösung: Stellen Sie sicher, dass der Benutzer Zugriff auf das spezifische Notizbuch oder den Abschnitt in OneNote hat

• Prüfen Sie: Überprüfen Sie, ob der Benutzer mit dem richtigen Microsoft-Konto angemeldet ist

• Testen: Versuchen Sie, direkt in OneNote auf die Inhalte zuzugreifen, um die Berechtigungen zu bestätigen

Probleme bei der Scopes-Konfiguration

Problem: Berechtigungen werden nicht gespeichert oder erkannt

• Lösung: Fügen Sie jede Berechtigung einzeln über die Benutzeroberfläche hinzu

• Prüfen Sie: Entfernen Sie doppelte oder fehlerhaft formatierte Berechtigungen

• Überprüfen: Stellen Sie sicher, dass alle erforderlichen Berechtigungen in der Konfiguration vorhanden sind

Sicherheit und Compliance

Datenschutz

• Notizbuchsicherheit: Alle OneNote-Notizbuchdaten werden gemäß den Sicherheitsrichtlinien von Blockbrain verarbeitet

• Notiz-Privatsphäre: Der Zugriff auf Notizbücher, Abschnitte und Seiten berücksichtigt die Benutzerberechtigungen und Datenschutzeinstellungen

• Vertraulichkeit von Inhalten: Notizinhalte, einschließlich Text und Bildern, werden mit geeigneten Vertraulichkeitsmaßnahmen verarbeitet

Compliance-Aspekte

• DSGVO-Konformität: Die Verarbeitung von OneNote-Daten erfolgt gemäß der DSGVO und anderen relevanten Datenschutzanforderungen

• Datenaufbewahrung: Konfigurieren Sie geeignete Aufbewahrungsrichtlinien für Notizen und vom Benutzer erstellte Inhalte

• Audit-Logging: Alle Aktivitäten des OneNote-Agents werden zu Compliance- und Berichtszwecken protokolliert

Zugriffskontrolle

• Benutzerberechtigungen: Der Agent übernimmt die OneNote-Berechtigungen des authentifizierten Benutzers.

• Zugriff auf Notizbücher: Beachtet Zugriffsbeschränkungen für freigegebene und private Notizbücher und Abschnitte.

• Sicherheitsgruppen: Kann so konfiguriert werden, dass es mit Azure-AD-Sicherheitsgruppen und OneNote-Freigabeeinstellungen arbeitet.

Leistungsoptimierung

Beitragsverarbeitung

• Batch-Operationen: Batch-Verarbeitung für umfangreiche Beitrags-Such- und Analysevorgänge konfigurieren

• Ratenbegrenzung: Die Microsoft-Graph-API-Ratenlimits für Viva Engage einhalten

• Caching: Geeignetes Caching für häufig aufgerufene Community-Daten implementieren

Community-Effizienz

• Suchhäufigkeit: Optimale Suchintervalle für die Community-Überwachung konfigurieren

• Inhaltsfilterung: Filter einrichten, um nur relevante Beiträge und Diskussionen zu verarbeiten

• Zeitachsenverarbeitung: Eine korrekte Zeitstempelverarbeitung für Beitragschronologie und Feed-Verwaltung sicherstellen

Nächste Schritte

Nach erfolgreicher Konfiguration des MS Viva Engage Agent:

• Benutzerschulung: Schulungen zu KI-Funktionen für Community-Suche und Diskussionsanalyse bereitstellen

• Integrations-Setup: Integration in bestehende Kollaborations-Workflows konfigurieren

• Überwachung: Überwachung der Agentenleistung und Einblicke in die Community-Beteiligung einrichten

Support und Ressourcen

Für Unterstützung bei der Konfiguration des MS Viva Engage Agent:

• Blockbrain Support: Wenden Sie sich für Hilfe zu bestimmten Funktionen an Ihren Customer Success Manager

• Microsoft-Dokumentation: Nutzen Sie die Microsoft-Graph-API-Dokumentation für detaillierte Informationen zu Berechtigungen

• Azure-AD-Fehlerbehebung: Verwenden Sie die Azure-AD-Anmeldeprotokolle für die Authentifizierungsdiagnose