# OneNote-Agent
Titelbild
Ü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
/files/8e2d91078527b6e8c217ab72731c4498aed2fe68
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
/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 | | `openid` | Delegiert | Anmelden und Benutzerprofil lesen | | `Notes.Read.All` | Delegiert | Anmelden und das Benutzerprofil lesen | | `User.Read` | Delegiert | Alle OneNote-Notizbücher lesen, auf die der angemeldete Benutzer zugreifen kann | | `Notes.ReadWrite.All` | Delegiert | Alle OneNote-Notizbücher lesen und schreiben, auf die der angemeldete Benutzer zugreifen kann | #### 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](#required-api-permissions) * 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 --- # 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/onenote-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.