KI-Agent in Microsoft Teams bereitstellen
Viele Unternehmen haben ihren Arbeitsalltag längst in Microsoft Teams. Ein KI-Agent, der dort antwortet, wo ohnehin gefragt wird, braucht keine neue Oberfläche und keine Schulung für ein weiteres Tool. Dieser Artikel behandelt Teams als Oberfläche für einen eigenen Agenten: Registrierung, App-Paket, Rollout und die Abgrenzung zu Copilot-Agents. Wie ein Agent Daten aus Microsoft 365 liest, steht im Artikel KI-Agent an Microsoft 365 anbinden.
Was bedeutet es, einen KI-Agenten in Teams bereitzustellen?
Einen KI-Agenten in Teams bereitstellen heißt: Ihr Agent läuft auf einem eigenen Server, und Teams leitet Nachrichten der Nutzer per HTTPS an ihn weiter. Nutzer sprechen ihn im Einzelchat, im Gruppenchat oder im Kanal an. Teams liefert Anmeldung, Oberfläche und Verteilung; Modell, Logik und Datenzugriffe bestimmen Sie.
Microsoft sagt es in der Doku zum App-Paket deutlich: Teams hostet Ihre App nicht. Installiert wird nur eine Konfigurationsdatei (das App-Manifest) mit Icons; die eigentliche Logik und die Datenhaltung liegen woanders, während der Entwicklung etwa auf localhost, im Betrieb zum Beispiel in Azure.
Diese Trennung ist der wichtigste Gedanke des ganzen Themas. Sie entscheidet über drei Dinge:
- Wo die Daten verarbeitet werden: auf Ihrem Endpunkt, mit dem Modell, das Sie wählen.
- Was Teams beisteuert: Identität der Nutzer, Chat-Oberfläche, Karten, Rollout und Richtlinien der IT.
- Was Sie betreiben müssen: einen dauerhaft erreichbaren Dienst mit Authentifizierung, Logging und Updates.
Microsoft nennt solche Agenten mit eigenem Modell und eigener Orchestrierung Custom Engine Agents. Laut der Doku bringen Entwickler hier ihre eigene Orchestrierung und eigene KI-Dienste mit und behalten die volle Kontrolle über Abläufe, Modelle und Integrationen.
Custom Engine Agent oder Copilot-Agent: Was ist der Unterschied?
Ein deklarativer Copilot-Agent ist eine Konfiguration aus Anweisungen, Wissensquellen und Aktionen, die auf Microsoft 365 Copilot läuft. Ein Custom Engine Agent bringt Modell, Orchestrierung und Hosting selbst mit. Brauchen Sie volle Kontrolle über Modell, Ablauf oder Oberfläche, verweist Microsoft selbst auf den Custom Engine Agent.
Die Microsoft-Doku zu deklarativen Agents beschreibt sie als zielgerichtete Gesprächserfahrung, die von Microsoft 365 Copilot angetrieben wird. Sie legen Zweck, Anweisungen, Wissen und Aktionen fest; das Modell und die Orchestrierung stellt Microsoft. Genau dort zieht die Doku auch die Grenze: Erfordert die Lösung vollständige Kontrolle über Orchestrierung, Modell, Hosting oder Oberfläche, sollen Sie deklarative und Custom Engine Agents vergleichen.
| Kriterium | Deklarativer Agent | Custom Engine Agent in Teams |
|---|---|---|
| Modell | von Microsoft 365 Copilot | frei wählbar, auch selbst betrieben |
| Orchestrierung | Copilot | eigene (z. B. LangGraph, Semantic Kernel, eigener Code) |
| Hosting | Microsoft | Ihr Server oder Ihre Cloud |
| Gruppenchats und Kanäle | je nach Copilot-Oberfläche | ja, über Bot-Scopes |
| Aufwand | gering, Konfiguration | höher, Softwareprojekt |
Für die Praxis heißt das: Wer Fragen zu Dokumenten aus SharePoint beantworten will und Copilot-Lizenzen ohnehin hat, kommt mit einem deklarativen Agenten schnell weiter. Wer ein bestimmtes Modell einsetzen muss (etwa eines, das im eigenen Rechenzentrum läuft), eigene Werkzeuge aufruft, mehrstufige Abläufe steuert oder den Agenten in Kanälen mehrerer Personen einsetzen will, landet beim Custom Engine Agent. Copilot Studio liegt dazwischen: Low-Code, von Microsoft gehostet, laut Microsoft ebenfalls ein Weg zu Custom Engine Agents.
Wie funktioniert ein KI-Agent in Teams technisch?
Technisch besteht ein Teams-Agent aus vier Bausteinen: einer Bot-Identität in Azure, einem HTTPS-Endpunkt mit Ihrer Agent-Logik, einem App-Paket mit Manifest und Icons sowie der Freigabe durch die Teams-Administration. Teams schickt jede Nachricht als Activity an Ihren Endpunkt, Ihr Code antwortet mit Text, Karten oder einem Stream.
Baustein 1: Bot-Registrierung in Azure
Die Bot-Identität legen Sie als Ressource Azure Bot im Azure-Portal an. Laut Microsoft Learn gibt es drei Arten, die Identität zu verwalten: benutzerseitig zugewiesene verwaltete Identität (User-assigned Managed Identity), Single-Tenant-App und Multi-Tenant-App. Die Neuanlage von Multi-Tenant-Bots ist seit dem 31. Juli 2025 abgekündigt; Microsoft empfiehlt Single-Tenant oder verwaltete Identität. Für deutsche Unternehmen interessant: Beim Anlegen wählen Sie globale oder lokale Datenresidenz, lokal ist laut derselben Seite die Region „westeurope" verfügbar.
Baustein 2: Der Endpunkt mit Ihrer Agent-Logik
Ihr Dienst nimmt Nachrichten unter einem Pfad wie /api/messages entgegen. Dort sitzt alles, was den Agenten ausmacht: Prompt, Modellaufruf, Werkzeuge, Zugriff auf ERP oder Ticketsystem, Protokollierung. Welches Modell Sie verwenden, ist Ihre Entscheidung, solange der Endpunkt per HTTPS erreichbar ist.
Baustein 3: Das App-Paket
Das App-Paket ist eine ZIP-Datei mit der Datei manifest.json und zwei PNG-Icons, einem farbigen und einem Umriss-Icon. Im Manifest stehen Name, Beschreibung, die Bot-ID aus der Azure-Registrierung, die Scopes (persönlich, Gruppenchat, Team) und gegebenenfalls Berechtigungen. Custom Engine Agents werden laut Microsoft ab Manifest-Version 1.21 unterstützt.
Baustein 4: Die Freigabe durch die IT
Ohne Freigabe sieht niemand Ihren Agenten. Wie die Teams-Administration ihn verteilt, beschreibt der Abschnitt zum Rollout weiter unten.
Welche SDKs und Werkzeuge gibt es (Stand November 2026)?
Für neue Teams-Agenten gibt es zwei Pro-Code-SDKs: das Teams SDK, zugeschnitten auf Teams mit Kanälen und Meetings, und das Microsoft 365 Agents SDK für Agenten, die neben Teams auch in Copilot, Websites oder Partner-Plattformen laufen. Das ältere Bot Framework SDK ist nicht mehr unterstützt.
Teams SDK. Laut Microsoft-Übersicht eignet es sich für kollaborative Agenten in Teams-Kanälen und Meetings. Es gibt es für TypeScript, C# und Python. Der Quickstart (Stand 9. Oktober 2026) setzt Node.js ab 22.12, .NET ab 8 bzw. Python ab 3.12 voraus und arbeitet mit der Teams Developer CLI.
Microsoft 365 Agents SDK. Laut Microsoft gedacht für Multi-Channel-Agenten mit eigener Orchestrierung, etwa mit Semantic Kernel oder LangChain, und beliebigen Modellen. Sinnvoll, wenn derselbe Agent nicht nur in Teams erreichbar sein soll.
Bot Framework SDK. Laut dem Hinweis im GitHub-Repository endete der Langzeit-Support im Dezember 2025; Support-Tickets werden seit dem 31. Dezember 2025 nicht mehr bearbeitet, und das Repository ist archiviert. Bestehende Bots laufen weiter, neue Projekte sollten nicht mehr darauf aufbauen.
Copilot Studio und Microsoft Foundry. Copilot Studio ist der Low-Code-Weg mit Hosting durch Microsoft. Wer Agenten bereits in Microsoft Foundry betreibt, kann sie laut Microsoft direkt nach Microsoft 365 und Teams veröffentlichen; dabei werden Azure Bot Service und Entra ID automatisch eingerichtet.
So sieht der Start mit dem Teams SDK aus (Befehle aus dem offiziellen Quickstart, Python-Variante):
# Teams Developer CLI installieren
npm install -g @microsoft/teams.cli
teams --version
# Echo-Agent als Ausgangspunkt anlegen
teams project new python quote-agent --template echo
cd quote-agent
python -m venv .venv && source .venv/bin/activate
pip install -e .
python src/main.py # lauscht auf Port 3978
Haben Sie bereits einen Python-Dienst, binden Sie Teams laut Quickstart über das Paket microsoft-teams-apps ein. Der Nachrichten-Handler ist die Stelle, an der Sie Ihr eigenes Modell aufrufen:
from microsoft_teams.apps import App
app = App()
@app.on_message
async def handle_message(ctx):
# Hier statt Echo: eigenes Modell bzw. eigene Orchestrierung aufrufen
await ctx.send(f"Sie schrieben: {ctx.activity.text}")
Lokal testen Sie ohne Teams mit dem Microsoft 365 Agents Playground. Der Quickstart weist ausdrücklich darauf hin, dass die Option, nicht authentifizierte Anfragen zuzulassen, nur für die lokale Entwicklung gedacht ist und nie in Produktion aktiv sein darf.
Einsatzfelder: Wo lohnt sich Teams als Oberfläche?
Teams als Oberfläche lohnt sich, wenn die Frage dort entsteht, wo ohnehin gearbeitet wird: im Kanal eines Projekts, im Chat mit dem Service, im Austausch vor einem Angebot. Der Agent holt dann Wissen oder Daten heran, ohne dass jemand die Anwendung wechselt.
Persönlicher Assistent im Einzelchat. Mitarbeitende fragen nach dem Stand eines Auftrags, nach einer Prüfvorschrift oder nach einem Lieferschein. Der Agent sucht in den angebundenen Systemen und antwortet mit Quelle. Wie solche Wissensagenten aufgebaut sind, beschreibt die Seite zum Wissensmanagement mit KI-Agenten.
Agent im Projekt- oder Servicekanal. Ein Agent, der in einem Kanal mitliest, kann Tickets zusammenfassen, offene Punkte sammeln oder bei einer Rückfrage zur Maschine passende Einträge aus der Servicehistorie vorschlagen. Beispiele aus dem Service stehen unter KI-Agenten im technischen Service.
Benachrichtigungen und Freigaben. Der Agent meldet sich selbst, etwa wenn ein Angebotsentwurf fertig ist, und bietet in einer Adaptive Card Buttons zum Freigeben oder Zurückweisen. So bleibt der Mensch im Ablauf (Human-in-the-Loop), und die Freigabe ist im Chat dokumentiert. Wie ein Agent Angebote vorbereitet, zeigt die Seite zur Angebotserstellung mit KI-Agenten.
Wann Teams nicht passt: wenn die Nutzer überwiegend außerhalb von Microsoft 365 arbeiten, wenn Kunden oder Lieferanten ohne Gastzugang den Agenten nutzen sollen oder wenn die Aufgabe eine eigene Oberfläche mit Formularen und Tabellen braucht. Dann ist ein Webfrontend oder eine Integration in das Fachsystem meist sinnvoller.
Welche Voraussetzungen brauchen Sie?
Sie brauchen einen Microsoft-365-Tenant mit Teams, Zugriff auf ein Azure-Abonnement für die Bot-Registrierung, einen dauerhaft per HTTPS erreichbaren Endpunkt für Ihre Agent-Logik und eine Person mit Teams-Administratorrechten, die die App freigibt. Dazu kommen Modellzugang und Zugriffe auf die Systeme, aus denen der Agent Antworten zieht.
Im Einzelnen:
- Tenant und Rechte: Teams-Administrator oder Globaler Administrator für den Upload ins Organisationsverzeichnis. Für Tests eine App-Setup-Richtlinie, die Entwicklern den Upload eigener Apps erlaubt, oder ein separater Test-Tenant.
- Azure: Ressource Azure Bot mit Single-Tenant-Identität oder verwalteter Identität, Kanal Microsoft Teams aktiviert, Messaging-Endpunkt eingetragen.
- Hosting: ein Dienst mit gültigem TLS-Zertifikat, Monitoring und Neustart bei Fehlern. Das kann Azure sein, aber auch ein eigener Server, solange Teams ihn erreicht.
- Modell: ein Cloud-Modell mit passendem Vertrag oder ein selbst betriebenes Modell (lokale KI). Bei personenbezogenen Daten gehört die Frage nach Verarbeitungsort und Auftragsverarbeitung an den Anfang, nicht ans Ende.
- Datenzugriffe: Berechtigungen für die Quellsysteme. Liest der Agent Mails, Dateien oder Kalender, läuft das über Microsoft Graph, wie im Artikel zur Anbindung an Microsoft 365 beschrieben.
- Organisation: eine verantwortliche Person für den Agenten, eine Beschreibung, was er darf und was nicht, und je nach Unternehmen die Beteiligung von Datenschutz und Betriebsrat, sobald er Nachrichten von Beschäftigten verarbeitet.
Vorgehen in Schritten: vom Prototyp zum Rollout
Der Weg in Teams folgt fünf Schritten: Agent lokal bauen und testen, Bot in Azure registrieren, App-Paket erstellen, mit einer kleinen Gruppe testen und schließlich über das Teams Admin Center für die Organisation freigeben. Jeder Schritt lässt sich einzeln prüfen und zurückdrehen.
- Lokal bauen. Projekt mit der Teams Developer CLI anlegen, Handler mit eigenem Modellaufruf ergänzen, im Agents Playground testen. Erst wenn die Antworten fachlich stimmen, lohnt sich der Weg in Teams.
- Registrieren. Azure Bot anlegen (Single-Tenant oder verwaltete Identität), Messaging-Endpunkt eintragen, Teams-Kanal aktivieren. App-ID, Tenant-ID und gegebenenfalls Secret in die Konfiguration des Dienstes übernehmen, nie in den Code.
- Paket erstellen. Manifest mit Bot-ID, Scopes und Beschreibung füllen, die zwei Icons beilegen, als ZIP verpacken. Microsoft 365 Agents Toolkit oder das Developer Portal für Teams helfen beim Erzeugen und Validieren.
- Pilotgruppe. Entwickler laden die App im Teams-Client hoch, sofern ihre App-Setup-Richtlinie das erlaubt. Alternativ lädt die IT sie hoch und beschränkt den Zugriff per App-Berechtigungsrichtlinie auf eine Gruppe.
- Rollout. Im Teams Admin Center das Paket hochladen (in der englischen Oberfläche: Teams apps > Manage apps > Upload new app). Die App steht laut Microsoft nach einigen Stunden im Bereich „Built for your org" des Teams-Stores bereit.
Updates spielen Sie auf demselben Weg ein, indem Sie auf der Detailseite der App eine neue Version hochladen. Laut Microsoft gelten die bestehenden Richtlinien für die neue Version weiter. Ändert sich nur die Logik auf dem Server, ist gar kein neues Paket nötig, denn das Paket enthält nur Konfiguration.
Soll der Agent in Kanälen alle Nachrichten sehen und nicht nur die, in denen er erwähnt wird, braucht das Manifest zusätzliche Berechtigungen. Das ist eine bewusste Entscheidung und gehört in den nächsten Abschnitt.
Grenzen und Risiken
Ein Agent in Teams hat Zugriff auf Gespräche, und genau darin liegen die Risiken: zu viele Berechtigungen, unklare Datenflüsse zum Modell, ungeprüfte Antworten in Kanälen mit vielen Lesern und ein Dienst, den jemand dauerhaft betreiben muss. Dazu kommen technische Grenzen der Plattform.
Mitlesen nur mit Zustimmung. Laut Microsoft erhält ein Agent in Gruppenchats und Kanälen standardmäßig nur Nachrichten, in denen er per @-Erwähnung angesprochen wird. Für alle Nachrichten braucht er die ressourcenspezifischen Berechtigungen ChannelMessage.Read.Group bzw. ChatMessage.Read.Chat, und der Besitzer des Teams oder Chats muss bei der Installation zustimmen. Nachrichten anderer Bots, etwa des Workflows-Bots, liefert Teams auch dann nicht aus. Wer mitliest, verarbeitet auch fremde Texte als Eingabe; das öffnet die Tür für Prompt Injection. Ob ein Agent mitlesen soll, ist eine Frage für Datenschutz und gegebenenfalls Betriebsrat, nicht nur für die Entwicklung.
Speicherung von Gesprächen. Laut der Microsoft-Doku zu Custom Engine Agents werden Prompts und Antworten in Copilot Chat und Teams gemäß den Produktbedingungen von Microsoft 365 gespeichert und lassen sich von Admins über Content Search oder Microsoft Purview einsehen. Was Ihr eigener Dienst zusätzlich protokolliert, liegt in Ihrer Verantwortung.
Datenfluss zum Modell. Teams übergibt die Nachricht an Ihren Endpunkt, von dort geht sie an das Modell. Wo dieses Modell läuft, entscheidet darüber, ob der Betrieb datenschutzkonform betreibbar ist. Dieser Artikel ist keine Rechtsberatung; die Bewertung gehört zu Ihrem Datenschutzbeauftragten.
Reihenfolge von Nachrichten. Microsoft weist darauf hin, dass Nachrichten durcheinandergeraten können, wenn ein Agent in einem Zug Streaming, Anhänge und weitere Nachrichten mischt. Empfohlen ist ein einziger Stream pro Nutzeranfrage, der sauber abgeschlossen wird.
Betrieb. Der Agent ist ein dauerhaft laufender Dienst. Fällt er aus, schweigt er in Teams. Zertifikate, Secrets, Modell-Updates und Kosten müssen jemandem gehören; wie man Agenten im Betrieb überwacht, beschreibt der Artikel zu AgentOps.
Abhängigkeit von Microsoft-Änderungen. Microsoft hat das Bot Framework SDK eingestellt, die Teams AI Library laut Teams-Doku in Teams SDK umbenannt und die Neuanlage von Multi-Tenant-Bots abgekündigt. Planen Sie die Teams-Schicht dünn, damit die eigentliche Agent-Logik solche Wechsel übersteht.
Wie fange ich an?
Beginnen Sie mit einer einzigen, klar umrissenen Frage, die heute in Teams oft gestellt wird, und einem Agenten im Einzelchat ohne Mitlese-Berechtigungen. Das hält Datenschutz und Freigabe einfach und zeigt schnell, ob die Antworten taugen. Kanäle, Karten und Benachrichtigungen kommen danach.
Ein pragmatischer Start in drei Etappen:
- Etappe 1: Frage festlegen, Quellen klären, Agent lokal mit dem Teams SDK bauen und im Agents Playground mit echten Beispielfragen testen.
- Etappe 2: Azure Bot (Single-Tenant), Hosting mit HTTPS, App-Paket. Pilot mit fünf bis zehn Personen über eine App-Berechtigungsrichtlinie.
- Etappe 3: Rückmeldungen auswerten, Antwortqualität und Kosten prüfen, dann entscheiden: breiter Rollout, Ausbau auf Kanäle oder Wechsel auf einen deklarativen Agenten, falls sich zeigt, dass Copilot die Aufgabe ebenso gut erledigt.
In unserem eigenen Betrieb hat sich bewährt, die Teams-Anbindung als schmale Hülle um einen Agenten zu bauen, der auch ohne Teams lauffähig und testbar ist. Dann bleibt die Oberfläche austauschbar, und Tests laufen ohne Tenant. Einen Überblick über Agententypen und Einsatzfelder finden Sie auf der Seite zu KI-Agenten.
Häufige Fragen
Brauche ich eine Microsoft-365-Copilot-Lizenz für einen eigenen Agenten in Teams?
Bei einem Custom Engine Agent bringen Sie laut Microsoft eigenes Modell und eigene Orchestrierung mit, statt auf Copilot aufzusetzen. Microsoft nennt Lizenz-, Verbrauchs- und Hostingkosten dennoch als Prüfpunkte, daher die aktuellen Bedingungen vor dem Rollout mit der IT klären.
Liest der Agent automatisch alle Nachrichten in einem Kanal mit?
Nein. Standardmäßig erhält ein Agent in Kanälen und Gruppenchats nur Nachrichten, in denen er per @-Erwähnung angesprochen wird. Für alle Nachrichten braucht er RSC-Berechtigungen im Manifest, denen der Team- oder Chat-Besitzer bei der Installation zustimmt.
Kann ich das Bot Framework SDK noch verwenden?
Bestehende Bots laufen weiter, aber Microsoft hat den Support für das Bot Framework SDK Ende 2025 beendet und das Repository archiviert. Neue Projekte starten mit dem Teams SDK oder dem Microsoft 365 Agents SDK.
Wie lange dauert es, bis ein hochgeladener Agent bei den Nutzern erscheint?
Laut Microsoft ist eine vom Admin hochgeladene App nach einigen Stunden für die Nutzer der Organisation verfügbar. Für Tests einzelner Entwickler ist der Upload im Teams-Client mit passender App-Setup-Richtlinie schneller.
Quellen
- Microsoft Learn: Custom engine agents for Microsoft 365 overview learn.microsoft.com
- Microsoft Learn: Declarative agents for Microsoft 365 Copilot learn.microsoft.com
- Microsoft Learn: Teams SDK Quickstart learn.microsoft.com
- Microsoft Learn: Package your app (Teams) learn.microsoft.com
- Microsoft Learn: Manage custom app policies and settings learn.microsoft.com
- Microsoft Learn: Configure an agent to receive all messages in group chats and channels learn.microsoft.com
- Microsoft Learn: Register a bot with Azure AI Bot Service learn.microsoft.com
- Microsoft Learn: Teams bots overview (Scopes, Umbenennung Teams SDK) learn.microsoft.com
- GitHub: Bot Framework SDK (Retirement-Hinweis) github.com