Das Büro der Nordlicht Reisen GmbH, fünf Personen, alle mit Entra-Konto, alle in Teams, soll den Angebots-Agenten aus T7 dort fragen können, wo es ohnehin arbeitet. Die Frage klingt einfach, beginnt aber mit einer Landschaft, die sich oft umbenannt hat: Copilot, Teams, zwei SDKs, ein Toolkit, ein Portal. Diese Lektion ist die Karte dazu und der Ort, an dem der Kurs acht Entscheidungen für die Kladde trifft und begründet. Alle folgenden Lektionen halten sie; wer eine ändert, sagt es ausdrücklich.

Was Sie mitbringen: T7 „Agenten“ und T8 „MCP“ des KI-Tracks und damit K2; was dort steht, wiederholt dieser Kurs nicht. Er ist keine Schule für Copilot Studio (Low-Code wird abgegrenzt, nicht gelehrt), keine Lizenzberatung und kein Kurs für Office-Add-Ins.

Stand der Prüfung

Diese Lektion enthält keinen Code und nichts, was gebaut oder getestet wurde. Alles Genannte stammt aus Microsoft Learn, beim Schreiben der Lektion gelesen; die Seiten stehen unter „Weiterlesen“. Wo sich zwei Seiten widersprechen oder eine Frage offen bleibt, steht offen. Kein Agent hatte einen Microsoft-365-Mandanten; ab Lektion W7.2.2 sagen Übungen mit Mandant das ausdrücklich.

Zwei Arten von Agenten

Learn unterscheidet zwei Wege, einen Agenten für Microsoft 365 zu bauen:

Deklarativer Agent Agent mit eigener Engine (custom engine agent)
Orchestrator und Modelle die des Copilot Ihre eigenen
Hosting keines nötig, läuft im Copilot außerhalb von Microsoft 365, typisch Azure, „at an additional cost“
Wo er läuft im Copilot und in Microsoft-365-Anwendungen (Teams, Word, Excel, Outlook) in Microsoft 365 und außerhalb
Proaktive Nachrichten nein, nur auf Anfrage ja
Compliance, Verantwortungsvolle KI erbt die von Microsoft 365 liegt bei Ihnen
Anpassung Anweisungen, Wissen, Aktionen volle Kontrolle

Learn rät zum deklarativen Agenten, wenn die Arbeit in Microsoft-365-Anwendungen bleibt und der Orchestrator des Copilot genügt, zur eigenen Engine bei eigener Geschäftslogik, eigenen Modellen, Nutzung außerhalb von Microsoft 365 oder proaktiven Nachrichten. Beide lesen Text, den andere geschrieben haben (Teams-Nachrichten, SharePoint, Werkzeugantworten): Text von außen im Sinn von T6, dessen Abwehr hier nicht noch einmal gelehrt wird.

Vier Wege zum Agenten mit eigener Engine

Die Seite zu den Agenten mit eigener Engine vergleicht vier Wege in einer Tabelle:

Copilot Studio Teams SDK Agents SDK Foundry
Ansatz Low-Code Pro-Code Pro-Code Low- oder Pro-Code
Orchestrator Copilot Studio in der Tabelle: Teams AI Action Planner eigener (z. B. Semantic Kernel, LangChain) eigener
Kanäle Copilot, Teams, Partner-Apps, mobile Apps, Webseiten Copilot, Teams Copilot, Teams, Partner-Apps, mobile Apps, Webseiten Copilot und Teams, weitere nur mit eigener Anbindung
Veröffentlichen Organisation Organisation, Store Organisation, Store, „10+ channels“ Organisation, Store
Sprachen nicht zutreffend C#, TypeScript, JavaScript, Python C#, JavaScript, Python Python, C#

