Erste Schritte
Installation
- Gehen Sie zu Settings > Integrations und wählen Sie Microsoft Teams aus
- Klicken Sie auf „Connect“
- Sie werden aufgefordert, die Devin-App für Microsoft Teams in Ihrem Tenant und/oder im Ziel-Team zu installieren
- Stellen Sie sicher, dass Sie Ihr persönliches Benutzerkonto verknüpfen. Alle Benutzer in Ihrer Organisation müssen diesen Schritt abschließen, um Devin nutzen zu können
- Erwähnen Sie
@Devinin einem Team-Kanal oder Chat, um eine Sitzung zu starten
Hinweis: Damit Devin für jeden Benutzer funktioniert, muss jede Person ihr eigenes Konto im Devin-Dashboard (Settings > Integrations) verbinden. So kann Devin die Microsoft-Teams-Identität der Person mit ihrem Devin-Benutzer verknüpfen.
Devin in Microsoft Teams verwenden
@Devin in jedem Team-Kanal aufrufen.
Devin antwortet in einem Thread auf Ihre Sitzung. Sie können wie in der üblichen Devin-Chatoberfläche hin und her kommunizieren.
Beachten Sie, dass Devin Fehler machen kann. Bitte überprüfen Sie die Antworten sorgfältig.
Inline-Teams-Keywords & -Funktionen
| Keyword | Function |
|---|---|
!ask | Beginne deine Nachricht mit !ask, um eine schnelle Antwort zur Codebasis zu erhalten, ohne einen vollständigen Agenten zu starten |
!deep | Erhalte eine ausführlichere Antwort mit vertiefter Recherche über die erweiterte Suche |
mute | Verhindert, dass Devin weitere Nachrichten im Thread sieht |
unmute | Macht die obige Aktion rückgängig |
(aside), !aside | Veranlasst Devin, die Nachricht zu ignorieren (nützlich für Kommentare zur Devin-Ausführung direkt im Thread) |
sleep | Versetzt Devin in den Schlaf; um Devin aufzuwecken, sende eine beliebige Nachricht im Thread |
archive | Versetzt Devin in den Schlaf und archiviert zusätzlich die Sitzung |
EXIT | Beendet die Sitzung |
help | Zeigt eine Hilfenachricht mit verfügbaren Keywords und Funktionen |
Preise
Datenschutz
Authentifizierungsablauf
Berechtigungsdetails
Auf einen Blick
- Graph (Application, tenantweit): Erkennung & Orchestrierung der Installation.
- Teams-Bot-RSC (pro Team/Chat): Eingeschränkter Zugriff auf Nachrichten/Mitglieder/Einstellungen ausschließlich dort, wo der Bot installiert oder aktiv ist.
Mandantenweite Microsoft Graph-Berechtigungen (Application)
| Permission | What it allows | Why we need it |
|---|---|---|
Organization.Read.All | Basisprofil der Organisation lesen | Den Mandanten validieren, in dem die App installiert wird |
User.ReadBasic.All | Basisprofile aller Benutzer lesen | Mitgliederidentitäten abgleichen und Erwähnungen in verknüpften Teams auflösen |
AppCatalog.Read.All | Den Teams-App-Katalog lesen | Unsere App finden und die für die Installation erforderliche teamsAppId abrufen |
TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All | Unsere eigene App installieren/deinstallieren; der App RSC erteilen | Den Bot in einem ausgewählten Team über das Devin-Dashboard installieren/entfernen |
Hinweis: Wir verwenden den mandantenweiten Graph-Zugriff nicht, um Nachrichteninhalte zu lesen. Nachrichtenzugriff wird nur über RSC und nur dort gewährt, wo der Bot installiert bzw. vorhanden ist.
Teams Bot Resource-Specific Consent (RSC) Berechtigungen
| Permission | Scope | What it allows | Why we need it |
|---|---|---|---|
ChannelMessage.Read.Group | Team/Channel | Kanalnachrichten lesen, in denen die App installiert ist | Verarbeitung von Kanalkonversationen (Zusammenfassungen, Trigger, Synchronisierung) |
ChannelMessage.Send.Group | Team/Channel | Nachrichten in Kanälen senden (neue Beiträge und Thread-Antworten), in denen die App installiert ist | Auf Nachrichten in Kanal-Threads antworten und proaktiv Updates in Kanälen veröffentlichen |
Member.Read.Group | Team/Channel | Teammitgliedschaft lesen | Identitäten zuordnen, Berechtigungen prüfen, Weiterleitung von Erwähnungen |
TeamSettings.Read.Group | Team/Channel | Team-Einstellungen lesen | Teamweite Richtlinien respektieren und Verhalten anpassen |
ChatMember.Read.Chat | Chat | Chatteilnehmende einsehen | Personen korrekt adressieren/beantworten und Audit-Trails unterstützen |
ChatMessage.Read.Chat | Chat | Nachrichten in Chats lesen, an denen der Bot teilnimmt | Prompts, Kontext und Folgefragen verarbeiten |
ChatMessage.Send.Chat | Chat | Nachrichten in 1:1- und Gruppen-Chats (DMs) senden, an denen der Bot teilnimmt; nicht für Kanäle | Nutzer:innen in DMs und Gruppen-Chats antworten, Benachrichtigungen posten und interaktive Antworten in Chat-Threads senden |
ChatSettings.Read.Chat | Chat | Chat-Einstellungen lesen (z. B. Moderation) | Verhalten an Chatrichtlinien ausrichten (Rate-Limits, wer posten darf etc.) |
RSC-Schutzmaßnahmen: Der Zugriff ist auf das spezifische Team bzw. den spezifischen Chat beschränkt, in dem die App installiert ist oder teilnimmt. Das Entfernen der App aus einem Team/Chat widerruft diesen Zugriff.
Beispiel: Zertifikatbasierte Authentifizierung für die Teams-Erkennung
Hinweis zu Anmeldeinformationen: Wir verwenden ein X.509-Zertifikat (client assertion) anstelle einesclient secretfür die Service-zu-Service-Authentifizierung. Dies gilt für Microsoft-Graph-Aufrufe, die Bot-Kommunikation mit dem Bot Framework Adapter sowie alle App-only-API-Aufrufe aus der Integration.
Vollständiger Nachrichtenverarbeitungsablauf (Teams → Cognition)
Hinweis zu Anmeldeinformationen: Wir verwenden ein X.509-Zertifikat (Client-Assertion) statt eines Client-Secrets für die Dienst-zu-Dienst-Authentifizierung. Dies gilt für Microsoft-Graph-Aufrufe, die Bot-Kommunikation mit dem Bot Framework Adapter und alle App-only-API-Aufrufe aus der Integration.
Zustimmungs- & Installationsablauf
- Admin-Zustimmung (mandantenweit)
- Ein Entra ID-Admin erteilt die oben aufgeführten Graph-Application-Berechtigungen.
- App-Discovery
- Die Integration fragt den Teams-App-Katalog ab, um unsere App zu finden und die
teamsAppIdabzurufen.
- Die Integration fragt den Teams-App-Katalog ab, um unsere App zu finden und die
- Gezielte Installation
- Über unser Dashboard installieren wir den Bot in einem bestimmten Team.
- Während der Installation werden die RSC-Scopes nur für dieses Team gewährt (oder für den entsprechenden Chat, wenn der Bot in einem Chat aufgerufen wird).
- Betrieb
- Discovery (Organisation/Teams/Kanäle/App-Katalog) verwendet Graph-Application-Berechtigungen.
- Das Lesen und Senden von Nachrichten sowie das Lesen von Mitgliedern/Einstellungen basieren auf RSC in den installierten Oberflächen.
Hinweise zum Least-Privilege-Prinzip
- Nur Basisleser:
User.ReadBasic.All(kein mandantenweites Lesen von Nachrichten). - Nachrichteninhalte werden ausschließlich über RSC und nur dort abgerufen, wo der Bot installiert bzw. vorhanden ist.
- Es werden keine Berechtigungen für Postfächer, Dateien oder Kalender angefordert.
Widerruf & Deinstallation
- Adminzustimmung widerrufen: Ein Mandantenadministrator kann die Unternehmens-App-Berechtigungen der App in Entra ID entfernen.
- Aus Teams deinstallieren: Entfernen Sie die App aus einem Team/Chat, um RSC für diese Ressource zu widerrufen.
- Datenverarbeitung: Bei der Deinstallation beendet unsere Integration die Verarbeitung von Ereignissen für dieses Team/diesen Chat und bereinigt zugehörige Abonnements/Verknüpfungen.
