# MS-Teams-Agent
Titelbild
Ü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
/files/8e2d91078527b6e8c217ab72731c4498aed2fe68
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
/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032
### Konfiguration der Azure-App-Registrierung #### Erforderliche API-Berechtigung 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 | | `Calendars.ReadWrite` | Delegiert | Benutzerkalender lesen und schreiben, einschließlich Teams-Besprechungsereignissen | | `Chat.ReadBasic.All` | Delegiert | Die Namen, Beschreibungen und grundlegenden Eigenschaften aller Kanäle in der Organisation lesen — erforderlich für korrektes Kanalrouting und Messaging-Operationen in Teams | | `ChannelMessage.Send` | Delegiert | Nachrichten als Benutzer in einem beliebigen Kanal in Microsoft Teams senden | | `Chat.ReadBasic` | Delegiert | Grundlegende Informationen über die Chats des Benutzers in Teams lesen | | `Chat.ReadWrite` | Delegiert | Alle Chatnachrichten lesen und schreiben, auf die der Benutzer in Teams zugreifen kann | | `Files.Read` | Delegiert | Alle Dateien lesen, auf die der angemeldete Benutzer zugreifen kann, einschließlich in Teams-Kanälen und Chats freigegebener Dateien | | `OnlineMeetings.ReadWrite` | Delegiert | Online-Besprechungen im Namen des Benutzers in Teams lesen und erstellen | | `Presence.ReadWrite` | Delegiert | Die Anwesenheitsinformationen des Benutzers in Teams lesen und aktualisieren | | `Team.ReadBasic.All` | Delegiert | Die Namen, Beschreibungen und grundlegenden Eigenschaften aller Teams in der Organisation lesen | | `User.ReadBasic.All` | Delegiert | Grundlegende Profile aller Benutzer in der Organisation lesen | | `openid` | Delegiert | Melden Sie den Benutzer an und erlauben Sie der App, die grundlegenden Profilinformationen des Benutzers zu lesen | > Alternativ können Sie den `.default` -Bereich verwenden (nutzt alle in der App festgelegten Bereiche). #### Umleitungs-URL * Hinzufügen 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](#required-api-permissions) * 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 --- # 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-teams-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.