Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Microsoft Agent Framework Builder-Skill für .NETagent-framework-builder-dotnet, bietet kompatiblen Coding-Agents von Microsoft verwaltete Anleitungen zum Erstellen von .NET (C#) Agent Framework-Lösungen.
Es hilft dem Coding-Agent, ein geeignetes Pattern auszuwählen und schrittweise fokussierte Anleitungen für die Aufgabe zu laden.
Die Fähigkeit kann bei der Arbeit mit Folgendem helfen:
- Einfache Agents, Modellanbieter, Werkzeuge, Sitzungen, Verlauf, Kontextanbieter und Middleware.
- Nutzen Sie Agents mit Todos, Modi, Memory, Genehmigungen, Fähigkeiten, Hintergrund-Agents, Shelltools, Komprimierung und Schleifen.
- Workflows und integrierte Orchestrierungen und deklarative Definitionen.
- Auswertung, Observability, benutzerdefinierte Clients, benutzerdefinierte Agents und Integrationen.
- Hosting und Bereitstellung.
Der Skill bietet Entwicklungsanleitungen für einen externen Codierungsagenten. Es handelt sich nicht um ein NuGet-Paket und es wird nicht innerhalb Ihrer Agent Framework-Anwendung ausgeführt.
Important
Diese Coding-Agent-Fähigkeit unterscheidet sich von den Runtime-Agent-Fähigkeiten. Runtime Skills werden von einem Agent Framework-Agent geladen, während Ihre Anwendung ausgeführt wird. Die Builder-Fähigkeit hilft einem Codierungs-Agent, Ihren Anwendungsquellcode zu erstellen oder zu ändern.
Tip
Koppeln Sie die Builder-Fähigkeit mit dem Microsoft Learn MCP Server. Der Skill bietet dem Coding-Agent fokussierten Agent Framework-Workflow und Implementierungshinweise, während der Learn MCP-Server es ermöglicht, aktuelle Microsoft-Dokumentation zu durchsuchen, vollständige Artikel abzurufen und Codebeispiele während der Aufgabe zu finden. Konfigurieren Sie diesen öffentlichen, nicht authentifizierten streambaren HTTP-Endpunkt in einem kompatiblen Coding-Agent:
https://learn.microsoft.com/api/mcp
Prerequisites
- Ein Codierungs-Agent, der die Offene Agent Skills-Spezifikation unterstützt.
-
GitHub CLI mit den Vorschaubefehlen
gh skilloder Node.js 22.20 oder höher, wenn Sie die Cross-Agent-skillsCLI verwenden. - Ein derzeit unterstütztes .NET SDK für neue Agent Framework-Anwendungen.
Die GitHub CLI-Skill-Verwaltung befindet sich in der Vorschau und kann sich ändern.
Überprüfen und installieren mit GitHub CLI
Die .NET-Builder-Fertigkeit ist noch nicht in einer mit einem Tag versehenen Version enthalten, daher müssen Sie die Referenz @main angeben. Sehen Sie sich die Fertigkeit vor der Installation in der Vorschau an:
gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main
Installieren Sie den Skill:
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main
Die Standardinstallation ist projektbezogen und zielt auf GitHub Copilot zur nicht interaktiven Verwendung ab. Wählen Sie bei Bedarf einen anderen unterstützten Coding-Agent oder Benutzerkontext aus:
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent codex
Aktuelle Client- und Bereichsoptionen finden Sie unter gh skill install.
Mit der cross-agent Skills CLI installieren
Als Alternative installieren Sie den Skill mit der cross-agent skills CLI:
npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet
Überprüfen Sie die unterstützten Coding-Agenten und Laufzeitanforderungen der CLI vor der Installation.
Verwenden Sie den Skill
Weisen Sie den Coding-Agenten auf natürliche Weise an. Kompatible Clients entdecken und aktivieren die Skill aus ihren Metadaten; Gehen Sie nicht von einem universellen Schrägstrichbefehl aus.
Beispielaufforderungen:
Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with todos, file access, and safe shell tooling.Review this .NET Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.
Schließen Sie Einschränkungen ein, z. B. den Modellanbieter, das Hostingziel, die Persistenzanforderungen, die Sicherheitsgrenze und die Zielversion .NET, wenn Sie sie kennen.
Was sollte der Coding-Agent tun?
Der Skill weist einen Codierungsagenten an:
- Überprüfen Sie die vorhandene Lösung, einschließlich Zielframeworks, SDK-Version, Paketverwaltung und installierten
Microsoft.Agents.AI.*-Paketen. - Wählen Sie das kleinste geeignete Muster aus, z. B. einen einfachen Agent, ein Harness, einen Workflow, eine Orchestrierung oder eine deklarative Definition.
- Laden Sie nur die relevanten fokussierten Referenzen.
- Fügen Sie nur die begrenzte Auswahl an Paketen hinzu, die die Anwendung benötigt, und überprüfen Sie die Reife jedes Pakets, bevor Sie davon abhängig werden, da einige Pakete Vorabversionen sind.
- Lesen Sie Endpunkte, Modelle und Schlüssel aus der Konfiguration, und bevorzugen Sie Tokenanmeldeinformationen gegenüber hartcodierten API-Schlüsseln.
- Überprüfen Sie die generierte Anwendung mit den vorhandenen Tests des Repositorys und runnablen Beispielen.
Die Fähigkeit garantiert nicht, dass generierter Code produktionsbereit ist. Überprüfen Sie den Plan des Codierungs-Agents, Paketoptionen, Sicherheitsgrenzen, Befehle und generierte Änderungen vor der Genehmigung.
Versionsverwaltung und Vertrauen
Der Skill ist ein öffentlicher, installierbarer, von Microsoft verwalteter Consumer-Skill. Die Version der Skill-Metadaten ist 0.1.
- Verwenden Sie den
@mainref, bis eine getaggte Version den Skill enthält. - Zeigen Sie vor der Installation eine Vorschau von Skill-Inhalten an, und überprüfen Sie Updates, bevor Sie neuen Skripts oder Anweisungen vertrauen.
Informationen zu den Quell- und Fokusverweisen finden Sie unter:
Nächste Schritte
Gehen Sie tiefer:
Die Microsoft Agent Framework Builder-Skill für Python, agent-framework-builder-python bietet kompatiblen Programmier-Agents von Microsoft verwaltete Anleitungen zum Erstellen von Python-Agent-Framework-Lösungen.
Es hilft dem Coding-Agent, ein geeignetes Pattern auszuwählen und schrittweise fokussierte Anleitungen für die Aufgabe zu laden.
Die Fähigkeit kann bei der Arbeit mit Folgendem helfen:
- Einfache Agents, Modellanbieter, Tools, Genehmigungen, Sitzungen, Verlauf und Kontextanbieter.
- Nutzen Sie Agenten mit Planung, Todos, Speicher, Komprimierung, Dateien, Hintergrund-Agenten, Shelltools und Schleifen.
- Funktionale und Graph-Workflows, integrierte Orchestrierungen und deklarative Definitionen.
- Auswertung, Observability, Middleware, benutzerdefinierte Clients, benutzerdefinierte Agents und Integrationen.
- Self-Hosting und Microsoft Foundry Hosted-Agent-Entwicklung.
Die Fähigkeit ist nur für Python. Es bietet Entwicklungsanleitung für einen externen Codierungs-Agent; es handelt sich nicht um ein Python-Paket, wird nicht von pip install agent-framework installiert und wird nicht in Ihrer Agent Framework-Anwendung ausgeführt.
Important
Diese Coding-Agent-Fähigkeit unterscheidet sich von den Runtime-Agent-Fähigkeiten. Runtime Skills werden von einem Agent Framework-Agent geladen, während Ihre Anwendung ausgeführt wird. Die Builder-Fähigkeit hilft einem Codierungs-Agent, Ihren Anwendungsquellcode zu erstellen oder zu ändern.
Tip
Koppeln Sie die Builder-Fähigkeit mit dem Microsoft Learn MCP Server. Der Skill bietet dem Coding-Agent fokussierten Agent Framework-Workflow und Implementierungshinweise, während der Learn MCP-Server es ermöglicht, aktuelle Microsoft-Dokumentation zu durchsuchen, vollständige Artikel abzurufen und Codebeispiele während der Aufgabe zu finden. Konfigurieren Sie diesen öffentlichen, nicht authentifizierten streambaren HTTP-Endpunkt in einem kompatiblen Coding-Agent:
https://learn.microsoft.com/api/mcp
Prerequisites
- Ein Codierungs-Agent, der die Offene Agent Skills-Spezifikation unterstützt.
-
GitHub CLI mit den Vorschaubefehlen
gh skilloder Node.js 22.20 oder höher, wenn Sie die Cross-Agent-skillsCLI verwenden. - Python 3.11 oder höher. Agent Framework 1.24 unterstützt oder testet nicht mehr Python 3.10, obwohl Paketmetadaten weiterhin die Installation zulassen.
Die GitHub CLI-Skill-Verwaltung befindet sich in der Vorschau und kann sich ändern.
Überprüfen und installieren mit GitHub CLI
Sehen Sie sich die veröffentlichte Fähigkeit vor der Installation an:
gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0
Installieren Sie die neueste getaggte Version:
gh skill install microsoft/agent-framework agent-framework-builder-python
Fixieren Sie das Python 1.23 Release, wenn Sie reproduzierbare Hinweise benötigen:
gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0
Die Standardinstallation ist projektbezogen und zielt auf GitHub Copilot zur nicht interaktiven Verwendung ab. Wählen Sie bei Bedarf einen anderen unterstützten Coding-Agent oder Benutzerkontext aus:
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent codex
Aktuelle Client- und Bereichsoptionen finden Sie unter gh skill install.
Mit der cross-agent Skills CLI installieren
Als Alternative installieren Sie den Skill mit der cross-agent skills CLI:
npx skills add microsoft/agent-framework --skill agent-framework-builder-python
Überprüfen Sie die unterstützten Coding-Agenten und Laufzeitanforderungen der CLI vor der Installation.
Verwenden Sie den Skill
Weisen Sie den Coding-Agenten auf natürliche Weise an. Kompatible Clients entdecken und aktivieren die Skill aus ihren Metadaten; Gehen Sie nicht von einem universellen Schrägstrichbefehl aus.
Beispielaufforderungen:
Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with planning, todos, file access, and safe shell tooling.Review this Python Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.
Schließen Sie Einschränkungen wie modellanbieter, Hostingziel, Persistenzanforderungen, Sicherheitsgrenzen und unterstützte Python Version ein, wenn Sie sie kennen.
Was sollte der Coding-Agent tun?
Der Skill weist einen Codierungsagenten an:
- Wählen Sie das kleinste geeignete Muster aus, z. B. einen einfachen Agent, ein Harness, einen Workflow, eine Orchestrierung oder eine deklarative Definition.
- Laden Sie nur die relevanten fokussierten Referenzen.
- Bevorzugen Sie aktuelle Microsoft Learn-Anleitungen, öffentliche API-Referenzen, Paketlebenszyklusinformationen und gepflegte Beispiele für veränderliche Details.
- Installieren Sie kleine Paketsammlungen, anstatt davon auszugehen, dass jede Integration stabil oder erforderlich ist.
- Bewahren Sie explizite Sitzungs-, Freigabe-, Authentifizierungs- und Hostinggrenzen auf.
- Überprüfen Sie die generierte Anwendung mit den vorhandenen Tests, Typüberprüfungen und ausführungsfähigen Beispielen des Repositorys.
Die Fähigkeit garantiert nicht, dass generierter Code produktionsbereit ist. Überprüfen Sie den Plan des Codierungs-Agents, Paketoptionen, Sicherheitsgrenzen, Befehle und generierte Änderungen vor der Genehmigung.
Versionsverwaltung und Vertrauen
Der Skill ist ein öffentlicher, installierbarer, von Microsoft verwalteter Consumer-Skill, der im Repository-Tag python-1.23.0 veröffentlicht wurde. Die Version der Skill-Metadaten ist 0.3.
- Verwenden Sie den unqualifizierten Installationsbefehl für die neueste markierte Version.
-
@python-1.23.0anheften, wenn die Reproduzierbarkeit wichtig ist. - Verwenden Sie
@mainnur, wenn Sie absichtlich unveröffentlichte Hinweise wünschen. - Zeigen Sie vor der Installation eine Vorschau von Skill-Inhalten an, und überprüfen Sie Updates, bevor Sie neuen Skripts oder Anweisungen vertrauen.
Informationen zu den Quell- und Fokusverweisen finden Sie unter:
Nächste Schritte
Gehen Sie tiefer:
Note
Ein Microsoft Agent Framework-Builder-Skill für Go ist noch nicht verfügbar. Verwenden Sie Go get-started tutorial und die Go-Beispiele für Agent Framework, um aktuelle Anleitungen zu erhalten.