Agent Framework-alkalmazások készítése egy kódoló ügynökkel

A .NET-hez készült Microsoft Agent Framework Builder skill, agent-framework-builder-dotnetMicrosoft által karbantartott útmutatást nyújt a kompatibilis kódolási ügynököknek a .NET- (C#-) Agent Framework-megoldások létrehozásához. Segít a kódolási ügynöknek kiválasztani a megfelelő mintát, és fokozatosan betölteni a célzott útmutatást a feladathoz.

A képesség útmutatást adhat a munkához a következőkkel:

  • Egyszerű ügynökök, modellszolgáltatók, eszközök, munkamenetek, előzmények, környezetszolgáltatók és köztes szoftverek.
  • Használjon ügynököket teendőkkel, módokkal, memóriával, jóváhagyásokkal, készségekkel, háttérügynökökkel, shelleszközökkel, tömörítéssel és hurkokkal.
  • Munkafolyamatok és beépített orkesztrációk, valamint deklaratív definíciók.
  • Értékelés, megfigyelhetőség, egyéni kliensek, egyéni ügynökök és integrációk.
  • Hosztolás és üzembe helyezés.

A képesség fejlesztési útmutatást nyújt egy külső kódoló ágens számára. Ez nem NuGet-csomag, és nem fut az Agent Framework-alkalmazásban.

Important

Ez a kódolóügynök-képesség eltér a futtatókörnyezeti Agent Skills elemtől. A futásidejű készségeket egy Agent Framework-ügynök tölti be az alkalmazás futtatása közben. A builder képesség segít a kódoló ügynöknek létrehozni vagy módosítani az alkalmazás forráskódját.

Tip

Párosítsa az építői készséget a Microsoft Learn MCP-kiszolgálóval. Ez a képesség a kódolási ügynökre összpontosító Agent Framework munkafolyamat- és megvalósítási útmutatást nyújt, míg a Learn MCP-kiszolgáló lehetővé teszi az aktuális Microsoft dokumentáció keresését, a teljes cikkek lekérését és a feladat során a kódminták keresését. Konfigurálja ezt a nyilvános, nem hitelesített streamelhető HTTP-végpontot egy kompatibilis kódolási ügynökben:

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

Prerequisites

  • Egy kódolóügynök, amely támogatja a nyílt Agent Skills specifikációt.
  • GitHub CLI az előnézeti gh skill parancsokkal, vagy a Node.js 22.20-es vagy újabb verzióját, ha az ügynökközi skills CLI-t használja.
  • Jelenleg támogatott .NET SDK új Agent Framework-alkalmazásokhoz.

A GitHub CLI készségkezelése előzetes verzióban érhető el, és változhat.

Tekintse át és telepítse a GitHub CLI-val

A .NET builder-skill még nem szerepel címkézett kiadásban, ezért meg kell adnia a @main refet. A telepítés előtt tekintse meg a skill előzetes verzióját:

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

Telepítse a skillt:

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

Az alapértelmezett telepítés projekthatókörű, és nem interaktív használat esetén a GitHub Copilotot célozza. Szükség esetén válasszon másik támogatott kódoló ügynököt vagy felhasználói hatókört:

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

Az aktuális ügyfél- és hatókörbeállításokat lásd: gh skill install.

Telepítés a cross-agent skills CLI-val

Alternatív megoldásként telepítse a skillt az ügynökközi skills parancssori felülettel:

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

A telepítés előtt tekintse át a parancssori felület támogatott kódoló ágenseit és futtatókörnyezeti követelményeit.

Használja a képességet

Adjon természetes utasítást a kódoló ügynöknek. A kompatibilis ügyfélalkalmazások felderítik és aktiválják a skillt a metaadataiból; ne feltételezze az univerzális perjeles parancsot.

Példaüzenetek:

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

Ha ismeri ezeket, adja meg az olyan megkötéseket, mint a modellszolgáltató, az üzemeltetési cél, az adatmegőrzési követelmények, a biztonsági határ és a célként megadott .NET-verzió.

A kódolási ügynök teendői

A képesség arra utasítja a kódoló ügynököt, hogy:

  • Vizsgálja meg a meglévő megoldást, beleértve a cél-keretrendszereket, az SDK-verziót, a csomagkezelést és a telepített Microsoft.Agents.AI.* csomagokat.
  • Válassza ki a legkisebb megfelelő mintát, például egyszerű ügynököt, tesztkörnyezetet, munkafolyamatot, orchestrationt vagy deklaratív definíciót.
  • Csak a releváns fókuszált hivatkozásokat töltse be.
  • Csak az alkalmazás által igényelt szűk csomagkészletet adja hozzá, és mielőtt függőségként használná őket, ellenőrizze az egyes csomagok érettségét, mert egyes csomagok előzetesek.
  • Olvassa el a végpontokat, modelleket és kulcsokat a konfigurációból, és előnyben részesítse a tokenes hitelesítő adatokat a hardkódolt API-kulcsokkal szemben.
  • Ellenőrizze a létrehozott alkalmazást az adattár meglévő tesztjeivel és futtatható mintáival.

A képesség nem garantálja, hogy a létrehozott kód éles használatra kész. Jóváhagyás előtt tekintse át a kódoló ügynök tervét, csomagválasztásait, biztonsági határait, parancsait és létrehozott módosításait.

Verziószámozás és bizalom

A skill egy nyilvános, telepíthető, Microsoft által karbantartott fogyasztói skill. A képesség metaadatainak verziója: 0.1.

  • Használja a @main ref használatát, amíg egy taggelt kiadás nem tartalmazza a skillt.
  • Mielőtt megbízik az új szkriptekben vagy utasításokban, a telepítés előtt tekintse át a képességek tartalmát, és tekintse át a frissítéseket.

A forrás- és a fókuszált hivatkozásokért lásd:

További lépések

Az első ügynök létrehozása

Mélyedjen el:

A Microsoft Agent Framework Pythonhoz készült builder-skilljeagent-framework-builder-python a kompatibilis kódolóügynökök számára a Microsoft által karbantartott útmutatást biztosít Python Agent Framework-megoldások létrehozásához. Segít a kódolási ügynöknek kiválasztani a megfelelő mintát, és fokozatosan betölteni a célzott útmutatást a feladathoz.

A képesség útmutatást adhat a munkához a következőkkel:

  • Egyszerű ügynökök, modellszolgáltatók, eszközök, jóváhagyások, munkamenetek, előzmények és kontextusszolgáltatók.
  • Használja ki az ügynököket tervezéssel, teendőlistákkal, memóriával, kontextustömörítéssel, fájlokkal, háttérügynökökkel, shelleszközökkel és hurkokkal.
  • Funkcionális és gráfalapú munkafolyamatok, beépített orchesztrációk és deklaratív definíciók.
  • Kiértékelés, megfigyelhetőség, middleware, egyéni kliensek, egyéni ügynökök és integrációk.
  • Saját üzemeltetésű és Microsoft Foundry által üzemeltetett ügynök fejlesztése.

A képesség csak Pythonban érhető el. Fejlesztési útmutatást nyújt egy külső kódoló ügynöknek; ez nem egy Python csomag, nem a(z) pip install agent-framework telepíti, és nem fut az Agent Framework-alkalmazásban.

Important

Ez a kódolóügynök-képesség eltér a futtatókörnyezeti Agent Skills elemtől. A futásidejű készségeket egy Agent Framework-ügynök tölti be az alkalmazás futtatása közben. A builder képesség segít a kódoló ügynöknek létrehozni vagy módosítani az alkalmazás forráskódját.

Tip

Párosítsa az építői készséget a Microsoft Learn MCP-kiszolgálóval. Ez a képesség a kódolási ügynökre összpontosító Agent Framework munkafolyamat- és megvalósítási útmutatást nyújt, míg a Learn MCP-kiszolgáló lehetővé teszi az aktuális Microsoft dokumentáció keresését, a teljes cikkek lekérését és a feladat során a kódminták keresését. Konfigurálja ezt a nyilvános, nem hitelesített streamelhető HTTP-végpontot egy kompatibilis kódolási ügynökben:

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

Prerequisites

  • Egy kódolóügynök, amely támogatja a nyílt Agent Skills specifikációt.
  • GitHub CLI az előnézeti gh skill parancsokkal, vagy a Node.js 22.20-es vagy újabb verzióját, ha az ügynökközi skills CLI-t használja.
  • Python 3.11 vagy újabb verzió. Az Agent Framework 1.24 már nem támogatja vagy teszteli a Python 3.10-et, bár a csomag metaadatai továbbra is lehetővé teszik a telepítést.

A GitHub CLI készségkezelése előzetes verzióban érhető el, és változhat.

Tekintse át és telepítse a GitHub CLI-val

A telepítés előtt tekintse meg a kiadott skill előnézetét:

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

Telepítse a legújabb taggelt verziót:

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

Rögzítse a Python 1.23 kiadást, ha reprodukálható útmutatásra van szüksége:

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

Az alapértelmezett telepítés projekthatókörű, és nem interaktív használat esetén a GitHub Copilotot célozza. Szükség esetén válasszon másik támogatott kódoló ügynököt vagy felhasználói hatókört:

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

Az aktuális ügyfél- és hatókörbeállításokat lásd: gh skill install.

Telepítés a cross-agent skills CLI-val

Alternatív megoldásként telepítse a skillt az ügynökközi skills parancssori felülettel:

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

A telepítés előtt tekintse át a parancssori felület támogatott kódoló ágenseit és futtatókörnyezeti követelményeit.

Használja a képességet

Adjon természetes utasítást a kódoló ügynöknek. A kompatibilis ügyfélalkalmazások felderítik és aktiválják a skillt a metaadataiból; ne feltételezze az univerzális perjeles parancsot.

Példaüzenetek:

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

Ha ismeri őket, foglalja bele az olyan korlátozásokat is, mint a modellszolgáltató, az üzemeltetési cél, a megőrzési követelmények, a biztonsági határ és a támogatott Python-verzió.

A kódolási ügynök teendői

A képesség arra utasítja a kódoló ügynököt, hogy:

  • Válassza ki a legkisebb megfelelő mintát, például egyszerű ügynököt, tesztkörnyezetet, munkafolyamatot, orchestrationt vagy deklaratív definíciót.
  • Csak a releváns fókuszált hivatkozásokat töltse be.
  • Részesítse előnyben az aktuális Microsoft Learn-útmutatót, a nyilvános API-referenciákat, a csomagéletciklus-információkat és a folyamatosan karbantartott mintákat a gyorsan változó részletekhez.
  • Telepítsen szűk csomagkészleteket ahelyett, hogy azt feltételezné, hogy minden integráció stabil vagy szükséges.
  • Az explicit munkamenetek, a jóváhagyás, a hitelesítés és az üzemeltetés határainak megőrzése.
  • Ellenőrizze a létrehozott alkalmazást a tárház meglévő tesztjeivel, típusellenőrzéseivel és futtatható mintáival.

A képesség nem garantálja, hogy a létrehozott kód éles használatra kész. Jóváhagyás előtt tekintse át a kódoló ügynök tervét, csomagválasztásait, biztonsági határait, parancsait és létrehozott módosításait.

Verziószámozás és bizalom

A készség egy nyilvános, telepíthető, Microsoft által karbantartott fogyasztói készség, amely az python-1.23.0 adattárcímkében került kiadásra. A képesség metaadatainak verziója: 0.3.

  • Használja a minősítés nélküli install parancsot a legújabb címkézett kiadáshoz.
  • Rögzítsd @python-1.23.0, ha a reprodukálhatóság számít.
  • Csak akkor használja a(z) @main elemet, ha szándékosan kiadatlan útmutatást szeretne.
  • Mielőtt megbízik az új szkriptekben vagy utasításokban, a telepítés előtt tekintse át a képességek tartalmát, és tekintse át a frissítéseket.

A forrás- és a fókuszált hivatkozásokért lásd:

További lépések

Az első ügynök létrehozása

Mélyedjen el:

Note

A Microsoft Agent Framework builder Go-hoz készült készsége még nem érhető el. Az aktuális útmutatáshoz használja a Go első lépések oktatóanyagát és az Agent Framework Go-példákat .

  • Utolsó frissítés időpontja: