Agent Framework-apps bouwen met een coderingsagent

De Microsoft Agent Framework Builder-vaardigheid voor .NET, agent-framework-builder-dotnetbiedt compatibele coderingsagents door Microsoft onderhouden richtlijnen voor het bouwen van .NET (C#) Agent Framework-oplossingen. Het helpt de coderingsagent een geschikt patroon te kiezen en geleidelijk gerichte richtlijnen voor de taak te laden.

De vaardigheid kan helpen bij het werken met:

  • Gewone agents, modelproviders, hulpprogramma's, sessies, geschiedenis, contextproviders en middleware.
  • Benut agents met todos, modi, geheugen, goedkeuringen, vaardigheden, achtergrondagenten, shell-hulpprogramma's, compactie en lussen.
  • Werkstromen en ingebouwde orchestraties en declaratieve definities.
  • Evaluatie, observability, aangepaste clients, aangepaste agents en integraties.
  • Hosting en uitrol.

De vaardigheid biedt ontwikkelingsrichtlijnen voor een externe coderingsagent. Het is geen NuGet-pakket en draait niet in uw Agent Framework-toepassing.

Important

Deze vaardigheid voor coderingsagent verschilt van runtime agentvaardigheden. Runtimevaardigheden worden geladen door een Agent Framework-agent terwijl uw toepassing wordt uitgevoerd. De builder-skill helpt een codeeragent uw toepassingsbroncode te maken of te wijzigen.

Tip

Koppel de builder-vaardigheid aan de Microsoft Learn MCP Server. De vaardigheid biedt gerichte workflow- en implementatierichtlijnen voor Agent Framework, terwijl de Learn MCP-server het mogelijk maakt om in de huidige documentatie van Microsoft te zoeken, volledige artikelen op te halen en codevoorbeelden te vinden tijdens de taak. Configureer dit openbare Streamable HTTP-eindpunt zonder authenticatie in een compatibele codeeragent:

https://learn.microsoft.com/api/mcp

Prerequisites

  • Een coderingsagent die ondersteuning biedt voor de open Agent Skills-specificatie.
  • GitHub CLI met de preview-opdrachten gh skill of Node.js 22.20 of hoger als u de CROSS-agent skills CLI gebruikt.
  • Een momenteel ondersteunde .NET SDK voor nieuwe Agent Framework-toepassingen.

GitHub CLI-vaardigheidsbeheer is in preview en kan worden gewijzigd.

Beoordelen en installeren met GitHub CLI

De vaardigheid .NET builder bevindt zich nog niet in een gelabelde release, dus u moet de @main ref opgeven. Bekijk de vaardigheid voordat u deze installeert:

gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main

Installeer de skill:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

De standaardinstallatie is projectgebonden en is gericht op GitHub Copilot in niet-interactief gebruik. Selecteer een andere ondersteunde coderingsagent of gebruikersscope wanneer dat nodig is:

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

Zie voor de huidige client- en scope-opties gh skill install.

Installeren met de cross-agent skills-CLI

Als alternatief installeert u de skill met de CROSS-agent skills CLI:

npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet

Controleer vóór de installatie de ondersteunde codeeragents en runtimevereisten van de CLI.

Gebruik de vaardigheid

Vraag de codeeragent op een natuurlijke manier. Compatibele clients ontdekken en activeren de vaardigheid vanuit de metagegevens; ga niet uit van een universele slash-opdracht.

Voorbeeldprompts:

  • 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.

Neem beperkingen op zoals de modelprovider, hostingdoel, persistentievereisten, beveiligingsgrens en beoogde .NET-versie wanneer u ze kent.

Wat de codeeragent moet doen

De vaardigheid instrueert een codeeragent om:

  • Inspecteer de bestaande oplossing, waaronder doelframeworks, SDK-versie, pakketbeheer en geïnstalleerde Microsoft.Agents.AI.* pakketten.
  • Kies het kleinste geschikte patroon, zoals een gewone agent, harness, workflow, orkestratie of declaratieve definitie.
  • Laad alleen de relevante gefocuste referenties.
  • Voeg alleen de beperkte selectie pakketten toe die de toepassing nodig heeft en controleer de stabiliteit van elk pakket voordat u ervan afhankelijk wordt, omdat sommige pakketten pre-releaseversies zijn.
  • Lees eindpunten, modellen en sleutels uit de configuratie en geef de voorkeur aan tokenaanmeldingsgegevens boven hardcoded API-sleutels.
  • Valideer de gegenereerde toepassing met de bestaande tests van de repository en uitvoerbare voorbeelden.

De vaardigheid garandeert niet dat gegenereerde code gereed is voor productie. Controleer het plan van de coderingsagent, pakketkeuzes, beveiligingsgrenzen, opdrachten en gegenereerde wijzigingen vóór goedkeuring.

Versionering en vertrouwen

De vaardigheid is een openbare, installeerbare, Microsoft-onderhouden consumentenvaardigheid. De metagegevensversie van de vaardigheid is 0.1.

  • Gebruik de @main ref totdat een gelabelde release de skill bevat.
  • Bekijk inhoud van vaardigheden vóór de installatie en controleer updates voordat u nieuwe scripts of instructies vertrouwt.

Zie voor de bron- en specifieke referenties:

Volgende stappen 

Uw eerste agent maken

Ga dieper in:

De Microsoft Agent Framework Builder-vaardigheid voor Python, agent-framework-builder-python, biedt compatibele coderingsagents door Microsoft onderhouden richtlijnen voor het bouwen van Python Agent Framework-oplossingen. Het helpt de coderingsagent een geschikt patroon te kiezen en geleidelijk gerichte richtlijnen voor de taak te laden.

De vaardigheid kan helpen bij het werken met:

  • Standaardagents, modelproviders, hulpprogramma's, goedkeuringen, sessies, geschiedenis en contextproviders.
  • Maak gebruik van agents met planning, todos, geheugen, compactie, bestanden, achtergrondagenten, shell-hulpprogramma's en lussen.
  • Functionele en grafiekworkflows, ingebouwde orchestraties en declaratieve definities.
  • Evaluatie, observability, middleware, aangepaste clients, aangepaste agents en integraties.
  • Self-hosting en ontwikkeling met gehoste agents in Microsoft Foundry.

De vaardigheid is alleen voor Python. Het biedt ontwikkelingsrichtlijnen voor een externe coderingsagent; het is geen Python pakket, is niet geïnstalleerd door pip install agent-frameworken wordt niet uitgevoerd in uw Agent Framework-toepassing.

Important

Deze vaardigheid voor coderingsagent verschilt van runtime agentvaardigheden. Runtimevaardigheden worden geladen door een Agent Framework-agent terwijl uw toepassing wordt uitgevoerd. De builder-skill helpt een codeeragent uw toepassingsbroncode te maken of te wijzigen.

Tip

Koppel de builder-vaardigheid aan de Microsoft Learn MCP Server. De vaardigheid biedt gerichte workflow- en implementatierichtlijnen voor Agent Framework, terwijl de Learn MCP-server het mogelijk maakt om in de huidige documentatie van Microsoft te zoeken, volledige artikelen op te halen en codevoorbeelden te vinden tijdens de taak. Configureer dit openbare Streamable HTTP-eindpunt zonder authenticatie in een compatibele codeeragent:

https://learn.microsoft.com/api/mcp

Prerequisites

  • Een coderingsagent die ondersteuning biedt voor de open Agent Skills-specificatie.
  • GitHub CLI met de preview-opdrachten gh skill of Node.js 22.20 of hoger als u de CROSS-agent skills CLI gebruikt.
  • Python 3.11 of hoger. Agent Framework 1.24 ondersteunt of test Python 3.10 niet meer, hoewel pakketmetagegevens nog steeds installatie toestaan.

GitHub CLI-vaardigheidsbeheer is in preview en kan worden gewijzigd.

Beoordelen en installeren met GitHub CLI

Bekijk een voorbeeld van de uitgebrachte vaardigheid voordat u deze installeert:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Installeer de meest recente gelabelde versie:

gh skill install microsoft/agent-framework agent-framework-builder-python

Zet de Python 1.23-release vast wanneer u reproduceerbare richtlijnen nodig hebt:

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

De standaardinstallatie is projectgebonden en is gericht op GitHub Copilot in niet-interactief gebruik. Selecteer een andere ondersteunde coderingsagent of gebruikersscope wanneer dat nodig is:

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

Zie voor de huidige client- en scope-opties gh skill install.

Installeren met de cross-agent skills-CLI

Als alternatief installeert u de skill met de CROSS-agent skills CLI:

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

Controleer vóór de installatie de ondersteunde codeeragents en runtimevereisten van de CLI.

Gebruik de vaardigheid

Vraag de codeeragent op een natuurlijke manier. Compatibele clients ontdekken en activeren de vaardigheid vanuit de metagegevens; ga niet uit van een universele slash-opdracht.

Voorbeeldprompts:

  • 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.

Neem beperkingen op zoals de modelprovider, hostingdoel, persistentievereisten, beveiligingsgrens en ondersteunde Python versie wanneer u deze kent.

Wat de codeeragent moet doen

De vaardigheid instrueert een codeeragent om:

  • Kies het kleinste geschikte patroon, zoals een gewone agent, harness, workflow, orkestratie of declaratieve definitie.
  • Laad alleen de relevante gefocuste referenties.
  • Geef de voorkeur aan de huidige Microsoft Learn-richtlijnen, openbare API-verwijzingen, informatie over de levenscyclus van pakketten en onderhouden voorbeelden voor vluchtige details.
  • Installeer smalle pakketsets in plaats van ervan uit te gaan dat elke integratie stabiel of vereist is.
  • Behoud expliciete sessie-, goedkeurings-, verificatie- en hostinggrenzen.
  • Valideer de gegenereerde toepassing met de bestaande tests van de repository, typecontroles en uitvoerbare voorbeelden.

De vaardigheid garandeert niet dat gegenereerde code gereed is voor productie. Controleer het plan van de coderingsagent, pakketkeuzes, beveiligingsgrenzen, opdrachten en gegenereerde wijzigingen vóór goedkeuring.

Versionering en vertrouwen

De skill is een openbare, installeerbare, door Microsoft onderhouden consumerskill die is vrijgegeven in de python-1.23.0 repositorytag. De metagegevensversie van de vaardigheid is 0.3.

  • Gebruik het niet-gekwalificeerde install-commando voor de meest recente gelabelde release.
  • Vastzetten @python-1.23.0 wanneer reproduceerbaarheid belangrijk is.
  • Gebruik @main alleen wanneer u opzettelijk niet-gepubliceerde richtlijnen wilt.
  • Bekijk inhoud van vaardigheden vóór de installatie en controleer updates voordat u nieuwe scripts of instructies vertrouwt.

Zie voor de bron- en specifieke referenties:

Volgende stappen 

Uw eerste agent maken

Ga dieper in:

Note

Een Microsoft Agent Framework Builder-vaardigheid voor Go is nog niet beschikbaar. Gebruik de zelfstudie Aan de slag met Go en Voorbeelden van Agent Framework Go voor huidige richtlijnen.

  • Laatst bijgewerkt om