Überblick über das Microsoft Agent 365 SDK

Das Microsoft Agent 365 SDK verbindet einen Agenten, den Sie bereits besitzen und ausführen, mit Microsoft Agent 365. Nutzen Sie es für Code-Level-Zugriff auf Fähigkeiten wie Agentenidentität, verwaltete Work IQ-Tools oder Benachrichtigungen.

Wo das SDK hingehört

Agent 365 bringt Agenten aus verschiedenen Quellen in eine Control Plane, in der Organisationen sie in großem Maßstab entdecken, steuern und sichern können. Der Integrationspfad hängt davon ab, wo und wie man den Agenten aufbaut:

Agent-Quelle Integrationspfad
Microsoft-Plattformen und -Agenten sowie unterstützte Drittanbieter-Agenten Nutzen Sie die native Agent 365-Integration der Plattform. Diese Agenten können im Agent 365-Inventar erscheinen, ohne das Agent 365 SDK hinzuzufügen.
Agenten, die mit einem SDK oder Framework erstellt wurden, wie zum Beispiel Microsoft 365 Agents SDK, OpenAI Agents SDK, Microsoft Agent Framework, LangChain, CrewAI oder LlamaIndex Füge das Agent 365 SDK zu deinem Agentencode hinzu, um entwicklerintegrierte Funktionen wie Work IQ-Tools oder Benachrichtigungen zu erhalten.
Connected Agent-Plattformen wie Vertex AI oder AWS Bedrock Konfigurieren Sie die Registry-Synchronisation für jede Plattform, um ihre Agenten in das Agent-365-Inventar zu importieren.

Alle drei Wege verbinden Agenten mit Agent 365 und dessen Integrationen mit Microsoft Entra, Microsoft Defender, Microsoft Purview und Microsoft Intune. Native Integration und Registry-Synchronisation bieten nicht unbedingt die gleichen Code-Level-Funktionen wie das Agent 365 SDK. Plattformintegrationen entwickeln sich weiter, daher sollten Sie die aktuellen Plattformrichtlinien bestätigen, bevor Sie eine Integration ändern. Siehe Wähle deine Integrationsoption.

Wie die Fähigkeiten von Agent 365 zusammenpassen

Die Developer Integration von Agent 365 bietet vier Funktionen. Das Agent 365 SDK stellt Identität, Werkzeuge und Benachrichtigungen bereit. Microsoft OpenTelemetry bietet Observability:

Fähigkeit Description
Identity Verwenden Sie eine von Microsoft Entra unterstützte Agentenidentität für sichere Authentifizierung und kontrollierten Zugriff auf Werkzeuge und Daten. Agenten, die ein eigenes Benutzerkonto und Postfach benötigen, stehen nur Mandanten zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen.
Beobachtbarkeit Verwenden Sie die separate Microsoft OpenTelemetry Distro, um Telemetrie zu erzeugen, die geprüfte, nachverfolgbare Interaktionen, Inferenzereignisse und Werkzeugnutzung erzeugt.
Werkzeuge Rufen Sie verwaltete Work IQ Model Context Protocol (MCP)-Server auf, um unter Administratorkontrolle auf Microsoft 365-Workloads wie Mail, Kalender, Word, SharePoint und Teams zuzugreifen.
Benachrichtigungen Empfangen und beantworten Sie Nachrichten aus Teams, Outlook, Word-Kommentaren und E-Mails wie ein menschlicher Teilnehmer in Microsoft 365-Apps. Diese Funktion erfordert das Benutzerkonto eines Agenten und steht nur Mandanten zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen.

Important

Verwenden Sie das veraltete Agent 365 Observability SDK nicht für neue Observability-Integrationen. Verwenden Sie die Microsoft OpenTelemetry Distro. Verwenden Sie weiterhin die Agent 365 SDK-Pakete für Identität, Tools und Benachrichtigungen.

Wählen Sie die Fähigkeiten, die den Anforderungen Ihres Agenten entsprechen, anstatt die gesamte SDK-Oberfläche zu übernehmen. Identität, Werkzeuge und Benachrichtigungen verwenden einen Agenten-Identitätsblueprint als Entra-Grundlage. Benachrichtigungen erfordern außerdem ein Agent-Benutzerkonto. Microsoft OpenTelemetry kann entweder den Agenten-Identitätsblueprint oder eine standardmäßige Microsoft Entra-App-Registrierung verwenden.

