MS Teams-Agent

Übersicht

• Teams-Nachrichten, Chats und Kanalunterhaltungen über Blockbrain suchen und abrufen

• Nachrichten an Teams-Kanäle oder Chats senden

• Auf Teams-Besprechungen zugreifen und sie verwalten, einschließlich Planung und Beitritt

• In Teams-Kanälen gespeicherte Dateien abrufen und freigeben

• Auf Metadaten von Teams, Kanälen und Benutzern für Zusammenarbeit und Automatisierung zugreifen

• Workflows und Benachrichtigungen in Microsoft Teams automatisieren

Voraussetzungen

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

• Stellen Sie sicher, dass Benutzer aktive Microsoft-365-Konten mit Zugriff auf Microsoft Teams haben

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

Konfiguration der Azure-App-Registrierung

Erforderliche API-Berechtigung

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

Alternativ können Sie den .default -Bereich verwenden (nutzt alle in der App festgelegten Bereiche).

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 > MS Teams 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):

   • Fügen Sie bei Bedarf benutzerdefinierte Schlüssel-Wert-Paare für bestimmte Anforderungen des MS Teams Agent hinzu

   • Konfigurieren Sie bei Bedarf organisationsspezifische Einstellungen

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. Erteilen Sie in Azure die Admin-Zustimmung für alle erforderlichen Microsoft-Graph-Berechtigungen

2. Verwenden Sie in der Blockbrain-Konfiguration den .default Bereich anstelle einzelner Bereiche

3. Dadurch entfällt für Benutzer die Notwendigkeit, einzelnen Berechtigungen zuzustimmen

Den MS Teams Agent 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 Sie, auf einen bekannten Teams-Kanal, Chat oder eine Besprechung zuzugreifen

   • Überprüfen Sie die Funktionalität zum Senden von Nachrichten, Abrufen von Chats und den Zugriff auf Besprechungen

3. Berechtigungsvalidierung:

   • Überprüfen Sie, ob der Agent auf die entsprechenden Teams, Kanäle und Chats zugreifen kann

   • Bestätigen Sie, dass die Lese-/Schreibberechtigungen korrekt funktionieren

Häufige Anwendungsfälle für die MS-Teams-Integration

• Nachrichtensuche: Nachrichten in Teams-Kanälen und Chats finden und abrufen

• Nachrichten senden: Nachrichten über den Agenten an Kanäle oder Chats senden

• Besprechungsverwaltung: Teams-Besprechungen aufrufen, erstellen oder aktualisieren

• Dateizugriff: In Teams-Kanälen oder Chats freigegebene Dateien abrufen

• Anwesenheit & Benutzerinfos: Benutzeranwesenheit lesen und aktualisieren, auf Benutzer- und Team-Metadaten zugreifen

Fehlerbehebung

Authentifizierungsprobleme

Problem: „Unzureichende Berechtigungen“ beim Zugriff auf Teams-Ressourcen

• Lösung: Stellen Sie sicher, dass die App-Registrierung alle erforderlichen Teams- und Chat-Berechtigungen hat (z. B. Chat.ReadWrite, ChannelMessage.Send).

• Prüfen Sie: Stellen Sie sicher, dass der Benutzer in Ihrer Organisation Zugriff auf die relevanten Teams, Kanäle oder Chats hat.

Berechtigungsfehler

Problem: „Unzureichende Berechtigungen“ beim Zugriff auf SharePoint

• Lösung: Stellen Sie sicher, dass die App-Registrierung Sites.Read.All und Files.Read.All Berechtigungen hat

• Prüfen Sie: Stellen Sie sicher, dass der Benutzer in Ihrer Organisation Zugriff auf SharePoint 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

• Datenzugriff: Der Agent übernimmt die Teams- und Microsoft-365-Berechtigungen des Benutzers

• Bereichsbeschränkung: Der Zugriff ist auf Teams, Kanäle und Chats beschränkt, auf die der authentifizierte Benutzer zugreifen kann

• Datenschutz: Daten werden gemäß den Datenverarbeitungsrichtlinien von Blockbrain verarbeitet

• Prüfprotokoll: Der Zugriff auf Teams wird sowohl in Azure AD als auch in den Prüfprotokollen von Microsoft 365 protokolliert

Nächste Schritte

Nach erfolgreicher Konfiguration des MS Teams Agent:

• Schulen Sie Benutzer in den Funktionen der MS-Teams-Integration

• Konfigurieren Sie bei Bedarf zusätzliche Agenten (z. B. SharePoint, Outlook)

• Überwachen Sie Nutzung und Leistung über Azure-AD-Berichte