# MS Viva Engage Agent

<table data-card-size="large" data-column-title-hidden data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Titelbild</th></tr></thead><tbody><tr><td><strong>Übersicht</strong></td><td><ul><li>Beiträge, Diskussionen und Community-Inhalte aus Viva Engage über Blockbrain suchen und abrufen</li><li>Unterhaltungen in allen zugänglichen Communities durchsuchen und analysieren</li><li>Personalisierte Feeds überwachen und organisatorische Kommunikation nachverfolgen</li><li>Benutzer, Experten und Networking-Möglichkeiten innerhalb von Communities entdecken</li><li>Diskussionsinhalte extrahieren und zusammenfassen, um Wissen zu entdecken und Trends zu analysieren</li></ul></td><td><a href="/files/8e2d91078527b6e8c217ab72731c4498aed2fe68">/files/8e2d91078527b6e8c217ab72731c4498aed2fe68</a></td></tr><tr><td><strong>Voraussetzungen</strong></td><td><ul><li>Schließe die <a href="https://docs.en.theblockbrain.ai/for-users/agents">allgemeinen Einrichtungsschritte</a> von der Hauptseite der AI Agents</li><li>Sicherstellen, dass Benutzer über aktive Microsoft Viva Engage-Lizenzen und Community-Zugriff verfügen</li><li>Geeignete Microsoft 365-Lizenzierung für Viva Engage und zugehörige Dienste überprüfen</li><li>Bestätigen, dass Benutzer Mitglieder der relevanten Communities sind, auf die sie zugreifen müssen</li></ul></td><td><a href="/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032">/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032</a></td></tr></tbody></table>

### Konfiguration der Azure-App-Registrierung

#### Erforderliche API-Berechtigungen

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

<table><thead><tr><th width="371.671875">Berechtigung</th><th>Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>offline_access</code></td><td>Delegiert</td><td>Auf Daten zugreifen und diesen Zugriff beibehalten, für die Sie der App Zugriff gewährt haben</td></tr><tr><td><code>openid</code></td><td>Delegiert</td><td>Benutzer anmelden und grundlegende Benutzerprofilinformationen lesen</td></tr><tr><td><a href="https://api.yammer.com/user_impersonation

"><code><https://api.yammer.com/user_impersonation></code></a></td><td>Delegiert</td><td>Viva Engage-Communities, Beiträge und Benutzerdaten im Namen des angemeldeten Benutzers aufrufen</td></tr></tbody></table>

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

{% hint style="info" %}
**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.
{% endhint %}

### Agentenkonfiguration in Blockbrain

<figure><img src="/files/b7a1aa7a2f3a009c537e1ebab44b37287e76993c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e2e31f7e63049257177f27a6a01a5ba3009173d9" alt=""><figcaption></figcaption></figure>

#### 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](#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. 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


---

# 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/ms-viva-engage-agent.md?ask=<question>
```

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.