Använda Microsoft Foundry Skill i kodningsagenter

Microsoft Foundry Skill ger kodningsagenter återanvändbar vägledning för Foundry-agentarbetsflöden. Använd den för att standardisera distribution, utvärdering, snabboptimering, datamängdskuration från spårningar och felsökning av uppgifter i agentaktiverade utvecklingsmiljöer.

Förutsättningar

  • Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapa ett kostnadsfritt Azure konto.

  • En kodningsagentvärd, till exempel GitHub Copilot i Visual Studio Code, Copilot CLI eller Claude Code.

  • Node.js 18 eller senare på din PATH. Plugin-programmet använder npx för att starta MCP-servrar i kompatibla värdar.

  • Git, så att värden kan ladda ned insticksprogram och färdighetsinnehåll.

  • Azure CLI installerat och autentiserat:

    az login

  • Azure Developer CLI installerat och autentiserat om du planerar att använda azd distributionsarbetsflöden:

    azd auth login

  • Ett Microsoft Foundry-projekt om du vill att agenten ska inspektera eller ändra resurser med projektomfattning. Installationssteg finns i Skapa ett projekt.

Vad Foundry Skill tillhandahåller

Färdigheten microsoft-foundry är en metafärdighet för Foundry-arbete. Det hjälper en kodningsagent att välja rätt Foundry-arbetsflöde, läsa in matchande underkunskaper, inspektera tillgängliga Foundry MCP-verktyg och hålla distributions- och utvärderingskontexten konsekvent mellan olika svängar.

Använd den när du vill att agenten ska hjälpa till med dessa kapacitetsområden:

Kapacitetsområde Vad kunskapen hjälper agenten att göra
Onboarding för foundry Skapa eller anslut till ett Foundry-projekt, etablera en Foundry-resurs, välj offentlig eller nätverksisolerad installation och förbered arbetsytan för agentutveckling.
Åtkomst och kapacitet Kontrollera RBAC-tilldelningar, hanterade identiteter, tjänstens huvudnamn, kvot, modelltillgänglighet, regionkapacitet och distributionskrav.
Modellimplementering Distribuera modeller med snabbförinställningar eller anpassade inställningar som version, SKU, kapacitet och ansvarsfull AI-konfiguration.
Modellanpassning Finjustera modeller med övervakad finjustering, direkt inställningsoptimering eller förstärkta finjusteringsarbetsflöden.
Skapa agent Skapa värdbaserade agentprogram som använder Microsoft Agent Framework, LangGraph eller anpassade ramverk i Python eller C#.
Agentdistributionen Paketera en agent i en container, bygg och skicka avbildningar till Azure Container Registry, skapa eller uppdatera distributioner av värdbaserade agenter och omdistribuera efter kodändringar.
Anrop och testning Skicka enkelmeddelanden eller fleromgångsmeddelanden till driftsatta agenter, promptagenter för test och värdbaserade testagenter som använder HTTP- eller WebSocket-baserade protokoll.
Utvärdering och optimering Kör batchutvärderingar, konfigurera kontinuerlig utvärdering, jämför versioner, optimera prompter, förbättra agentinstruktioner och förbereda agentoptimerarjobb.
Arbete med spår och datauppsättningar Spåra frågor, analysera svarstider eller fel, korrelera utvärderingsresultat med svar och sammanställ utvärderingsdataset från produktionsspår.
Troubleshooting Granska värdbaserade agentloggar, fråga telemetri, diagnostisera distributions- eller körningsfel och planera en reparations- och omdistribueringsloop.

Den installerade kompetensen innehåller specialiserade delkompetenser för dessa områden. Du behöver vanligtvis inte namnge underkompetensen direkt. Fråga efter önskat resultat och kodningsagenten använder kunskapsinstruktionerna för att dirigera uppgiften.

Installation

Foundry Toolkit-tillägget för VS Code levereras med Foundry Skill. Information om hur du installerar tillägget finns i Work with the Microsoft Foundry for Visual Studio Code extension.

Efter installationen läser du in Visual Studio Code igen om du uppmanas att göra det. Öppna Copilot Chat, växla till agentläge och bekräfta att Foundry-kunskaper är tillgängliga. Logga in med Azure-kontot som har åtkomst till ditt Foundry-projekt när du uppmanas att göra det.

