For the complete documentation index, see llms.txt. This page is also available as Markdown.

MS Viva Engage-Agent

Diese Seite enthält detaillierte Konfigurationsanweisungen für den MS Viva Engage-Agenten, der eine umfassende Integration mit Viva Engage für Communities, Beiträge und organisatorische Diskussionen ermöglicht

Cover

Übersicht

  • Beiträge, Diskussionen und Community-Inhalte aus Viva Engage über Blockbrain suchen und abrufen

  • Unterhaltungen in allen zugänglichen Communities durchsuchen und analysieren

  • Personalisierte Feeds überwachen und organisatorische Kommunikation nachverfolgen

  • Benutzer, Experten und Networking-Möglichkeiten innerhalb von Communities entdecken

  • Diskussionsinhalte extrahieren und zusammenfassen, um Wissen zu entdecken und Trends zu analysieren

Cover

Voraussetzungen

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

  • Sicherstellen, dass Benutzer über aktive Microsoft Viva Engage-Lizenzen und Community-Zugriff verfügen

  • Geeignete Microsoft 365-Lizenzierung für Viva Engage und zugehörige Dienste überprüfen

  • Bestätigen, dass Benutzer Mitglieder der relevanten Communities sind, auf die sie zugreifen müssen

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

Benutzer anmelden und grundlegende Benutzerprofilinformationen lesen

Delegiert

Viva Engage-Communities, Beiträge und Benutzerdaten im Namen des angemeldeten Benutzers aufrufen

Schritte zur Berechtigungskonfiguration

  1. Gehen Sie in Ihrer Azure-App-Registrierung zu API-Berechtigungen

  2. Klicken Sie auf „Berechtigung hinzufügen“ > APIs, die meine Organisation verwendet

  3. Suchen und auswählen nach "Yammer" oder "Microsoft Viva Engage"

  4. Wählen Sie Delegierte Berechtigungen

  5. Suchen und auswählen nach "user_impersonation"

  6. Klicken Sie auf „Berechtigungen hinzufügen“

  7. Klicken Sie auf „Admin-Zustimmung erteilen“ (empfohlen für organisationsweite Bereitstellung)

Hinweis: Viva Engage verwendet den Yammer-API-Endpunkt (https://api.yammer.com/user_impersonation) statt Microsoft Graph-Berechtigungen. Diese Berechtigung ermöglicht es der Anwendung, im Namen des angemeldeten Benutzers auf Viva Engage zuzugreifen.

Agentenkonfiguration in Blockbrain

Konfigurationsschritte

  1. Agenteneinstellungen aufrufen:

    • Navigieren Sie zu Ihrem Blockbrain-Admin-Panel

    • Gehen Sie zu Agents > MS Viva Engage 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. In Azure die Admin-Zustimmung für alle erforderlichen Viva Engage-Berechtigungen erteilen

  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 MS Viva Engage Agent

Überprüfungsschritte

  1. Authentifizierungstest:

    • Verwenden Sie das integrierte Verbindungstest-Tool von Blockbrain

    • Erfolgreichen OAuth-Ablauf mit der Viva Engage-API überprüfen

  2. Community-Zugriff:

    • Das Auflisten verfügbarer Communities testen

    • Community-Mitgliedschaft und Berechtigungen überprüfen

    • Den Zugriff auf öffentliche und private Communities prüfen

  3. Beitragsuche & Entdeckung:

    • Nach Beiträgen mithilfe von Schlüsselwörtern suchen

    • Den Abruf von Beitragsinhalten überprüfen

    • Den Zugriff auf den Feed und das Filtern testen

  4. Benutzerinformationen:

    • Benutzerprofilinformationen abrufen

    • Die Benutzerauflistung innerhalb von Communities überprüfen

    • Networking und Expertise-Entdeckung prüfen

Häufige Viva-Engage-Integrationsanwendungsfälle

Community-Verwaltung

  • Diskussionsanalyse: KI-gestützte Analyse von Community-Unterhaltungen

  • Inhaltserkennung: Relevante Beiträge und Diskussionen in Communities finden

  • Engagement-Tracking: Community-Aktivität und Teilnahmelevels überwachen

Wissensextraktion

  • Best-Practice-Mining: Bewährte Methoden und erfolgreiche Ansätze aus Diskussionen extrahieren

  • Entscheidungsverfolgung: Wichtige organisatorische Entscheidungen identifizieren und zusammenfassen

  • Expertise-Mapping: Fachexperten und Vordenker entdecken

Community-Überwachung

  • Feed-Analyse: Personalisierte Feeds auf wichtige Aktualisierungen überwachen

  • Trenderkennung: Aufkommende Themen und wiederkehrende Muster erkennen

  • Organisatorische Aktualisierungen: Unternehmensankündigungen und Richtlinienänderungen nachverfolgen

Fehlerbehebung

Authentifizierungsprobleme

Problem: OAuth-Authentifizierungsfehler

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

  • Prüfen Sie: Sicherstellen, dass die Admin-Zustimmung für die Viva-Engage-Benutzervertretung erteilt wurde

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

Community-Berechtigungsfehler

Problem: Kein Zugriff auf Communities oder Beiträge möglich

  • Lösung: Bestätigen, dass der Benutzer über eine aktive Viva-Engage-Lizenz und Community-Zugriff verfügt

  • Prüfen Sie: Überprüfen, dass der Benutzer Mitglied der Communities ist, auf die er zugreifen möchte

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

Probleme bei der Beitragssuche

Problem: Die Suche liefert keine Ergebnisse oder nur eingeschränkte Inhalte

  • Lösung: Sicherstellen, dass der Benutzer die Berechtigung hat, die Communities mit relevanten Beiträgen anzuzeigen

  • Prüfen Sie: Überprüfen, ob die Suchbegriffe angemessen und nicht zu spezifisch sind

  • Testen: Breitere Stichwortsuchen ausprobieren, um die Suchfunktionalität 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

  • Community-Sicherheit: Alle Viva-Engage-Community-Daten werden gemäß den Sicherheitsrichtlinien von Blockbrain verarbeitet

  • Beitragsdatenschutz: Der Community-Zugriff berücksichtigt die Datenschutzeinstellungen der Benutzer und die Community-Berechtigungen

  • Vertraulichkeit von Diskussionen: Beitrags- und Kommentardaten werden mit geeigneten Vertraulichkeitsmaßnahmen verarbeitet

Compliance-Aspekte

  • DSGVO-Konformität: Die Verarbeitung von Viva-Engage-Beitrags- und Community-Daten erfüllt die DSGVO-Anforderungen

  • Datenaufbewahrung: Geeignete Aufbewahrungsrichtlinien für Community-Beiträge und Benutzerinteraktionen konfigurieren

  • Audit-Logging: Alle Aktivitäten des Viva-Engage-Agents werden für Compliance-Berichte protokolliert

Zugriffskontrolle

  • Benutzerberechtigungen: Der Agent übernimmt die Viva-Engage-Community-Berechtigungen des authentifizierten Benutzers

  • Community-Zugriff: Beachtet die Zugriffsbeschränkungen für private und öffentliche Communities

  • Sicherheitsgruppen: Kann so konfiguriert werden, dass es mit Azure-AD-Sicherheitsgruppen und Community-Mitgliedschaften funktioniert

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

Zuletzt aktualisiert