Použití dovednosti Microsoft Foundry v programovacích agentech

Microsoft Foundry Skill poskytuje programovacím agentům opakovaně využitelné pokyny pro pracovní postupy agenta Foundry. Použijte jej ke standardizaci nasazení, hodnocení, optimalizaci promptů, správě datových sad na základě tras a řešení problémů v různých vývojových prostředích s podporou agentů.

Předpoklady

  • Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si bezplatný účet Azure.

  • Hostitel agenta kódování, jako je GitHub Copilot v Visual Studio Code, Copilot CLI nebo Claude Code.

  • Node.js 18 nebo novější ve vašem PATH. Modul plug-in používá npx ke spuštění serverů MCP v kompatibilních hostitelích.

  • Git, aby si hostitel mohl stáhnout modul plug-in a obsah dovedností.

  • Azure CLI nainstalované a ověřené:

    az login

  • Azure Developer CLI nainstalovaná a ověřená, pokud plánujete používat pracovní postupy nasazení azd:

    azd auth login

  • Projekt Microsoft Foundry, pokud chcete, aby agent kontroloval nebo upravoval prostředky v oboru projektu. Postup nastavení najdete v tématu Vytvoření projektu.

Co funkce Foundry Skill poskytuje

Dovednost microsoft-foundry je metadovednost pro práci ve Foundry. Pomáhá programovacímu agentu zvolit správný pracovní postup Foundry, načíst odpovídající dílčí dovednosti, zkontrolovat dostupné nástroje Foundry MCP a udržovat kontext nasazení a hodnocení konzistentní napříč jednotlivými procesy.

Použijte ho, když chcete, aby agent pomohl s těmito oblastmi schopností:

Oblast schopností S čím dovednost agentovi pomáhá
Začínáme s Foundry Vytvořte projekt Foundry nebo se k němu připojte, nasaďte prostředek Foundry, zvolte veřejné nebo síťově izolované nastavení a připravte pracovní prostor pro vývoj agentů.
Přístup a kapacita Zkontrolujte přiřazení RBAC, spravované identity, instanční objekty, kvótu, dostupnost modelu, kapacitu oblasti a požadavky na nasazení.
Nasazení modelu Nasaďte modely s rychlými předvolbami nebo vlastními nastaveními, jako jsou verze, skladová položka, kapacita a zodpovědná konfigurace AI.
Přizpůsobení modelu Dolaďujte modely pomocí supervidovaného dolaďování, přímé optimalizace preferencí nebo postupů dolaďování pomocí posilovaného učení.
Vytvoření agenta Vytvářejte hostované aplikace agentů, které používají Microsoft Rozhraní agentů, LangGraph nebo vlastní architektury v Python nebo C#.
Nasazení agenta Kontejnerizujte agenta, sestavte image a nahrajte je do Azure Container Registry, vytvořte nebo aktualizujte nasazení hostovaného agenta a po změnách kódu ho znovu nasaďte.
Vyvolání a testování Odesílejte zprávy v jednom či více kolech nasazeným agentům, testujte agenty pro promptování a hostované testovací agenty, které používají protokoly založené na HTTP nebo WebSocketu.
Hodnocení a optimalizace Spusťte dávkové vyhodnocení, nastavte průběžné vyhodnocování, porovnejte verze, optimalizujte výzvy, vylepšete pokyny agenta a připravte úlohy optimalizátoru agenta.
Trasování a práce s datovou sadou Trasujte dotazy, analyzujte latenci nebo selhání, propojujte výsledky vyhodnocení s odpověďmi a vytvářejte datové sady pro vyhodnocení z produkčních tras.
Troubleshooting Zkontrolujte protokoly hostovaného agenta, analyzujte telemetrická data, diagnostikujte selhání nasazení nebo selhání za běhu a naplánujte cyklus opravy a opětovného nasazení.

Nainstalovaná dovednost zahrnuje specializované poddovednosti pro tyto oblasti. Obvykle není nutné pojmenovat sub-dovednost přímo. Požádejte o požadovaný výsledek a agent kódování používá ke směrování úkolu pokyny pro dovednosti.

Installation

Rozšíření Foundry Toolkit pro VS Code je součástí Foundry Skill. Pokud chcete rozšíření nainstalovat, přečtěte si téma Work with the Microsoft Foundry for Visual Studio Code extension.

Po instalaci znovu načtěte Visual Studio Code, pokud k tomu budete vyzváni. Otevřete Copilot Chat, přepněte do režimu agenta a ověřte, že jsou k dispozici dovednosti Foundry. Po zobrazení výzvy se přihlaste pomocí účtu Azure, který má přístup k projektu Foundry.

