Ü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, wenn Ihr Agent Code-Level-Zugriff auf Agent 365-Funktionen wie Agentenidentität, Observabilität, verwaltete Work IQ-Tools oder Benachrichtigungen benötigt.

Wo das SDK hingehört

Das Integrationsmodell zeigt die Grenze zwischen integrierten Integrationen, Registry-Synchronisation und entwicklerintegrierten Agent-365-SDK-Szenarien.

Agent 365 Integrationsmodell-Diagramm, das zeigt, wo das Agent 365 SDK passt.

Agenten auf Plattformen mit integrierter Agent 365-Integration sowie Agenten, die über Registry-Sync importiert werden, können bereits im Agent-365-Inventar erscheinen. Füge das SDK hinzu, wenn der Agent Funktionen benötigt, die der Plattformpfad nicht bietet und die du im Code konfigurieren musst, wie Observability oder Work IQ Tools. Plattformintegrationen entwickeln sich weiter, daher sollten Sie die aktuellen Plattformrichtlinien bestätigen, bevor Sie entscheiden, dass das SDK erforderlich ist. Siehe Wähle deine Integrationsoption.

Was das SDK hinzufügt

Das SDK bietet vier Funktionen:

Capability 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 Mietern zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen.
Beobachtbarkeit Telemetrie über OpenTelemetrie aussenden, wodurch geprüfte, nachverfolgbare Interaktionen, Inferenzereignisse und Werkzeugnutzung erzeugt werden.
Werkzeuge Aktivieren Sie steuerte Work IQ Model Context Protocol (MCP)-Server, um Microsoft 365-Arbeitslasten wie Mail, Kalender, Word, SharePoint und Teams unter Admin-Kontrolle zu erreichen.
Benachrichtigungen Empfange und beantworte 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 Mietern zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen.

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, während Observability entweder den Agenten-Identitätsblueprint oder eine Standard-Microsoft Entra-App-Registrierung verwenden kann.

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 Funktionen und konfiguriere dann die entsprechende Identität, Berechtigungen und Laufzeitintegration. Für die verfügbaren Pakete siehe Agent 365 SDK-Pakete.

Vergleichen Sie das Microsoft Agent 365 SDK und das Microsoft 365 Agents SDK

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

Microsoft Agent 365 SDK (Dieses SDK) Microsoft 365 Agents SDK
Er baut keine Agenten auf.
Erweitert einen bereits existierenden Agenten, um Identität, Beobachtbarkeit, Werkzeuge und Benachrichtigungen hinzuzufügen.
Ein Rahmenwerk zum Aufbau von Gesprächsagenten.
Verwaltet die Nachrichtenzustellung über Kanäle wie Teams und Microsoft 365 Copilot und verwaltet den Gesprächszustand.

Diese beiden SDKs arbeiten zusammen, sodass man einen Agenten mit dem Microsoft 365 Agents SDK erstellen und dann das Agent 365 SDK nutzen kann, um Identität, Beobachtbarkeit, Werkzeuge und Benachrichtigungen zu erhalten.

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 Argumentations-Engine, die Ihr Agent anruft. 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 baut keine Agenten, plant oder orchestriert keine Schritte und führt keine 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

Die Microsoft Agent 365 SDK-Register steuerten 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. Registrieren Erstellen Sie den Agenten-Identitätsblueprint und die Agentenidentität in Microsoft Entra.
2. Erweitern Fügen Sie die Funktionen hinzu, die Ihr Agent benötigt, wie Observabilität, Work-IQ-Tools oder Benachrichtigungen.
3. Validieren Führen Sie den Agenten wie zuvor aus und bestätigen Sie seine Identität, Telemetrie, Werkzeugzugriff und Nachrichtenverarbeitung.
4. Operieren 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. Fähigkeiten 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, dein Agent in einem Word, kommentiert:

  1. Benachrichtigungen senden die Erwähnung an Ihren Makler.
  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.

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

Package 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 Telemetrie-, Ablaufverfolgungs- 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.
microsoft-agents-a365-observability-extensions-agent-framework Beobachtbarkeitserweiterungen für Microsoft Agent Framework. Stellt die OpenTelemetry-Ablaufverfolgungsintegration speziell für Agent Framework-basierte Anwendungen bereit.
microsoft-agents-a365-observability-extensions-openai Beobachtbarkeitserweiterungen für OpenAI Agents SDK. Stellt OpenTelemetry-Ablaufverfolgungsintegration für auf OpenAI-Agents basierende Anwendungen mit automatischer Instrumentierung für Agent-Workflows und Toolaufrufe bereit.
microsoft-agents-a365-observability-extensions-langchain Beobachtbarkeitserweiterungen für LangChain-Framework. Bietet OpenTelemetry-Tracing-Integration für auf LangChain basierende KI-Anwendungen mit automatischer Instrumentierung für Ketten, Agenten und Tools.
microsoft-agents-a365-observability-extensions-semantic-kernel Observability-Erweiterungen für 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.
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.