Dieser Artikel beantwortet häufige Fragen zum Agent 365 SDK: Was es kann und nicht, wann Sie es benötigen, welche Funktionen verfügbar sind, wie Identität funktioniert und wie man eine Integration validiert.
Umfang und Positionierung
Kann ich einen Agenten mit dem Agent 365 SDK erstellen?
No. Das SDK ist kein Agenten-Framework. Baue deinen Agenten mit deinem gewählten Framework und nutze dann das Agent 365 SDK, um ihn in Agent 365 zu integrieren. Sehen Sie, wann Sie das Agent 365 SDK verwenden sollten.
Macht das SDK Sprachmodellaufrufe oder orchestriert Schritte?
No. Dein Agent macht weiterhin eigene Modellaufrufe, und die Orchestrierung bleibt in deinem Framework oder Laufzeitbereich. Siehe Agent 365 SDK und das Agenten-Ökosystem.
Hostet oder deployt das SDK meinen Agenten?
No. Ihr Makler läuft heute überall hin, wo er tätig ist. Sieh mal: Wie unterscheidet sich das Agent 365 SDK?
Führt das SDK die Toolaufrufe meines Agenten aus?
No. Die SDK-Register steuerten die Model Context Protocol (MCP)-Server; Die Ausführung bleibt in deiner Laufzeit. Siehe Agent 365 SDK und das Agenten-Ökosystem.
Ersetzt das SDK mein Agenten-Framework?
No. Behalte dein Modell, Framework oder Laufzeit und Host. Das SDK läuft parallel dazu und fügt Identität, Observabilität, Tools und Benachrichtigungen hinzu. Für die Schicht-für-Schicht-Grenze siehe Agent 365 SDK Übersicht.
Wie unterscheidet sich das Agent 365 SDK vom Microsoft 365 Agents SDK?
Das Microsoft 365 Agents SDK entwickelt Konversationsagenten und verwaltet Kanalkonnektivität und Konversationszustand. Das Agent 365 SDK erweitert einen Agenten, den du bereits gebaut hast. Die beiden arbeiten zusammen. Siehe Agent 365 SDK Übersicht.
Welche Sprachen unterstützt das SDK?
Python, JavaScript und .NET. Siehe Agent 365 SDK-Pakete.
Wahl eines Integrationsmechanismus
Brauche ich das SDK?
Nicht immer. Wenn integrierte Integration oder Registry-Synchronisation bereits die benötigten Funktionen Ihres Agenten bietet, benötigen Sie das SDK möglicherweise nicht. Siehe Wähle deine Integrationsoption.
Wann reicht eine integrierte Integration aus?
Wenn der Plattformpfad bereits die Agent-365-Funktionen bietet, die in deinem Szenario erforderlich sind. Copilot Studio und Azure AI Foundry können in diese Kategorie fallen, aber die Unterstützung hängt davon ab, wie der Agent gebaut, authentifiziert und gehostet wird. Das Besitzen oder Bereitstellen von Code erfordert an sich kein SDK. Siehe Compare Agent 365 Integrationsmechanismen.
Was ist der Unterschied zwischen Registry-Synchronisation und SDK-Integration?
Registry Sync bringt Agenten von verbundenen Agentenplattformen wie Google Vertex AI und Amazon Bedrock über plattformnahe Konfiguration in Agent 365. SDK-Integration ist für Agenten, die du mit einem Agenten-SDK oder Framework baust, und sie gibt dir Code-Level-Kontrolle. Siehe Compare Agent 365 Integrationsmechanismen.
Mein Agent arbeitet außerhalb von Azure. Kann ich das SDK trotzdem verwenden?
Yes. Das SDK ändert nicht, wo dein Agent läuft. Es funktioniert mit Agenten, die auf Azure, AWS, Google Cloud oder On-Premises gehostet werden. Siehe Agent 365 Agent Development Lifecycle.
Fähigkeiten
Muss ich alle vier Fähigkeiten übernehmen?
Nein, aber sie haben Voraussetzungen. Ein Agenten-Identitätsblueprint bildet die Grundlage für Identität, Werkzeuge und Benachrichtigungen, und Benachrichtigungen erfordern zusätzlich das Benutzerkonto eines Agenten, das nur Mietern zur Verfügung steht, die am Frontier-Vorschauprogramm teilnehmen. Observability funktioniert auch mit einer standardmäßigen Microsoft Entra-App-Registrierung. Darüber hinaus füge Fähigkeiten in beliebiger Reihenfolge hinzu. Siehe Benachrichtigungen überprüfen.
Mit welcher Fähigkeit sollte ich anfangen?
Identität: Die Registrierung macht den Agenten in Agent 365 sichtbar, also fang damit an. Fügen Sie als Nächstes Beobachtbarkeit hinzu, wenn Sie operative Sichtbarkeit benötigen. Siehe Agent und Instrument registrieren für Beobachtbarkeit.
Wohin geht meine Telemetrie?
Agentenspannweiten erscheinen in Microsoft Defender, Microsoft Purview und im Microsoft 365 Admin Center.
Zwei Dinge können Telemetrie so aussehen lassen, als wäre sie verschwunden, obwohl die Eingabe HTTP 200 zurückgibt.
Wenn kein Nutzer im Tenant eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen hat, wird die gesamte Anfrage eingestellt.
Wenn der Run keine gültige invoke_agent Spannweite an seiner Wurzel hat, sind die Spans in Defender Advanced Hunting weiterhin abfragbar, erscheinen aber in keiner der drei Oberflächen.
Sieh dir an, wo deine Daten angezeigt werden , sowie Limits und Drop-Bedingungen.
Was ist Work IQ?
Work IQ ist die Gruppe von verwalteten MCP-Servern, die Microsoft 365-Arbeitslasten wie Mail, Kalender, Word, SharePoint und Teams unter Administratorkontrolle an Ihren Agenten bereitstellen. Work IQ MCP ist in der Vorschau und erfordert eine Microsoft 365 Copilot-Lizenz. Siehe Werkzeuge überprüfen.
Welche Benachrichtigungsquellen werden unterstützt?
Teams, Outlook, Word-Kommentare und E-Mail. Benachrichtigungen erfordern das Benutzerkonto eines Agenten, das nur Mietern zur Verfügung steht, die am Frontier-Vorschauprogramm teilnehmen. Siehe Benachrichtigungsarten und Benachrichtigungen überprüfen.
Identity
Braucht mein Agent eine eigene Identität?
Jede Agent 365-Integration benötigt ein Identitätsmodell, aber das bedeutet nicht immer, dem Agenten ein eigenes Benutzerkonto zu geben. Der Agent kann S2S als seine Agentenidentität nutzen, OBO im Namen eines angemeldeten Benutzers oder Agentic-User über sein eigenes Microsoft Entra Benutzerkonto handeln. Wählen Sie den Modus, der mit der Arbeit, den Berechtigungen und den erforderlichen Microsoft 365-Ressourcen des Agenten übereinstimmt. Siehe Agentenidentität.
Was ist der Unterschied zwischen einem Agentenidentitätsblueprint und einer Agentenidentität?
Der Blueprint ist die wiederverwendbare Template, die die Zugangsdaten und deklarierten Berechtigungen für eine Art Agent enthält. Eine Agentenidentität ist das Konto, als das sich ein einzelner Agent authentifiziert. Ein Bauplan kann viele Agentenidentitäten erzeugen. Siehe Identitätsobjekte und S2S, Blueprint-abgeleitete Agentenidentität.
Wo werden die Zugangsdaten meines Agenten gespeichert?
Auf dem Bauplan, nicht auf der Agentenidentität. Da ein kompromittierter Bauplan jeden daraus erstellten Agent betrifft, sollten Sie die Anzahl der Baupläne als Sicherheitsgrenzentscheidung betrachten. Siehe Agentenidentität.
Wie viele Baupläne sollte ich erstellen?
So viele wie nötig, um Qualifikations- und Berechtigungsgrenzen getrennt zu halten. Gruppenbasierte Agentenidentitäten, die sicher die Zugangsdaten und geerbten Berechtigungen des Blueprints teilen können. Siehe The identity Foundation und S2S, Blueprint-derived agent identity.
Welches Berechtigungsmodell sollte ich verwenden?
Anwendungsberechtigungen für Service-to-Service-Arbeiten, bei denen der Agent mit eigenen Berechtigungen handelt. Delegierte Berechtigungen im Auftrag der Arbeit, bei denen der Agent mit den Berechtigungen und dem Kontext eines angemeldeten Benutzers handelt. Siehe Agentenidentität.
Braucht mein Agent eine Microsoft 365-Lizenz?
Nur wenn es das Benutzerkonto eines Agenten hat und Dienste wie Teams, Exchange oder SharePoint benötigt. Agenten mit eigenem Benutzerkonto stehen nur Mietern im Frontier-Vorschauprogramm zur Verfügung. Die Lizenzierung auf Mieterebene gilt weiterhin für andere Funktionen: Telemetrie wird eingestellt, es sei denn, mindestens ein Nutzer im Mieter hat eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen, und Work IQ MCP erfordert eine Microsoft 365 Copilot-Lizenz. Siehe Benutzerkonto des Agenten, Identität verifizieren, Observabilität verifizieren und Werkzeuge verifizieren.
Warum ist der Postfach meines Agenten noch nicht verfügbar?
Die Ressourcenbereitstellung kann die Lizenzzuweisung verzögern. Siehe Agent 365 SDK Validierungscheckliste für die erwarteten Zeiten.
Was ist ein Sponsor?
Der Unternehmensvertreter ist für den Zweck und Lebenszyklus eines Maklers verantwortlich. Für jede Agentenidentität und jede Agentenidentitätsvorlage ist mindestens ein Sponsor erforderlich. Sicherheitsteams nutzen den Sponsor, um während eines Vorfalls einen verantwortungsvollen Menschen zu erreichen. Siehe Sponsoren und Identität überprüfen.
Aufbau und Fähigkeiten
Was sind Agent-365-Fähigkeiten?
Eine Möglichkeit, dass ein Coding-Assistent wie GitHub Copilot CLI die Integrationsschritte für dich erledigt. Siehe Agent 365 Skills.
Was hat den instructions.md Setup-Workflow ersetzt?
Agent 365 Skills ersetzte diesen Workflow. Benutze stattdessen Fähigkeiten.
Wenn Ihr Codierassistent die interne Validate & Diagnose-Funktion bereitstellt, können Sie ihn bitten, die Agent-365-Integration zu validieren; Intern wird es auch als a365-code-validatorbezeichnet.
Die Verfügbarkeit hängt vom Assistenten und dem installierten Skills-Paket ab. Siehe Agent 365 Skills.
Muss ich Skills verwenden?
No. Du kannst jeden Schritt manuell ausführen. Fähigkeiten passen zu Standard-Setups und wiederholbarem Onboarding; Manuelle Einrichtung eignet sich für nicht standardisierte Umgebungen und Fehlersuche. Schau , wann du Skills einsetzen solltest.
Ist es sicher, eine Fähigkeit mehr als einmal zu spielen?
Yes. Fähigkeiten sind additiv und idempotent, daher werden abgeschlossene Schritte übersprungen und nicht dupliziert. Siehe Sicherheit und Wiederholbarkeit.
Eine Fähigkeit schien einen Schritt zu überspringen. Ist das ein Problem?
Meistens nicht. Fähigkeiten überspringen bereits konfigurierte Arbeiten. Führe die jeweilige Fertigkeit erneut aus und gib das Ergebnis explizit an, wenn du das bestätigen möchtest. Siehe Sicherheit und Wiederholbarkeit.
Kann ich testen, bevor ich in die Cloud deploye?
Auf dem KI-Teamkameraden-Weg, ja.
Die Fähigkeit test-local führt deinen Agenten zusammen mit Agents Playground, einem lokalen Testgeschirr, für Rauchtests.
Agents Playground verbindet sich über den Agent-Messaging-Endpunkt, daher gilt das nicht für Standardagenten.
Siehe Die sieben Fähigkeiten und den Testagenten im Agents Playground.
Validation
Wie kann ich bestätigen, dass die Integration funktioniert hat?
Arbeiten Sie sich die Validierungscheckliste des Agent 365 SDK durch.
Mein Agent verhält sich nach der Integration anders. Was ist schief gegangen?
Das SDK erweitert deinen Agenten, anstatt einen Teil davon zu ersetzen. Untersuchen Sie jede Verhaltensänderung vor der Bereitstellung: generierter Code, Abhängigkeitskonflikte, Konfiguration und SDK-Kompatibilität sind alles mögliche Ursachen. Beginnen Sie mit Bestehendes Verhalten überprüfen.