Další informace o nastavení MCP v aplikaci Visual Studio Code viz Začínáme se serverem Azure MCP a Začínáme se serverem Foundry MCP.

Nainstalujte jen Foundry Skill

Pokud už vaše hostitelská aplikace má konfiguraci serveru MCP a potřebujete jen obsah dovednosti, nainstalujte dovednost microsoft-foundry přímo:

npx skills add https://github.com/microsoft/azure-skills --skill microsoft-foundry

Varianta pouze pro dovednosti stáhne pokyny k pracovnímu postupu ve Foundry. Modul plug-inu Azure Skills použijte, pokud chcete společně nainstalovat dovednost, konfiguraci serveru Azure MCP a konfiguraci serveru Foundry MCP.

Ověření nastavení

Po instalaci vyzkoušejte tyto kontroly z vašeho programovacího agenta:

  • Zeptejte se What AI models are available in Microsoft Foundry? Odpověď by měla místo obecného souhrnu používat nástroje Foundry.
  • Po ověření požádejte List my Azure resource groups. Odpověď by měla po ověření používat nástroje Azure MCP.
  • V projektu agenta Foundry požádejte Use the Microsoft Foundry Skill to review this agent for deployment readiness. Odpověď by měla identifikovat kontroly pracovního postupu, jako je konfigurace, přístup k projektu, nasazení modelu, vyhodnocovací data a ověřování nasazení.

Pokud kontrola selže, restartujte hostitele, ověřte, že se modul plug-in úspěšně nainstaloval, a ověřte, že az login používá předplatné, které obsahuje vaše prostředky Foundry.

Použití dovednosti v projektu

Otevřete složku, která obsahuje kód agenta Foundry. Požádejte o výsledek, kterého chcete dosáhnout, a uveďte cílový projekt, prostředí, složku agenta nebo název nasazení, pokud je už znáte.

Chcete-li využít funkce dovednosti, použijte tyto vzory promptů:

Cíl Příklad výzvy Typický pracovní postup
Nastavení Foundry pro nového agenta Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Nastavení projektu, nasazení modelu, vytvoření agenta, nasazení a vyvolání.
Nastavení privátního prostředí Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Plánování privátní sítě, výběr šablony, kontroly nasazení a ověřování
Nasazení existujícího hostovaného agenta Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Určení kontextu pracovního prostoru, sestavení kontejneru, nahrání do ACR, nasazení hostovaného agenta a základní test.
Opětovné nasazení po změně kódu Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Aktualizace nasazení, vyvolání a následné vyhodnocení
Otestujte agenta Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Vyhledávání agentů, vyvolání a kontrola odpovědí
Vyhodnocení kvality Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Nastavení sady vyhodnocení, kontroly datových sad a vyhodnocovače, dávkové vyhodnocení a souhrn výsledků
Optimalizace pokynů Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Analýza vyhodnocení, optimalizace výzvy, kontrola kandidáta a následné vyhodnocení
Vytvoření zkušební datové sady Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Trasování dotazu, curace datové sady, správa verzí a sledování rodokmenu
Vyřešte problém se selháním Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Kontrola volání, protokoly, telemetrie, analýza původní příčiny, plán opravy, opětovné nasazení a opětovné testování.
Kontrola přístupu nebo kapacity Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Kontrola přiřazení rolí, vyhledávání kvót, plánování kapacity a nápravné kroky
Vyladění modelu Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Připravenost na datovou sadu, nastavení trénování, kontrola kontrolního bodu, nasazení modelu a vyhodnocení.

Než schválíte změny nebo příkazy, zkontrolujte plán, vygenerované soubory a Azure prostředky, které agent navrhuje vytvořit nebo upravit. U úloh nasazení, vyladění a zřizování potvrďte přiřazení rolí a nákladové prostředky před spuštěním příkazů agenta.

Použití dovedností v sadě Foundry Toolkit ve VS Code

Foundry Toolkit pro Visual Studio Code také zpřístupňuje dovednosti specifické pro Foundry ve VS Code. Tyto dovednosti, například vscode-microsoft-foundry a foundrytk-quick-start, se zaměřují na vývojové prostředí VS Code: onboarding do Foundry Toolkit, zkoumání modelů, sestavování agentů, výběr modelu, nasazení agenta, vyhodnocení výkonu a správa nástrojů. Liší se od základní dovednosti microsoft-foundry, která poskytuje širší základ znalostí a konkrétní podrobnosti o pracovních postupech pro správu prostředků Foundry, RBAC, kvót, nasazování modelů, nasazování hostovaných agentů, vyhodnocování, trasování a řešení potíží. Nainstalujte Foundry Toolkit pro VS Code, abyste tyto dovednosti poskytované rozšířením zpřístupnily v prostředí agenta VS Code.