Mer information om MCP-installation i Visual Studio Code finns i Get started with the Azure MCP Server and Get started with Foundry MCP Server.

Om din värd redan har MCP-serverkonfiguration och du bara behöver kunskapsinnehållet installerar du färdigheten microsoft-foundry direkt:

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

Alternativet endast för färdigheter laddar ned vägledning för Foundry-arbetsflödet. Använd Azure Skills Plugin när du vill ha kunskaper, Azure MCP Server-konfiguration och Foundry MCP Server-konfiguration installerad tillsammans.

Kontrollera konfigurationen

Efter installationen provar du dessa kontroller från kodningsagenten:

  • Fråga What AI models are available in Microsoft Foundry? Svaret bör använda Foundry-verktyg i stället för en allmän sammanfattning.
  • Fråga List my Azure resource groups. Svaret bör använda Azure MCP-verktyg när du har autentiserats.
  • I ett Foundry-agentprojekt frågar du Use the Microsoft Foundry Skill to review this agent for deployment readiness. Svaret bör identifiera arbetsflödeskontroller som konfiguration, projektåtkomst, modelldistribution, utvärderingsdata och distributionsverifiering.

Om en kontroll misslyckas läser du in värden på nytt, bekräftar att insticksprogrammet har installerats korrekt och kontrollerar att az login använder den prenumeration som innehåller dina Foundry-resurser.

Använda kunskapen i ett projekt

Öppna mappen som innehåller foundry-agentkoden. Fråga efter önskat resultat och inkludera målprojektet, miljön, agentmappen eller distributionsnamnet om du redan känner till det.

Använd de här promptmönstren för att anropa kompetensens funktioner:

Mål Exempelprompt Typiskt arbetsflöde
Konfigurera Foundry för en ny agent Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Projektkonfiguration, driftsättning av modeller, skapande av agenter, driftsättning och anrop.
Konfigurera en privat miljö Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Planering för privat nätverk, val av mall, distributionskontroller och validering.
Distribuera en befintlig värdbaserad agent Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Tolkning av arbetsytekontext, containerkompilering, ACR-push, driftsättning av värdbaserad agent och smoketest.
Distribuera om efter kodändringar Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Distributionsuppdatering, anrop och utvärderingsuppföljning.
Testa en agent Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Agentsökning, anrop och svarsgranskning.
Utvärdera kvalitet Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Konfiguration av utvärderingspaket, datauppsättnings- och utvärderarkontroller, batchutvärdering och resultatsammanfattning.
Optimera instruktioner Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Utvärderingsanalys, snabboptimering, kandidatgranskning och uppföljningsutvärdering.
Skapa en utvärderingsdatauppsättning Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Spårningsfråga, datamängdshärdning, versionshantering och ursprungsspårning.
Felsöka ett fel Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Kontroll av anrop, loggar, telemetri, grundorsaksanalys, reparationsplan, omdriftsättning och omtest.
Kontrollera åtkomst eller kapacitet Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Granskning av rolltilldelning, kvotsökning, kapacitetsplanering och reparationssteg.
Finjustera en modell Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Datamängdsberedskap, träningskonfiguration, kontrollpunktsgranskning, modelldistribution och utvärdering.

Innan du godkänner ändringar eller kommandon granskar du planen, genererade filer och Azure resurser som agenten föreslår att skapa eller ändra. För distributions-, finjusterings- och etableringsuppgifter bekräftar du rolltilldelningar och kostnadsbärande resurser innan agenten kör kommandon.

Använda Foundry Toolkit-kunskaper i VS Code

Foundry Toolkit för Visual Studio Code gör också Foundry-specifika kunskaper tillgängliga i VS Code. Dessa kunskaper, till exempel vscode-microsoft-foundry och foundrytk-quick-start, fokuserar på VS Code-utvecklingsupplevelsen: registrering till Foundry Toolkit, utforska modeller, byggagenter, välja en modell, distribuera en agent, utvärdera prestanda och hantera verktygslådor. De skiljer sig från kärnkompetensen microsoft-foundry , som ger den bredare kunskapsbasen och konkret arbetsflödesinformation för Foundry-resurshantering, RBAC, kvoter, modelldistribution, värdbaserad agentdistribution, utvärdering, spårning och felsökning. Installera Foundry Toolkit för VS Code för att göra dessa tilläggskunskaper tillgängliga i din VS Code-agentupplevelse.

