Vytvářejte aplikace Agent Frameworku pomocí asistenta pro psaní kódu

Dovednost tvůrce Microsoft Agent Framework pro .NETagent-framework-builder-dotnet poskytuje kompatibilním kódovacím agentům pokyny spravované společností Microsoft pro vytváření řešení .NET (C#) Agent Framework. Pomáhá kódovacímu agentovi zvolit vhodný vzor a postupně načíst pokyny zaměřené na úlohu.

Dovednost může pomoci při práci s:

  • Prosté agenty, poskytovatelé modelů, nástroje, relace, historie, zprostředkovatelé kontextu a middleware.
  • Využijte agenty s todos, režimy, pamětí, schvalováním, dovednostmi, agenty na pozadí, shellovými nástroji, komprimací a smyčkami.
  • Pracovní postupy a integrované orchestrace a deklarativní definice
  • Vyhodnocení, pozorovatelnost, vlastní klienti, vlastní agenti a integrace
  • Hosting a nasazení.

Tato dovednost poskytuje pokyny pro vývoj externímu kódovacímu agentovi. Nejedná se o balíček NuGet a nespouští se v rámci vaší aplikace Agent Framework.

Important

Tato dovednost programovacího agenta se liší od dovedností agenta Runtime. Dovednosti runtime načítá agent frameworku Agent Framework během spouštění vaší aplikace. Dovednost Builder pomáhá programovacímu agentu vytvořit nebo upravit zdrojový kód vaší aplikace.

Tip

Spárujte dovednost tvůrce se serverem Microsoft Learn MCP. Tato dovednost poskytuje programovacímu agentu cílené pokyny k pracovnímu postupu a implementaci v rámci Agent Frameworku, zatímco Learn MCP Server mu umožňuje prohledávat aktuální dokumentaci Microsoftu, načítat kompletní články a vyhledávat ukázky kódu během úlohy. Nakonfigurujte tento veřejný, neověřený koncový bod Streamable HTTP v kompatibilním programovacím agentu:

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

Požadavky

  • Programovací agent, který podporuje otevřenou Agent Skills specification.
  • GitHub CLI s příkazy preview gh skill, nebo Node.js 22.20 nebo novější, pokud používáte skills cross-agent CLI.
  • Aktuálně podporovaná sada .NET SDK pro nové aplikace Agent Framework.

Správa dovedností GitHub CLI je ve verzi Preview a může se změnit.

Zkontrolujte a nainstalujte pomocí GitHub CLI

Dovednost .NET builderu ještě není v tagovaném vydání, takže musíte zadat ref @main. Před instalací si dovednost nejdřív prohlédněte:

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

Nainstalujte si skill:

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

Výchozí instalace je vymezená na projekt a je určena pro GitHub Copilot v neinteraktivním použití. V případě potřeby vyberte jiného podporovaného agenta pro psaní kódu nebo uživatelský kontext:

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

Aktuální možnosti klienta a rozsahu naleznete v tématu gh skill install.

Instalace pomocí CLI cross-agent skills

Jako alternativu nainstalujte dovednost pomocí cross-agent skills CLI:

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

Před instalací si projděte v CLI podporované agenty pro psaní kódu a požadavky na runtime.

Použijte dovednost

Přirozeně vyzývěte programovacího agenta. Kompatibilní klienti zjišťují a aktivují dovednost z jeho metadat; nepředpokládejte univerzální příkaz se lomítkem.

Příklady výzev:

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

Uveďte omezení, jako je poskytovatel modelu, cíl hostování, požadavky na trvalost, hranice zabezpečení a cílová .NET verze, pokud je znáte.

Co má agent kódování dělat

Dovednost dává kódovacímu agentovi pokyn, aby:

  • Prozkoumejte stávající řešení, včetně cílových frameworků, verze sady SDK, správy balíčků a nainstalovaných Microsoft.Agents.AI.* balíčků.
  • Vyberte nejmenší vhodný vzor, například prostý agent, zapojení, pracovní postup, orchestraci nebo deklarativní definici.
  • Načtěte pouze relevantní referenční položky, na které je aktuálně zaměřeno zobrazení.
  • Přidejte pouze úzkou sadu balíčků, které aplikace potřebuje, a předtím, než se na nich stanete závislí, zkontrolujte vyspělost jednotlivých balíčků, protože některé balíčky jsou předběžné.
  • Přečtěte endpointy, modely a klíče z konfigurace a upřednostněte přihlašovací údaje tokenu před pevně zakódovanými klíči rozhraní API.
  • Ověřte vygenerovanou aplikaci pomocí stávajících testů repozitáře a spustitelných ukázek.

Dovednost nezaručuje, že vygenerovaný kód je připravený pro produkční prostředí. Před schválením zkontrolujte plán agenta kódování, volby balíčků, hranice zabezpečení, příkazy a vygenerované změny.

Správa verzí a důvěra

Dovednost je veřejná, instalovatelná dovednost pro spotřebitele spravovaná společností Microsoft. Jeho verze metadat dovedností je 0.1.

  • Použijte @main ref, dokud tagované vydání neobsahuje dovednost.
  • Před instalací si můžete zobrazit náhled obsahu dovedností a zkontrolovat aktualizace, než jim začnete důvěřovat u nových skriptů nebo pokynů.

Informace o zdrojových a zaměřených referencích najdete tady:

Další kroky

Vytvoření prvního agenta

Jděte hlouběji:

Dovednost Builder Microsoft Agent Framework pro Python poskytuje agent-framework-builder-python kompatibilním kódovacím agentům pokyny od Microsoftu pro vytváření řešení Python Agent Framework. Pomáhá kódovacímu agentovi zvolit vhodný vzor a postupně načíst pokyny zaměřené na úlohu.

Dovednost může pomoci při práci s:

  • Jednoduché agenty, poskytovatelé modelů, nástroje, schválení, sezení, historie a zprostředkovatelé kontextu
  • Využijte agenty s plánováním, todos, pamětí, kompaktací, soubory, agenty na pozadí, nástroji příkazového řádku a smyčkami.
  • Funkční a grafové pracovní postupy, integrované orchestrace a deklarativní definice.
  • Vyhodnocení, pozorovatelnost, middleware, vlastní klienti, vlastní agenti a integrace
  • Vývoj self-hostingu a hostovaného agenta Microsoft Foundry.

Dovednost je pouze pro Python. Poskytuje pokyny pro vývoj externímu agentovi pro psaní kódu; nejedná se o balíček Python, není instalován pomocí pip install agent-framework a nespouští se v aplikaci Agent Framework.

Important

Tato dovednost programovacího agenta se liší od dovedností agenta Runtime. Dovednosti runtime načítá agent frameworku Agent Framework během spouštění vaší aplikace. Dovednost Builder pomáhá programovacímu agentu vytvořit nebo upravit zdrojový kód vaší aplikace.

Tip

Spárujte dovednost tvůrce se serverem Microsoft Learn MCP. Tato dovednost poskytuje programovacímu agentu cílené pokyny k pracovnímu postupu a implementaci v rámci Agent Frameworku, zatímco Learn MCP Server mu umožňuje prohledávat aktuální dokumentaci Microsoftu, načítat kompletní články a vyhledávat ukázky kódu během úlohy. Nakonfigurujte tento veřejný, neověřený koncový bod Streamable HTTP v kompatibilním programovacím agentu:

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

Požadavky

  • Programovací agent, který podporuje otevřenou Agent Skills specification.
  • GitHub CLI s příkazy preview gh skill, nebo Node.js 22.20 nebo novější, pokud používáte skills cross-agent CLI.
  • Python 3.11 nebo novější. Agent Framework 1.24 už nepodporuje ani netestuje Python 3.10, i když metadata balíčků stále umožňují instalaci.

Správa dovedností GitHub CLI je ve verzi Preview a může se změnit.

Zkontrolujte a nainstalujte pomocí GitHub CLI

Zobrazte si náhled vydané dovednosti před instalací:

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

Nainstalujte nejnovější označenou verzi:

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

Připněte Python verze 1.23, pokud potřebujete reprodukovatelná doporučení:

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

Výchozí instalace je vymezená na projekt a je určena pro GitHub Copilot v neinteraktivním použití. V případě potřeby vyberte jiného podporovaného agenta pro psaní kódu nebo uživatelský kontext:

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

Aktuální možnosti klienta a rozsahu naleznete v tématu gh skill install.

Instalace pomocí CLI cross-agent skills

Jako alternativu nainstalujte dovednost pomocí cross-agent skills CLI:

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

Před instalací si projděte v CLI podporované agenty pro psaní kódu a požadavky na runtime.

Použijte dovednost

Přirozeně vyzývěte programovacího agenta. Kompatibilní klienti zjišťují a aktivují dovednost z jeho metadat; nepředpokládejte univerzální příkaz se lomítkem.

Příklady výzev:

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

Uveďte omezení, jako je poskytovatel modelu, cíl hostování, požadavky na trvalost, hranice zabezpečení a podporovaná verze Python, když je znáte.

Co má agent kódování dělat

Dovednost dává kódovacímu agentovi pokyn, aby:

  • Vyberte nejmenší vhodný vzor, například prostý agent, zapojení, pracovní postup, orchestraci nebo deklarativní definici.
  • Načtěte pouze relevantní referenční položky, na které je aktuálně zaměřeno zobrazení.
  • Upřednostněte aktuální pokyny Microsoft Learn, reference k veřejnému rozhraní API, informace o životním cyklu balíčků a udržované ukázky pro nestálé podrobnosti.
  • Nainstalujte úzké sady balíčků spíše než nepředpokládejte, že každá integrace je stabilní nebo požadovaná.
  • Zachovejte jasně vymezené hranice relace, schvalování, ověřování a hostingu
  • Ověřte vygenerovanou aplikaci pomocí existujících testů repozitáře, kontrol typů a spustitelných ukázek.

Dovednost nezaručuje, že vygenerovaný kód je připravený pro produkční prostředí. Před schválením zkontrolujte plán agenta kódování, volby balíčků, hranice zabezpečení, příkazy a vygenerované změny.

Správa verzí a důvěra

Dovednost je veřejná, instalovatelná, spotřebitelská dovednost udržovaná společností Microsoft vydaná v tagu repozitáře python-1.23.0. Jeho verze metadat dovedností je 0.3.

  • Pro nejnovější označenou verzi použijte příkaz install bez upřesnění.
  • Připněte @python-1.23.0, když záleží na reprodukovatelnosti.
  • Používejte @main pouze v případech, kdy záměrně chcete nevydané pokyny.
  • Před instalací si můžete zobrazit náhled obsahu dovedností a zkontrolovat aktualizace, než jim začnete důvěřovat u nových skriptů nebo pokynů.

Informace o zdrojových a zaměřených referencích najdete tady:

Další kroky

Vytvoření prvního agenta

Jděte hlouběji:

Note

Dovednost pro vytváření v Microsoft Agent Framework pro Go ještě není dostupná. Aktuální doprovodné materiály najdete v úvodním kurzu Go a v příkladech pro Agent Framework Go.

  • Poslední aktualizace v