Microsoft Agent 365 SDK und CLI

Neu bei Agent 365?

Wählen Sie zuerst Ihre Integrationsoption. Wenn integrierte Integration oder Registry-Sync die benötigten Funktionen bietet, musst du das SDK nicht extra hinzufügen, um deinen Agenten zu registrieren. Für Google Vertex AI und Amazon Bedrock Agenten siehe Google Vertex AI und Amazon Bedrock Agenten registrieren.

Wenn Ihr Agent eine Code-Level-Integration benötigt, wählen Sie einen Pfad basierend auf Ihrem Ausgangspunkt und dem gewünschten Ergebnis:

Ihr Ausgangspunkt	Beginne hier	Erstes Ergebnis	Bevor Sie anfangen
Du hast einen Agenten und möchtest KI-unterstütztes Onboarding.	Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365 mithilfe von Agent 365 Skills.	Registrieren Sie den Agenten, fügen Sie die von Ihnen gewählten Funktionen hinzu und überprüfen Sie die Integration.	Überprüfen Sie die unterstützten Stacks, Coding-Assistenten, Mandantenzugriffe, Rollen und Lizenzanforderungen.
Du hast einen Agenten und möchtest selbst CLI-Befehle ausführen.	Erstelle einen Agenten-Blueprint.	Erstellen Sie den Bauplan, der die Identität und Berechtigungen Ihres Agenten definiert.	Überprüfen Sie die Anforderungen an die CLI, die Tenant-Rolle und das Azure-Abonnement und verwenden Sie dann Agentenidentität, um das Identitätsmodell auszuwählen.
Du möchtest mit einem Beispielprojekt lernen, anstatt deinen eigenen Agenten zu wechseln.	Wählen Sie eine Probe in Python, Node.jsoder .NET.	Konfigurieren Sie ein Beispiel und erhalten Sie eine erste Antwort im Agents Playground.	Überprüfen Sie die ausgewählten Quickstart- oder Beispiel-README-Voraussetzungen, einschließlich Laufzeit, Modellzugriff und Authentifizierungseinstellung.

Für den Beispielpfad verlinkt der Katalog zu den Quickstarts für Python + Microsoft Agent Framework, Node.js + LangChain und Node.js + Claude Agent SDK sowie zu einem .NET-Beispiel. Wählen Sie Ihre Sprache im Katalog, um die verfügbaren Frameworks zu sehen.

Note

Eine lokale Antwort ist kein Beweis dafür, dass Live-Microsoft 365-Tools, Benachrichtigungen oder Telemetrie funktionieren. Für tenant-gestützte Funktionen überprüfen Sie den Tenant, die Zustimmung und die Lizenzanforderungen sowie die Test-Authentifizierungseinrichtung.

Agent 365 SDK

Nutzen Sie das Agent 365 SDK, um Agenten, die mit jedem Agent-SDK oder jeder Plattform erstellt wurden, mit Identität, Benachrichtigungen, Sicherheit und reguliertem Zugriff auf Microsoft 365-Daten zu erweitern. Verwenden Sie Microsoft OpenTelemetry für Observability.

Tip

Suchen Sie nach vordefinierten Agenten? Sehen Sie sich die in Agent 365 verfügbaren Ökosystempartneragenten an, die bei der Einführung vorintegriert sind.

Agenten haben einzigartige Identitäten. Benutzer rufen sie mit allgemeinen Gesten auf (z. B. @mentions) in Apps, in denen Unternehmensbenutzer normalerweise arbeiten (z. B. Teams, Word, Outlook und mehr). Sie zeigen beobachtbare Verhaltensweisen, die Vertrauen aufbauen, überprüfbare Maßnahmen ergreifen und dies durch sicheren Zugriff auf Werkzeuge und Daten tun.

Mit dem Agent 365 SDK können Agenten:

• Nutzen Sie Entra-gestützte Agentenidentität mit eigenen Benutzerressourcen wie einem Postfach für sichere Authentifizierung und kontrollierten Zugriff auf Werkzeuge und Daten.
• Empfangen und Beantworten von Benachrichtigungen von Teams, Outlook, Word Kommentaren und E-Mails – genau wie ein menschlicher Teilnehmer an Microsoft 365 Apps.
• Erreichen Sie vollständige Beobachtbarkeit über Open Telemetry, was geprüfte, nachverfolgbare Agenteninteraktionen, Inferenzereignisse und die Nutzung von Werkzeugen ermöglicht.
• Rufen Sie governed Model Context Protocol (MCP)-Server auf, um auf Microsoft 365 Workloads (z. B. Mail, Kalender, SharePoint, Teams) unter Administratorsteuerung zuzugreifen.
• Arbeiten Sie innerhalb eines IT-zugelassenen Blueprint-Systems und stellen sicher, dass jede Agenteninstanz Compliance-, Governance- und Sicherheitsrichtlinien erbt.

Sehen Sie sich die Übersicht des Agent 365 SDK an.

Agent 365 CLI

Agent 365 CLI ist das Befehlszeilen-Backbone für Agent 365 während des gesamten Lebenszyklus der Agententwicklung – Das Automatisieren von Setup, Identität, Konfiguration, MCP-Integration, Veröffentlichung und Azure Bereitstellung für unternehmensfähige Agents.

Mit der Agent 365 CLI können Entwickler:

• Erstellen Sie Agenten-Baupläne und alle von ihnen benötigten unterstützenden Ressourcen.
• Verwalten Sie sofort einsatzbereite und benutzerdefinierte Work-IQ-Werkzeuge, Berechtigungen und Tools für Agenten.
• Stellen Sie Agentcode für Azure bereit.
• Veröffentlichen Sie Agent-Anwendungspakete im Microsoft Admin Center.
• Bereinigen Sie Agent-Blueprints, -Identitäten und andere Azure Ressourcen, die von der CLI erstellt wurden.

Erfahren Sie mehr über die Agent 365 CLI

Agent 365 Agentenentwicklungszyklus

Agent 365 funktioniert mit Agenten, die auf jedem Agent-SDK oder jeder Plattform basieren. Dazu gehören Low-Code-Plattformen wie Copilot Studio und Azure AI Foundry . Es unterstützt außerdem Pro-Code-Optionen wie das Microsoft Agent Framework, Microsoft Agents SDK, OpenAI Agents SDK, Claude Code SDK und LangChain SDK. Agent 365 arbeitet auch mit Agentcode, der auf jedem Endpunkt gehostet wird, sei es Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) oder einem anderen Cloudanbieter.

Der Quickstart des bestehenden Agenten umfasst die Registrierung, ausgewählte Fähigkeiten und die Validierung. Deployment, Publishing und Cleanup haben separate Anleitungen. Fahren Sie mit den Phasen fort, die für Ihr Szenario gelten:

Phase	Guide
Validiere die Integration vor der Bereitstellung.	Agent 365 SDK Validierungscheckliste und testen Sie Ihren Agenten.
Stelle deinen Agentencode bereit.	Azure, AWS oder Google Cloud Platform.
Erstellen und veröffentlichen Sie das Paket des Agenten.	Veröffentlichen Sie den Agenten im Microsoft Admin Center.
Erstellen und verifizieren Sie eine Instanz des bereitgestellten Agenten.	Erstellen Sie Agenteninstanzen und testen Sie Ihren deployierten Agenten.
Entferne Ressourcen, die du nicht mehr brauchst.	CLI-Referenz zur Bereinigung, einschließlich granularen Bereinigungsoptionen und Testlauf-Optionen.

Agent 365 Agenten-Bauplan

Bevor man mit Instanzen von Agent-365-Agenten arbeitet, ist es hilfreich zu verstehen, was wir mit dem Bauplan eines Agent-365-Agenten meinen. Dies stammt aus Microsoft Entra-Agent-Blueprint und ist eine IT-genehmigte, vorkonfigurierte Definition eines Agenttyps, im Wesentlichen die Enterprise-"Vorlage", aus der kompatible Agents erstellt werden können. Er definiert die Funktionen des Agents, den erforderlichen Zugriff auf Arbeits-IQ-Tools, Sicherheits- und Complianceeinschränkungen, Überwachungsanforderungen, Lebenszyklusmetadaten und alle verknüpften Governancerichtlinienvorlagen wie DLP, Einschränkungen für den externen Zugriff oder Protokollierungsregeln. Wenn ein Blueprint für die Nutzung in einem Mandanten aktiviert wird, können Benutzer ihre Administratoren um die Erstellung neuer Agentinstanzen aus dem Agent-Blueprint im Microsoft 365 Admin Center bitten. Jede Agentinstanz erbt die Regeln ihres Blueprints und stellt eine konsistente Governance für E-Mails, Kalender, Teams, SharePoint-Zugriffe und alle anderen Microsoft 365 Workloads sicher, die der Agent berührt. Dies verhindert Schatten-/Rogue-Agenten, erzwingt Beobachtbarkeit und verankert jeden Agenten in einem sicheren, von Entra unterstützten Identitäts- und Berechtigungsmodell.

Worin unterscheidet sich das Agent 365 SDK?

Das Agent 365 SDK unterscheidet sich von Agenten-Frameworks wie dem Microsoft Agent Framework oder Microsoft Copilot Studio, da es keine Agenten erstellt oder hostet. Stattdessen verbessert es bereits gebaute Agenten, unabhängig vom zugrunde liegenden Stack, indem Unternehmensfähigkeiten wie Entra-basierte Agentenidentität, der Zugriff auf das Work IQ-Tool, Benachrichtigungen über das Activity-Protokoll und Agent-ID-gesteuerte Governance hinzugefügt werden. Verwenden Sie Microsoft OpenTelemetry für Observability.

Obwohl der Name sehr ähnlich ist, ersetzt es nicht die Microsoft 365 Agents SDK und die Funktionalität, die es für Hosting, Aktivitätsprotokoll und Identität bereitstellt. Im Gegensatz dazu ergänzt das Agent 365 SDK es, indem es Governance, Compliance und Lebenszykluskontrollen auf Agenten legt, die mit ihm oder anderen Plattformen entwickelt wurden.

Agent 365 SDK und das Agenten-Ökosystem

Diese Tabelle fasst die geschichtete Agentenarchitektur zusammen und zeigt, wie das Agent 365 SDK die Unternehmensfähigkeiten über Ihre Agentenlogik und die von Ihrem gewählten Framework bereitgestellte LLM-Orchestrator-Laufzeit erweitert.

Ebene	Role	Bereitgestellt von
Unternehmensfunktionen	Identität, Benachrichtigungen und Werkzeuge vom Agent 365 SDK; Observabilität von Microsoft OpenTelemetry	Agent 365 SDK und Microsoft OpenTelemetry
Agent-Logik	Eingabeaufforderungen, Workflows, Schlussfolgerungen	Deine Implementierung im Code
LLM-Orchestrator-Laufzeit	Modellaufrufe und Tool-Orchestrierung	Agent SDK/Framework Ihrer Wahl

Nächste Schritte

Verbinden Sie einen bestehenden Agenten mit Agent 365