Jak dovednost funguje

Když agent kódování používá Microsoft Foundry Skill, řídí se několika běžnými vzory:

  1. Začíná zjišťováním Foundry MCP, aby věděl, které nástroje a parametry Foundry jsou ve vašem prostředí k dispozici.
  2. Načte dílčí dovednost, která odpovídá vašemu pracovnímu postupu, například vytváření, nasazení, spuštění, vyhodnocování, trasování, řešení potíží, řízení přístupu na základě rolí, kvóty nebo nasazení modelu.
  3. Řeší kontext projektu a agenta z vašeho pracovního prostoru předtím, než navrhne změny nebo příkazy.
  4. Preferuje strukturované Foundry a Azure nástroje MCP, pokud jsou k dispozici.
  5. O chybějící hodnoty žádá jen tehdy, když je nelze zjistit z vašeho zadání, souborů pracovního prostoru nebo ověřeného kontextu Azure.

Dovednost podporuje dva běžné typy agentů:

Typ agenta Případ použití
Rychlý agent Agent využívající LLM, který používá nasazení modelu a konfiguraci promptu.
Hostovaný agent Agent založený na kontejneru, který spouští vlastní kód ve službě Foundry Agent Service.

Pro pracovní postupy hostovaných agentů lze dovednost použít také s agenty, kteří využívají protokoly responses, invocations nebo invocations_ws. Použijte invocations_ws pro scénáře WebSocketu v reálném čase nebo pro duplexní komunikaci, jako jsou hlasoví agenti nebo streamované interakce.

Soubory pracovního prostoru, které funkce používá

Dovednost vyhledává kontext projektu Foundry a agenta v běžných souborech pracovního prostoru. Udržujte tyto soubory v aktuálním stavu, aby váš programovací agent mohl provádět konkrétní opakovatelná doporučení.

Soubor nebo složka Jak ji dovednost používá
azure.yaml Najde azd služby, složky projektů agenta, nastavení hostitele pro nasazení, vazby prostředí a konfiguraci místního agenta pro vytváření, nasazení, spouštění a vyhodnocování.
.azure/<environment>/.env Zjišťuje ověřené hodnoty prostředí azd, jako jsou předplatné, skupina prostředků, koncový bod projektu, název agenta, registr a připojovací řetězec Application Insights.
.foundry/agent-metadata.yaml Ukládá stav překrytí specifického pro Foundry, jako jsou odkazy na vyhodnocovací sadu, odkazy na datové sady, cesty k lokální mezipaměti, souhrny výsledků a přepsání jiná než azd.
.foundry/agent-metadata.<env>.yaml Ukládá stav překrytí specifické pro prostředí pro cíl, jako je produkční prostředí nebo CI.
eval.yaml Definuje místní parametry vyhodnocení, jako jsou soubor datové sady, názvy vyhodnocovačů, prahová hodnota úspěšnosti, počet vzorků, rozsah zpětného dohledání trasování a pokyny pro generování.

Pro postupy pro nasazení a vyhodnocení upřednostněte .foundry/agent-metadata.yaml pro neutajovaný stav překryvné vrstvy. Neukládejte tajné kódy do .foundry souborů. Pokud azd už poskytuje hodnotu nasazení, například koncový bod projektu nebo registr, nechte agenta kódování použít azd hodnotu místo duplikování v metadatech.

Troubleshooting

Problém Resolution
Host skill nenajde. Potvrďte, že se plugin úspěšně nainstaloval, a potom obnovte nebo restartujte hostitelskou aplikaci, aby znovu indexovala obsah pluginu.
Nástroje MCP se nezobrazují. Ověřte, že je nainstalovaná Node.js, npx funguje a položky serveru Azure a Foundry MCP byly přidány pro vašeho hostitele.
Požadavky Azure selhávají kvůli chybám ověřování. Spusťte az login znovu. Pro workflowy azd také spusťte azd auth login.
Agent používá nesprávné předplatné. Před opakováním výzvy nastavte zamýšlené Azure předplatné v Azure CLI.
Operace projektu Foundry selhávají. Ověřte, že váš účet má přístup k projektu Foundry a požadované role Azure RBAC.

Související obsah

  • Last updated on