Agent 365 Fähigkeiten für die Einrichtung eines geführten Agenten

Agent 365 Skills bieten einen geführten Einrichtungspfad, um einen bestehenden Agenten von einem unterstützten Codierassistenten mit Agent 365 zu verbinden. Du gibst das gewünschte Ergebnis an, zum Beispiel um Observabilität für diesen Agenten hinzuzufügen, und der Skill identifiziert das Projekt, sammelt die erforderlichen Werte, nimmt die Integrationsänderungen vor und prüft das Ergebnis.

Skills funktionieren in allen Code-Agenten, darunter Claude Code, GitHub Copilot CLI und im VS Code Agent Mode.

Um die Fähigkeiten zu installieren und dem Onboarding-Weg Ihres Agenten zu folgen, siehe Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365.

Note

Fähigkeiten ersetzen den früheren Setup-Workflow, der eine instructions.md Datei verwendete.

Wann man Fähigkeiten einsetzen sollte

Die Verbindung eines bestehenden Agenten mit Unternehmensidentität, Observabilität, Managed Tools und Benachrichtigungen erfordert mehrere geordnete Einrichtungsschritte. Diese Schritte umfassen die Installation der Agent 365 CLI, die Validierung von Azure-Voraussetzungen, die Registrierung eines Blueprints, die Konfiguration von Entra-Ressourcen, das Verkabeln von OpenTelemetrie-Exportern, das Anschließen von Model Context Protocol (MCP)-Servern und lokale Tests.

Skills führen diese Schritte in der gewünschten Reihenfolge für den gewählten Pfad aus und validieren das resultierende Projekt.

Wie eine Fertigkeit läuft

Jede Fähigkeit folgt demselben Arbeitsablauf:

  1. Geben Sie das gewünschte Ergebnis an.
  2. Lassen Sie die Fähigkeit den Projektstack und die vorhandene Konfiguration identifizieren.
  3. Gib die angeforderten Werte an, wie zum Beispiel den Authentifizierungsmodus.
  4. Überprüfen Sie den Code, das Manifest und die Konfigurationsänderungen, die es vornimmt.
  5. Bestätige, dass das Projekt noch gebaut wird und die Integration funktioniert.

Verfügbare Agent-365-Fähigkeiten

a365-setup ist der Einstiegspunkt. Nachdem es die Voraussetzungen validiert hat, leitet es dich auf einen von zwei Pfaden, und du folgst nur diesem Pfad:

  • Standardagent. a365-setup delegiert an make-a365-agent. Nutzen Sie diesen Pfad, wenn der Agent kein eigenes Benutzerkonto benötigt. Ein Standardagent authentifiziert sich mit OBO oder S2S, sodass er für einen angemeldeten Benutzer agieren oder ohne einen solchen Benutzer laufen kann.
  • KI-Teamkollege. a365-setup delegiert an make-ai-teammate, für einen Agenten, der ein eigenes Benutzerkonto benötigt. Ein KI-Teammitglied authentifiziert sich als dieses Benutzerkonto an (Agentic-User). Dieser Pfad erfordert das Frontier-Vorschauprogramm.

Um einen Pfad und einen Authentifizierungsmodus auszuwählen, siehe Agententypen und Authentifizierungsmodi.