Dazu zwei Angaben der Seite: In den Store des Commercial Marketplace kommen nur Agenten aus Teams SDK, Agents SDK oder Foundry. Und ein Foundry-Agent lässt sich entweder aus dem Foundry-Portal veröffentlichen (Azure Bot Service und Entra ID werden dabei eingerichtet) oder über den Agents Toolkit mit einer eigenen Zwischenschicht anbinden.

  • Agents SDK (Lektion W7.1.2): Gerüst für Kanäle, Zustand und Anmeldung, kein Modell. C#, JavaScript, Python. Kanäle neben Teams: Web-Chat, Slack, Facebook Messenger, Twilio nennt Learn auf der Referenzseite.
  • Teams SDK: Entwicklerwerkzeug für Teams, für TypeScript, C# und Python, mit Teams-eigenen Funktionen (Erwähnungen, Reaktionen, Adaptive Cards, Zitate, Kennzeichnung von KI-Inhalten, Rückmeldung). Learn: Agenten daraus laufen in Teams und im Copilot.
  • Microsoft 365 Agents Toolkit: Vorlagen, automatische Registrierung, Debuggen nach Teams, Outlook und Copilot (Kommandozeile atk). Der Agents Playground prüft einen Agenten lokal, ohne Mandanten.
  • Copilot Studio ist das verwaltete Low-Code-Produkt; der Kurs lehrt es nicht.

Was veraltet ist

Learn ist hier deutlich, und das Datum der Seite zählt mehr als das Gedächtnis eines Teams:

  • TeamsFx wird nicht mehr unterstützt; für neue Arbeit nennt Learn das Teams SDK und die Teams-Entwickler-Kommandozeile. Für die Gemeinschaft nennt Learn eine Frist; prüfen Sie sie, bevor Sie bestehende Projekte planen.
  • Teams AI Library heißt jetzt Teams SDK. Das Bot Framework SDK (BotBuilder) ist als SDK für neue Bots und Agenten nicht mehr unterstützt; der Name „Bot Framework“ bleibt für die Dienste dahinter, etwa Azure Bot Service.
  • Das Teams SDK hat seine eigenen KI-Bibliotheken (ChatPrompt und Verwandte) für veraltet erklärt. Für .NET zeigt Learn die Abstraktionen von Microsoft.Extensions.AI (IChatClient) und einen Agenten-Rahmen eigener Wahl.

Widerspruch: Die Vergleichsseite beschreibt beim Teams SDK noch den „Action Planner“ als eingebauten Orchestrator. Die Seiten des Teams SDK nennen dessen KI-Bibliotheken veraltet. Der Kurs folgt den Seiten des Teams SDK.

Vorschau und Offenes

Gegenstand Was Learn sagt Was der Kurs daraus macht
Agent mit eigener Engine im Copilot dieselbe Manifest-Seite nennt es an einer Stelle „public preview“, an anderer „limited private preview“ offen; vor dem Einsatz bei Microsoft prüfen (Lektion W7.3.1)
Agent Framework im Agents SDK die Seite nennt es „public preview“; T7 benutzt eine Version 1.x offen: Vorschau oder nicht
Name des Playgrounds zwei Pakete und zwei Befehle auf verschiedenen Seiten offen, siehe W7.1.2
Paketversion des Agents SDK 1.6.150 auf der Referenzseite, 1.9.205 auf den API-Seiten eine Version nehmen, alle Pakete gleich

Lesen Sie diese Tabelle vor dem Einsatz neu. Sie ist die Zeile des Kurses, die am schnellsten altert.

Lizenzen und Kosten: Fragen, keine Antworten

Der Kurs nennt keine Preise. Er nennt die Fragen, die ein Betrieb klären muss, nach der Learn-Seite zu Lizenzen und Kosten von Copilot-Erweiterungen:

  1. Welche Lizenz haben die fünf Personen: Microsoft 365 Copilot (Zusatzlizenz) oder Copilot Chat im Abonnement?
  2. Deklarativer Agent: Lizenz oder Copilot-Chat-Zugang nötig. Verbrauchsabrechnung (Copilot Credits) kann entstehen, sobald der Agent Mandantendaten wie SharePoint oder Connectoren nutzt.
  3. Agent mit eigener Engine: Hosting außerhalb, bei Azure etwa App Service, Azure Bot Service, Foundry. Für Personen ohne Copilot-Lizenz kann Verbrauch hinzukommen, wenn der Agent gemeinsame Mandantendaten nutzt.
  4. Modellaufrufe: Sie zahlen Ihre eigenen. Der Deckel gehört in den Betrieb (T10.3 „Budgets und Deckel“).
  5. Entwicklung und Test: Wer hat einen Testmandanten, wer darf Apps hochladen?

Entscheidungsnotiz M-01 bis M-08