Das SDK wird in sprachspezifischen Paketen für Python, JavaScript und .NET ausgeliefert. Installiere das oder die Pakete für die von dir ausgewählten Fähigkeiten und konfiguriere dann die entsprechende Identität, Berechtigungen und Laufzeitintegration. Für die verfügbaren Pakete siehe Agent 365 SDK-Pakete. Installieren Sie Microsoft OpenTelemetry separat für neue Observability-Integrationen.

Vergleichen Sie Microsoft Agent 365 SDK und Microsoft 365 Agents SDK

Microsoft Agent 365 SDK und das Microsoft 365 Agents SDK sind unterschiedliche Produkte.

Microsoft Agent 365 SDK (Dieses SDK) Microsoft 365 Agents SDK
Er erstellt keine Agenten.
Erweitert einen bereits existierenden Agenten, um Identität, Werkzeuge und Benachrichtigungen hinzuzufügen. Verwenden Sie Microsoft OpenTelemetry, um Observabilität hinzuzufügen.		 Ein Framework zum Erstellen von Konversationsagenten.
Verwaltet die Nachrichtenzustellung über Kanäle wie Teams und Microsoft Copilot und verwaltet den Gesprächsstatus.

Diese SDKs arbeiten zusammen. Sie können einen Agenten mit dem Microsoft 365 Agents SDK erstellen, das Agent 365 SDK für Identität, Tools und Benachrichtigungen verwenden und Microsoft OpenTelemetry für Beobachtbarkeit verwenden.

Was es ist und was es nicht ist

Du besitzt weiterhin die drei Ebenen, die den Agenten funktionieren lassen:

Ebene Description
Modell Das Sprachmodell oder die Reasoning-Engine, die von Ihrem Agenten aufgerufen wird. Das SDK ruft oder wählt keine Modelle aus.
Framework oder Laufzeit LangChain, Microsoft Agent Framework, Semantischer Kernel, das OpenAI Agents SDK, das Claude Agent SDK oder benutzerdefinierter Code. Das SDK erstellt weder Agenten noch plant oder orchestriert es Schritte oder führt Tools aus.
Host Überall dort, wo der Agent heute läuft, zum Beispiel bei Azure, AWS, Google Cloud oder On-Premises. Das SDK hostet oder deployt deinen Agenten nicht.

Das Microsoft Agent 365 SDK läuft parallel zu diesen Schichten. Er baut, hostet, deployiert, orchestriert oder führt den Agenten nicht aus.

Note

Das Microsoft Agent 365 SDK registriert verwaltete MCP-Server, sodass Ihr Agent Microsoft 365-Workloads erreichen kann, aber Ihre Laufzeit führt die Toolaufrufe weiterhin aus.

Der Onboarding-Ablauf

Die Integration erfolgt in vier Phasen:

Stage Description
1. Register Erstellen Sie den Agenten-Identitätsblueprint und die Agentenidentität in Microsoft Entra.
2. Erweitern Fügen Sie die Fähigkeiten hinzu, die Ihr Agent benötigt. Verwenden Sie das Agent 365 SDK für Work IQ-Tooling oder Benachrichtigungen und verwenden Sie Microsoft OpenTelemetry für Observability.
3. Validieren Führen Sie den Agenten wie zuvor aus und bestätigen Sie seine Identität, Telemetrie, Werkzeugzugriff und Nachrichtenverarbeitung.
4. Bedienen Nutzen Sie Agent 365 Controls, um den verbundenen Agenten zu steuern und zu auditieren.

Sie können diese Schritte manuell ausführen oder Agent 365 Skills von einem unterstützten Codierassistenten verwenden. Skills leiten das Setup, nehmen die erforderlichen Änderungen vor und validieren das Ergebnis.

Wie eine Anfrage abläuft

Eine einzelne Interaktion kann alle vier Funktionen nutzen. Wenn jemand @mentions deinen Agent in einem Word-Kommentar:

  1. Benachrichtigungen senden die Erwähnung an Ihren Agenten.
  2. Identität und Authentifizierung bestimmen, ob der Agent als er selbst handelt, im Auftrag eines angemeldeten Benutzers oder über ein Agent-Benutzerkonto. Der gewählte Modus, Berechtigungen, Zustimmung und Token-Subjekt definieren, welche Daten und Aktionen verfügbar sind.
  3. Tooling gewährt dem Agenten den Zugriff auf die benötigten Microsoft 365-Daten.
  4. Observability zeichnet die Aufrufe, Werkzeugaufrufe und Modellinferenz auf.

Dein Agent antwortet dann im Kommentarthread.

Agent 365 SDK-Pakete

Finden Sie die Agent 365 SDK-Pakete in den Paketmanagern der unterstützten Sprachen.