Skill Purpose
a365-setup Installiert die Agent 365 CLI, validiert Azure-Voraussetzungen und erkennt den Agentenstack. Für einen Standard-Agent wird angegeben, ob sich der Agent mit OBO oder S2S authentifiziert. Dann an make-a365-agent oder make-ai-teammate delegieren.
make-a365-agent Stellt einen Standardagenten bereit, der kein eigenes Benutzerkonto benötigt. Registriert den Agenten-Identitätsblueprint in Microsoft Entra, erstellt daraus eine Agentenidentität und konfiguriert die Entra ID-Berechtigungen, die der Agent benötigt: delegierte Berechtigungen für OBO oder Anwendungsberechtigungen für S2S. Dann bietet sie Observabilität und Werkzeuge als Add-ons an.
make-ai-teammate Verwandelt einen Agenten in einen KI-Teamkollegen mit eigenem Benutzerkonto. Registriert den Agenten-Identitätsblueprint und erstellt daraus eine Agentenidentität, dann fügt er die Hosting-Ebene, das Nachrichtenrouting und Benachrichtigungen hinzu. a365-setup muss zuerst ausgeführt worden sein.
instrument-observability Verbindet OpenTelemetry und den Agent 365-Ablaufverfolgungsexporter, sodass Agent-Spans Microsoft Defender, Microsoft Purview und das Microsoft 365 Admin Center erreichen. Unterstützt OBO, S2S und Agentic-User. Fragt nach dem Agententyp und dem Authentifizierungsmodus, falls a365-setup sie nicht bereits aufgezeichnet hat.
a365-code-validator Validiert und diagnostiziert eine bestehende Agent 365-Integration, einschließlich Instrumentierung, Microsoft Entra-Artefakte, Messaging, Werkzeugzugriff und verwandter Konfiguration. Schreibgeschützt standardmäßig. Verwende instrument-observability, um Observabilität von Grund auf hinzuzufügen.
add-workiq-tools Verbindet Work IQ MCP-Server, einschließlich Mail, Kalender und Word, sodass der Agent Microsoft 365-Daten lesen und bearbeiten kann. Erfordert ein delegiertes Berechtigungsmodell und wird automatisch übersprungen, wenn der Authentifizierungsmodus S2S ist.
purview-dlp-integration Fügt mithilfe von Microsoft Graph processContent Microsoft Purview Data Loss Prevention (DLP)-Prüfungen vor den LLM-Aufrufen des Agenten hinzu, mit optionaler Antwortüberprüfung. Leitet die Einrichtung von Graph-Berechtigungen und DLP-Richtlinien an.
test-local Führt einen KI-Teamkameraden-Agenten lokal aus und öffnet Agents Playground für interaktive Tests, ohne dass eine Cloud-Bereitstellung erforderlich ist. Gilt für den KI-Teamkameraden-Weg.

Important

make-ai-teammate gibt deinem Agenten ein eigenes Benutzerkonto, einschließlich einer Postfach- und Teams-Präsenz. Diese Funktion steht nur Mietern zur Verfügung, die am Frontier-Vorschauprogramm teilnehmen.

Normalerweise ruft man eine Fähigkeit auf, indem man das Ergebnis angibt, anstatt die Fähigkeit zu benennen. Zum Beispiel führt Observability zu diesem Agenten hinzufügeninstrument-observability aus. Wenn Ihr Codingassistent die interne a365-code-validator Funktion offenlegt, bitten Sie ihn, diese Agent-365-Integration zu validieren; die Funktion wird intern auch als Validate & Diagnose bezeichnet. Verfügbarkeit und Aufruf hängen vom Assistenten und dem installierten Skills-Paket ab. Für die in jedem Schritt verwendete Anforderungsformulierung siehe Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365.

Agententypen und Authentifizierungsmodi

Fähigkeiten richten sowohl Standardagenten als auch KI-Teammitglieder ein. Der Pfad bestimmt, welche Authentifizierungsmodi dem Agenten zur Verfügung stehen. Der Authentifizierungsmodus, in der Agentenidentität als Ausführungsmodus bezeichnet, bestimmt, als wer der Agent handelt, wenn er nachgelagerte Dienste wie Microsoft Graph- und MCP-Server aufruft.

Authentifizierungsmodus Path Der Agent fungiert als Verwenden Sie ihn, wenn
OBO (im Namen von) Standard-Agent Der angemeldete Benutzer mit delegierten Berechtigungen Der Agent arbeitet im Kontext eines Nutzers, zum Beispiel indem er den Kalender dieses Benutzers liest oder E-Mails für ihn versendet.
S2S (service-to-service) Standard-Agent Eine eigene Agentenidentität mit Anwendungsberechtigungen Der Agent läuft ohne angemeldeten Benutzer, zum Beispiel für geplante Aufgaben, Überwachung oder Hintergrundverarbeitung.
Agentischer Benutzer KI-Teamkollegen Eigenes Benutzerkonto Der Agent benötigt ein eigenes Postfach, eine Teams-Präsenz oder andere benutzerbasierte Microsoft 365-Erlebnisse. Benötigt das Frontier-Vorschauprogramm.

Für einen Standardagenten fragt a365-setup, ob der Agent OBO oder S2S verwendet, und später verwenden Skills deine Antwort wieder. Ein KI-Teamkollege verwendet immer Agentic-User, daher fragt a365-setup nicht. Skills konfigurieren für jeden Agenten einen Modus. Wenn der Agent sowohl delegierte als auch Anwendungsberechtigungen benötigt, führen Sie a365 setup all --authmode both mit der Agent 365 CLI aus. Für die Rollen, die jeder Modus erfordert, siehe Agent identity grants.

Der Authentifizierungsmodus bestimmt, was die Fähigkeiten einrichten:

  • make-a365-agent führt a365 setup all mit --authmode obo oder --authmode s2s aus. OBO gewährt der Agentenidentität delegierte Berechtigungen, und S2S weist ihr Anwendungsrechte zu.
  • instrument-observability Exportiert Telemetrie über die S2S-Route mit einem App-Only-Token in jedem Modus, sodass eine registrierte Agent-Instanz keine Observability-Berechtigung oder Administratorzustimmung benötigt. Für OBO und Agentic-User konfiguriert der Skill den Agenten so, dass er dieses Token erhält, indem die Blueprint-Zugangsdaten von der Hosting-Verbindung wiederverwendet werden. Für S2S fügt es einen Token-Service hinzu, der das Token für .NET, Node.jsund Python Agenten erwirbt und aktualisiert. Siehe Agent 365-enabled mit S2S.
  • add-workiq-tools erfordert ein delegiertes Benutzertoken, daher funktioniert es mit OBO und Agentic-User, aber nicht mit S2S. Wenn du S2S wählst, a365-setup entfernt Work IQ aus deinen ausgewählten Fähigkeiten.
  • purview-dlp-integration unterstützt delegierte agentische Authentifizierung. Für S2S werden nur Node.js Agenten unterstützt, die client-secret Federated Managed Identity (FMI)-Authentifizierung verwenden.
  • test-local gilt nur für KI-Teammitglieder.

Unterstützte Stacks

Skills erkennen automatisch den Projektstack, sodass du dein Projekt nicht manuell zuordnen musst. Dies sind die Technologie-Stacks, die von Skills erkannt werden. Das SDK funktioniert auch mit anderen Frameworks.

Language Frameworks
.NET Microsoft Agent Framework, Semantischer Kernel, Azure AI Foundry
Node.js LangChain, OpenAI Agents SDK, Claude Agent SDK, Semantischer Kernel, Google ADK
Python Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Semantischer Kernel, Google ADK

Sicherheit und Wiederholbarkeit

Skills sind darauf ausgelegt, Setup-Änderungen anzuwenden, ohne das bestehende Verhalten Ihres Projekts zu verändern. Bestätigen Sie dieses Verhalten mit der Validierungscheckliste des Agent 365 SDK.

  • Additiv und idempotent. Fähigkeiten löschen oder strukturieren keinen bestehenden Code, und das Wiederholen einer Fähigkeit dupliziert keine abgeschlossene Arbeit.
  • Staatsbewusst. Skills erkennen, was bereits eingerichtet ist, sodass sie bereits abgeschlossene Schritte überspringen, anstatt sie zu wiederholen.
  • Mit Schutzgeländer. Skills ändern keine Dateien außerhalb deines Projekts und überprüfen vor dem Abschluss, ob der Build weiterhin erfolgreich ist.

Nutze Skills wenn:

  • Du hast einen bestehenden Agenten und möchtest ihn integrieren, ohne die Anbindung manuell zu programmieren.
  • Dein Entwicklungsworkflow beinhaltet bereits einen Programmierassistenten.
  • Sie möchten ein konsistentes, wiederholbares Onboarding über Projekte hinweg.

Manuelle Einrichtung verwenden, wenn:

  • Deine Umgebung ist nicht standardmäßig und jeder Schritt erfordert individuelle Kontrolle.
  • Ihre Organisation schränkt die Arbeitsabläufe von Coding-Assistants ein.
  • Du bist bei der Fehlerbehebung und willst jeden Schritt selbst durchführen.

Für den manuellen Pfad verwenden Sie die Einrichtungsschritte in Quickstart: Verbinden Sie einen bestehenden Agenten mit Agent 365 und führen Sie die entsprechenden Agent-365-CLI-Befehle für Ihre Umgebung aus.

Verwandte Inhalte

  • Zuletzt aktualisiert um