Die Kladde bekommt acht Entscheidungen. Jede steht mit ihren Gründen aus Learn; wo ein Grund aus dem Kurs selbst kommt, steht das dabei.

Nr. Entscheidung Gründe
M-01 Gerüst: Microsoft 365 Agents SDK, nicht Teams SDK Derselbe Agent soll später auch im Web-Chat der Kladde laufen; Learn führt den Agents SDK für mehrere Kanäle („10+ channels“, auch Webseiten und Partner-Apps). Das Teams SDK bleibt die Alternative, wenn nur Teams zählt und Teams-eigene Funktionen im Vordergrund stehen.
M-02 Orchestrierung: der ChatClientAgent aus T7, unverändert T7 hat ihn gebaut, getestet und im Code abgesichert; Learn zeigt ihn hinter einer AgentApplication, und das SDK ist ausdrücklich nicht an einen Orchestrator gebunden.
M-03 Kanäle Teams und Copilot-App; Agent mit eigener Engine als Hauptweg, dazu ein deklarativer Agent nur für lesende Fragen an Kladde.Mcp Senden und Freigaben brauchen eigene Regeln, und Learn nennt eigene Logik als Grund für die eigene Engine. Der deklarative Agent läuft im Orchestrator des Copilot.
M-04 Verbindung zum Bot: verwaltete Identität (benutzerzugewiesen) in Azure; Client-Geheimnis nur lokal Learn: Das Client-Geheimnis sei „only for testing and development“, die verwaltete Identität empfohlen für Produktion; K3 3.3.1.
M-05 Die Person kommt aus dem Token, nie aus Text von Nachricht oder Karte; Mandant ist der Entra-Mandant der Nordlicht Reisen GmbH Regel des Kurses aus T7.5 und T8.3: Text ist von außen. Kein Satz von Learn begründet sie; Lektion W7.2.2 zeigt, wo das SDK den Token liefert.
M-06 Graph nur delegiert, nur Calendars.ReadBasic für „Meine Termine der Woche“ (zuerst als Calendars.Read angenommen, in W7.2.2 geändert); keine Anwendungsrechte kleinste Rechte, W4: delegiert, wo es genügt. Siehe Hinweis unten.
M-07 Freigabe als Adaptive Card; der Code bestimmt aus dem Token, wer bestätigt; der Hash des Entwurfs aus T7.3 steht in der Aktion; jede Karte gilt einmal T7.3. Learn: Der AgentApplication kennt Routen für Aktionen von Adaptive Cards; das Teams SDK nennt interaktive Karten als Funktion.
M-08 Sitzungen: je Konversation eine AgentSession (T7.5) in IStorage im Blob-Speicher; 30 Tage, löschbar je Person Learn: MemoryStorage nur für Entwicklung und Test, Blob oder Cosmos DB für Produktion. Die 30 Tage sind eine Annahme des Beispiels, kein Rat.

Hinweise beim Lesen, ohne eine Entscheidung zu ändern:

  • M-01: Ein Grund, der in der Planung stand („Learn zeigt die Verbindung mit Agent Framework gerade für dieses SDK“), trägt weniger, als er klingt: Auch die Seite des Teams SDK für C# zeigt einen Agenten mit IChatClient. M-01 stützt sich auf den ersten Grund, die Kanäle. Sein Preis steht in Lektion W7.2.1: Streaming und die KI-Kennzeichnung sind beim Teams SDK in C# beschrieben, beim Agents SDK für .NET nicht.
  • M-06: Für „List calendarView“ nennt Learn als geringstes Recht (delegiert) Calendars.ReadBasic, Calendars.Read als höheres. M-06 war als Annahme gemeint, die Lektion W7.2.2 gegen Learn prüft. Die Lektion W7.2.2 ändert M-06 deshalb ausdrücklich auf Calendars.ReadBasic; welche Felder das Werkzeug damit noch bekommt, ist dort als offen benannt.
  • M-03: Der deklarative Agent liest nur. Dass der Server die Rechte prüft, bleibt Sache von T8.3.

Die Vorlage für eigene Entscheidungen

Frage:        Wo soll der Agent erreichbar sein, und für wen?
Anforderungen: (Kanäle, Aktionen mit Außenwirkung, Hosting, Betreiber)
Optionen:     (zwei bis vier, mit der Quelle bei Learn)
Entscheidung: ...
Gründe:       (je Grund: gelesen auf Seite X, oder: Regel des Kurses)
Preis:        Was geben wir mit dieser Entscheidung auf?
Offen:        Vorschau, Widersprüche, Lizenzfragen
Neu prüfen:   Wann, und wer?