Important

Die Observabilitätspakete in den folgenden Tabellen sind veraltet. Nutze sie nicht für neue Integrationen. Nutzen Sie die Microsoft OpenTelemetry Distro oder prüfen Sie die veraltete Agent 365 Observability SDK-Dokumentation, bevor Sie eine bestehende Integration migrieren.

Die Agent 365 SDK-Pakete für Python finden Sie im Python Package Index (PYPI).

Paket Description
Microsoft-Agenten-A365-Benachrichtigungen Benachrichtigungs- und Messaging-Erweiterungen für KI-Agent-Anwendungen. Stellt Hilfsprogramme zum Behandeln von Agentbenachrichtigungen, Lebenszyklusereignissen und Routing über verschiedene Kanäle und Unterkanäle in Microsoft 365 Anwendungen bereit.
microsoft-agents-a365-observability-core Veraltet: Alte Telemetrie-, Tracing- und Überwachungskomponenten für KI-Agenten, die auf OpenTelemetry basieren. Stellt strukturierte Spannen für Agent-Aufrufe, Toolausführung und LLM-Inferenz mit Kontextweitergabe und einsetzbaren Exportern bereit. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.
microsoft-agents-a365-observability-extensions-agent-framework Veraltet: Legacy-Observability-Erweiterungen für das Microsoft Agent Framework. Stellt die OpenTelemetry-Ablaufverfolgungsintegration speziell für Agent Framework-basierte Anwendungen bereit. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.
microsoft-agents-a365-observability-extensions-openai Veraltet: Legacy-Observability-Erweiterungen für das OpenAI Agents SDK. Stellt OpenTelemetry-Ablaufverfolgungsintegration für auf OpenAI-Agents basierende Anwendungen mit automatischer Instrumentierung für Agent-Workflows und Toolaufrufe bereit. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.
microsoft-agents-a365-observability-extensions-langchain Veraltet: Legacy-Observability-Erweiterungen für das LangChain-Framework. Bietet OpenTelemetry-Tracing-Integration für auf LangChain basierende KI-Anwendungen mit automatischer Instrumentierung für Ketten, Agenten und Tools. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.
microsoft-agents-a365-observability-extensions-semantic-kernel Veraltet: Legacy-Observabilitätserweiterungen für das Semantischer Kernel-Framework. Stellt die OpenTelemetry-Tracing-Integration für Anwendungen auf Basis des Semantischer Kernel bereit und bietet automatische Instrumentierung für Kernelfunktionen, Plug-Ins und Planer. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.
microsoft-agents-a365-runtime Kernlaufzeitprogramme und Umgebungsverwaltung für KI-Agent-Anwendungen. Stellt grundlegende Power Platform-API-Ermittlung, Umgebungskonfiguration und Authentifizierungsbereichsauflösung bereit.
microsoft-agents-a365-tooling Kernfunktionen für die MCP-Toolserververwaltung (Model Context Protocol) in Anwendungen, die mit dem Microsoft Agent 365 SDK erstellt wurden. Bietet die Grundlage für das Ermitteln, Registrieren und Verwalten von Toolservern in verschiedenen KI-Frameworks.
microsoft-agents-a365-tooling-extensions-agentframework Agent Framework-spezifische Tools und Dienste für die KI-Agent-Entwicklung. Stellt den MCP-Toolregistrierungsdienst (Model Context Protocol) bereit, um MCP-Server dynamisch zu Agent Framework-Agents hinzuzufügen.
microsoft-agents-a365-tooling-extensions-openai OpenAI Agents SDK-spezifische Tools und Dienste für die KI-Agent-Entwicklung. Stellt den MCP-Toolregistrierungsdienst (Model Context Protocol) für das dynamische Hinzufügen von MCP-Servern zu OpenAI Agents SDK-basierten Agents bereit.
microsoft-agents-a365-tooling-extensions-semantickernel Semantischer Kernel spezifische Tools und Dienste für die KI-Agent-Entwicklung. Stellt den MCP-Toolregistrierungsdienst (Model Context Protocol) bereit, um MCP-Server dynamisch zu Semantischer Kernel-basierten Agents hinzuzufügen.
microsoft-agents-a365-tooling-extensions-azureaifoundry Azure AI Foundry spezifische Tools und Dienste für die KI-Agent-Entwicklung. Stellt den MCP-Toolregistrierungsdienst (Model Context Protocol) bereit, um MCP-Server dynamisch zu Azure AI Foundry Agents hinzuzufügen.

Verwandte Inhalte

  • Zuletzt aktualisiert um