Så här fungerar färdigheten

När en kodningsagent använder Microsoft Foundry Skill följer den några vanliga mönster:

  1. Den börjar med Foundry MCP-identifiering så att den vet vilka Foundry-verktyg och parametrar som är tillgängliga i din miljö.
  2. Den läser in den underkompetens som matchar ditt arbetsflöde, till exempel skapande, distribution, anrop, utvärdering, spårning, felsökning, RBAC, kvot eller modelldistribution.
  3. Den löser projekt- och agentkontexten från din arbetsyta innan den föreslår ändringar eller kommandon.
  4. Den föredrar strukturerade Foundry- och Azure MCP-verktyg när de är tillgängliga.
  5. Den efterfrågar endast saknade värden när de inte kan utläsas från din prompt, arbetsytefiler eller den autentiserade Azure-kontexten.

Kunskapen stöder två vanliga agenttyper:

Agenttyp Användningsfall
Snabb agent En LLM-baserad agent som använder en modelldistribution och en promptkonfiguration.
Värdbaserad agent En containerbaserad agent som kör anpassad kod i Foundry Agent Service.

För värdbaserade agentarbetsflöden kan färdigheten också fungera med agenter som använder protokollen responses, invocationseller invocations_ws . Används invocations_ws för realtids- eller duplex-WebSocket-scenarier, till exempel röstagenter eller strömningsinteraktioner.

Filer i arbetsytan som färdigheten använder

Funktionen söker efter projekt- och agentkontext för Foundry i vanliga filer i arbetsytan. Håll filerna aktuella så att kodningsagenten kan ge specifika, repeterbara rekommendationer.

Fil eller mapp Hur kunskapen använder den
azure.yaml Hittar azd tjänster, agentprojektmappar, värdinställningar för distribution och miljöbindningar.
.azure/<environment>/.env Löser autentiserade azd miljövärden som prenumeration, resursgrupp, projektslutpunkt, agentnamn, register och Application Insights reťazec pripojenia.
.foundry/agent-metadata.yaml Lagrar Foundry-specifikt överlagringstillstånd, till exempel referenser till utvärderingssviter, datauppsättningsreferenser, lokala cachesökvägar, resultatsammanfattningar och icke-azdåsidosättningar.
.foundry/agent-metadata.<env>.yaml Lagrar miljöspecifikt överlagringstillstånd för ett mål, såsom produktion eller CI.
agent.yaml Tillhandahåller lokal agentkonfiguration för arbetsflöden för att skapa, distribuera, anropa och utvärdera.
eval.yaml Definierar avsikten för lokal utvärdering, till exempel datamängdsfil, utvärderarnamn, tröskelvärde för passering, exempelantal, spårningsåtersökning och instruktioner för generering.

För driftsättnings- och utvärderingsarbetsflöden bör du använda .foundry/agent-metadata.yaml för icke-hemligt överlagringstillstånd. Lagra inte hemligheter i .foundry filer. Om azd redan anger ett driftsättningsvärde, till exempel en projektändpunkt eller ett register, låt kodningsagenten använda värdet azd i stället för att duplicera det i metadata.

Troubleshooting

Problematik Lösning
Värden hittar inte kunskapen. Kontrollera att pluginet har installerats korrekt och läs sedan in värdprogrammet på nytt eller starta om det så att plugininnehållet indexeras om.
MCP-verktyg visas inte. Kontrollera att Node.js är installerat, att npx fungerar och att Azure- och Foundry-MCP-serverposter har lagts till på värddatorn.
Azure begäranden misslyckas med autentiseringsfel. Kör az login igen. För azd arbetsflöden, kör även azd auth login.
Agenten använder fel prenumeration. Ange den avsedda Azure prenumerationen i Azure CLI innan du försöker fråga igen.
Åtgärder i Foundry-projektet misslyckas. Bekräfta att ditt konto har åtkomst till Foundry-projektet och att det krävs Azure RBAC-roller.

Relaterat innehåll

  • Last updated on