Der Punkt „Preis“ fehlt in Notizen meist; er macht eine Entscheidung nachvollziehbar und später mit Grund änderbar.

Übung 1: Drei Fälle entscheiden

Ohne Mandanten. Entscheiden Sie für jeden Fall mit der Vorlage: deklarativer Agent oder eigene Engine, und bei der eigenen Engine der Weg.

  1. 12 Personen im Betrieb sollen in Teams Fragen zu Urlaubsregeln stellen. Die Regeln stehen in SharePoint; der Agent soll nur antworten.
  2. Ein Versicherungsmakler will denselben Beratungsagenten in Teams und auf seiner Webseite anbieten, mit eigener Berechnungslogik und eigenem Modell.
  3. Ein Service-Team will, dass ein Agent in Teams auf @-Erwähnungen in Gruppenchats antwortet und Tickets nachschlägt, mit den Modellen des Copilot.

Prüfen Sie: Für jeden Fall steht ein Grund mit Quelle, ein „Preis“ und eine Lizenzfrage.

Lösung 1
  1. Deklarativ. Die Arbeit bleibt in Microsoft 365 (SharePoint, Teams), der Orchestrator des Copilot genügt, Hosting entfällt. Preis: Anpassung nur im Rahmen des Copilot. Lizenzfrage: Hat die Gruppe Zugang zu Copilot Chat; entsteht Verbrauch, weil der Agent SharePoint liest?
  2. Eigene Engine, Agents SDK. Eigene Logik, eigenes Modell, Webseite als zweiter Kanal; Learn führt die Webseite beim Agents SDK. Preis: eigenes Hosting, Verantwortung für Compliance. Lizenzfrage: Hosting und Modellkosten.
  3. Deklarativ. Learn nennt dieses Beispiel (ein Helpdesk-Agent, der auf @-Erwähnungen in Teams antwortet) selbst für den deklarativen Weg. Preis: Werkzeuge nur als Aktionen im Rahmen des Copilot. Ob die Anbindung an das Ticketsystem als Plugin geht, entscheidet Lektion W7.3.2.

Weichen Ihre Antworten ab, ist das in Ordnung, wenn Gründe und Preis stimmen.

Übung 2: Den Stand neu lesen

Ohne Mandanten. Lesen Sie heute die Seiten zu root.copilotAgents, zu „Use Semantic Kernel and Agent Framework in Agents SDK“ und zu „Legacy Teams app and agent development frameworks“ und halten Sie fest: Steht die Vorschau-Angabe noch so wie in der Tabelle? Hat sich ein Name geändert? Was folgt daraus für M-01 bis M-08?

Lösung 2

Eine feste Lösung gibt es nicht, das Ergebnis hängt vom Tag Ihres Lesens ab. Ändert sich nur eine Zeile der Tabelle „Vorschau und Offenes“, ändern Sie die Zeile, nicht die Entscheidung. Eine Entscheidung ändert sich erst, wenn ihr Grund wegfällt, und dann als neue Notiz mit „Neu geprüft, weil …“. Was Sie nicht klären können, bleibt offen mit dem Grund.

Was Sie jetzt können

  • Sie unterscheiden deklarative Agenten und Agenten mit eigener Engine und begründen die Wahl mit Hosting, Orchestrator, Kanälen und Compliance.
  • Sie vergleichen Copilot Studio, Teams SDK, Agents SDK und Foundry nach der Tabelle von Learn.
  • Sie benennen, was veraltet ist, und führen Vorschau und Widersprüche als offen.
  • Sie formulieren Lizenz- und Kostenfragen, statt Preise zu behaupten.
  • Sie lesen die Entscheidungen M-01 bis M-08 samt Gründen und schreiben eine Notiz mit „Preis“ und „Offen“.

Weiterlesen

Die Kladde: Sie haben acht Entscheidungen mit ihren Gründen und wissen, was offen ist. In Lektion W7.1.2 „Ein Agent mit dem Agents SDK“ bauen Sie das Projekt Kladde.M365 und lassen den ersten Agenten ein Echo sprechen.