De Microsoft Foundry Skill gebruiken in het coderen van agents

De Microsoft Foundry Skill biedt herbruikbare richtlijnen voor het coderen van agents voor Foundry-agentwerkstromen. Gebruik dit om te helpen bij het standaardiseren van implementatie, evaluatie, optimalisatie van prompts, gegevenssetcuratie uit traceringen en probleemoplossingstaken in ontwikkelomgevingen met agents.

Prerequisites

  • Een Azure-account met een actief abonnement. Als u er nog geen hebt, maakt u een gratis Azure-account.

  • Een host voor coderingsagenten, zoals GitHub Copilot in Visual Studio Code, Copilot CLI of Claude Code.

  • Node.js 18 of hoger op uw PATH. De invoegtoepassing gebruikt npx om MCP-servers op compatibele hosts te starten.

  • Git, zodat de host plug-ins en inhoud voor vaardigheden kan downloaden.

  • Azure CLI geïnstalleerd en geverifieerd:

    az login

  • Azure Developer CLI geïnstalleerd en geverifieerd als u azd-implementatiewerkstromen wilt gebruiken:

    azd auth login

  • Een Microsoft Foundry-project als u wilt dat de agent resources binnen projectbereik inspecteert of wijzigt. Zie Een project maken voor installatiestappen.

Wat de Foundry Skill biedt

De microsoft-foundry vaardigheid is een meta-vaardigheid voor Foundry-werk. Het helpt een coderingsagent de juiste Foundry-werkstroom te kiezen, de overeenkomende subvaardigheid te laden, beschikbare Foundry MCP-hulpprogramma's te inspecteren en de implementatie- en evaluatiecontext consistent te houden op verschillende momenten.

Gebruik deze als u wilt dat de agent u kan helpen met deze mogelijkheden:

Mogelijkheidsgebied Wat de vaardigheid de agent helpt te doen
Aan de slag met Foundry Maak een Foundry-project of maak er verbinding mee, richt een Foundry-resource in, kies een openbare of netwerkgeïsoleerde configuratie en bereid de werkruimte voor op agentontwikkeling.
Toegang en capaciteit Controleer RBAC-toewijzingen, beheerde identiteiten, service-principals, quota, modelbeschikbaarheid, regiocapaciteit en implementatievereisten.
Modellenimplementatie Implementeer modellen met snelle voorinstellingen of aangepaste instellingen, zoals versie, SKU, capaciteit en verantwoorde AI-configuratie.
Model Aanpassing Verfijn modellen met afstemming onder supervisie, optimalisatie van directe voorkeur of versterking van werkstromen voor afstemming.
Agent maken Maak gehoste agenttoepassingen die gebruikmaken van Microsoft Agent Framework, LangGraph of aangepaste frameworks in Python of C#.
Implementatie van de agent Containeriseer een agent, bouw en push installaties naar Azure Container Registry, maak implementaties van gehoste agents of werk deze bij, en implementeer opnieuw na codewijzigingen.
Aanroepen en testen Verzend berichten met één of meerdere beurten naar geïmplementeerde agents, testpromptagents en test gehoste agents die gebruikmaken van HTTP- of WebSocket-protocollen.
Evaluatie en optimalisatie Voer batchevaluaties uit, stel continue evaluatie in, vergelijk versies, optimaliseer prompts, verbeter agentinstructies en bereid Agent Optimizer-taken voor.
Werk traceren en gegevenssets Querytraceringen uitvoeren, latentie of fouten analyseren, evaluatieresultaten correleren met antwoorden en evaluatiegegevenssets van productietraceringen cureren.
Troubleshooting Bekijk logboeken van gehoste agents, vraag telemetriegegevens op, diagnosticeer uitrol- of runtimefouten en plan een herstel- en heruitrolcyclus.

De geïnstalleerde vaardigheid bevat gespecialiseerde subvaardigheden voor deze gebieden. Meestal hoeft u de subvaardigheid niet rechtstreeks een naam te geven. Vraag om het gewenste resultaat en de coderingsagent gebruikt de vaardigheidsinstructies om de taak te routeren.

Installation

De Foundry Toolkit-extensie voor VS Code wordt geleverd met de Foundry Skill. Zie Work with the Microsoft Foundry for Visual Studio Code extension om de extensie te installeren.

Na de installatie laadt u Visual Studio Code opnieuw als hierom wordt gevraagd. Open Copilot Chat, schakel over naar de agentmodus en controleer of foundry-vaardigheden beschikbaar zijn. Meld u aan met het Azure-account dat toegang heeft tot uw Foundry-project wanneer u hierom wordt gevraagd.

Zie Get started with the Azure MCP Server and Get started with Foundry MCP Server voor meer informatie over mcp-installatie in Visual Studio Code.

Als uw host al een MCP-serverconfiguratie heeft en u alleen de vaardigheidsinhoud nodig hebt, installeert u de microsoft-foundry vaardigheid rechtstreeks:

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

Het pad met alleen vaardigheden downloadt de richtlijnen voor de Foundry-workflow. Gebruik de Azure Skills Plugin wanneer u de vaardigheid, Azure MCP Server-configuratie en Foundry MCP Server-configuratie samen wilt installeren.

De installatie controleren

Voer na de installatie de volgende controles uit vanuit uw coderingsagent:

  • Vraag What AI models are available in Microsoft Foundry? Het antwoord moet gebruikmaken van Foundry-hulpprogramma's in plaats van een algemeen overzicht.
  • Vraag List my Azure resource groups. Het antwoord moet Azure MCP-hulpprogramma's gebruiken nadat u zich hebt geverifieerd.
  • Vraag in een Foundry-agentproject Use the Microsoft Foundry Skill to review this agent for deployment readiness. Het antwoord moet werkstroomcontroles identificeren, zoals configuratie, projecttoegang, modelimplementatie, evaluatiegegevens en implementatievalidatie.

Als een controle mislukt, laadt u de host opnieuw, controleert u of de invoegtoepassing is geïnstalleerd en controleert u of az login het abonnement wordt gebruikt dat uw Foundry-resources bevat.

De vaardigheid in een project gebruiken

Open de map die de Foundry-agentcode bevat. Vraag om het gewenste resultaat en neem het doelproject, de omgeving, de agentmap of de implementatienaam op als u dit al weet.

Gebruik deze promptpatronen om de mogelijkheden van de vaardigheid aan te roepen:

Doel Voorbeeldprompt Typische werkproces
Foundry instellen voor een nieuwe agent Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Projectconfiguratie, modelimplementatie, creatie van agents, implementatie en aanroep.
Een privéomgeving instellen Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Planning van privénetwerken, sjabloonselectie, implementatiecontroles en validatie.
Een bestaande gehoste agent implementeren Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Oplossing van werkruimtecontext, containerbuild, ACR-push, gehoste agentimplementatie en betrouwbaarheidstest.
Opnieuw implementeren nadat code is gewijzigd Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Uitrolupdate, aanroep en opvolging van de evaluatie.
Een agent testen Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Het opzoeken van agents, het aanroepen ervan en het beoordelen van reacties.
Kwaliteit evalueren Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Setup van evaluatiesuites, controles van gegevenssets en evaluatoren, batchevaluatie en resultaatoverzicht.
Instructies optimaliseren Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Evaluatieanalyse, promptoptimalisatie, kandidaatbeoordeling en opvolgingsevaluatie.
Een evaluatiegegevensset bouwen Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Querytracering, datasetcuratie, versiebeheer en dataherkomsttracering.
Een fout oplossen Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Aanroepcontrole, logboeken, telemetrie, hoofdoorzaakanalyse, reparatieplan, opnieuw implementeren en opnieuw testen.
Toegang of capaciteit controleren Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Beoordeling van roltoewijzing, opzoeken van quota, capaciteitsplanning en herstelstappen.
Een model verfijnen Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Gereedheid van gegevensset, training, controlepuntbeoordeling, modelimplementatie en evaluatie.

Voordat u wijzigingen of opdrachten goedkeurt, controleert u het plan, de gegenereerde bestanden en Azure resources die de agent voorstelt om te maken of te wijzigen. Voor implementatie-, afstemmings- en inrichtingstaken bevestigt u roltoewijzingen en kostengebonden resources voordat de agent opdrachten uitvoert.

Foundry Toolkit-vaardigheden gebruiken in VS Code

Foundry Toolkit voor Visual Studio Code maakt Foundry-specifieke vaardigheden ook beschikbaar in VS Code. Deze vaardigheden, zoals vscode-microsoft-foundry en foundrytk-quick-start, richten zich op de ontwikkelervaring van VS Code: onboarding naar Foundry Toolkit, modellen verkennen, agents bouwen, een model selecteren, een agent implementeren, prestaties evalueren en werksets beheren. Ze verschillen van de kernvaardigheid microsoft-foundry, die een bredere kennisbasis en concrete details van de werkstromen biedt voor Foundry-resourcebeheer, RBAC, quota, modelimplementatie, implementatie van gehoste agents, evaluatie, tracering en probleemoplossing. Installeer Foundry Toolkit voor VS Code om deze uitbreidingsvaardigheden beschikbaar te maken in uw VS Code-agentervaring.

Hoe de vaardigheid werkt

Wanneer een coderingsagent gebruikmaakt van de Microsoft Foundry Skill, volgt deze een aantal veelvoorkomende patronen:

  1. Het begint met Foundry MCP-detectie, zodat het weet welke Foundry-hulpprogramma's en -parameters beschikbaar zijn in uw omgeving.
  2. Hiermee wordt de deelvaardigheid geladen die overeenkomt met uw workflow, zoals maken, implementeren, aanroepen, evalueren, traceren, probleemoplossing, RBAC, quota of implementatie van modellen.
  3. Het bepaalt de project- en agentcontext uit uw werkruimte voordat het wijzigingen of opdrachten voorstelt.
  4. Het geeft de voorkeur aan structured Foundry en Azure MCP-hulpprogramma's wanneer ze beschikbaar zijn.
  5. Er wordt alleen om ontbrekende waarden gevraagd wanneer die niet kunnen worden afgeleid uit uw prompt, bestanden in uw werkruimte of de geverifieerde Azure-context.

De vaardigheid ondersteunt twee algemene agenttypen:

Agenttype Gebruiksituatie
Agent vragen Een door LLM ondersteunde agent die gebruikmaakt van een modelimplementatie en promptconfiguratie.
Gehoste agent Een op containers gebaseerde agent die aangepaste code uitvoert in Foundry Agent Service.

Voor gehoste agentwerkstromen kan de vaardigheid ook werken met agents die gebruikmaken van de responses, invocationsof invocations_ws protocollen. Gebruik invocations_ws deze functie voor realtime of duplex WebSocket-scenario's, zoals spraakagenten of streaming-interacties.

Werkruimtebestanden die door de vaardigheid worden gebruikt

De vaardigheid zoekt naar Foundry-project- en agentcontext in algemene werkruimtebestanden. Houd deze bestanden actueel zodat uw coderingsagent specifieke, herhaalbare aanbevelingen kan doen.

Bestand of map Hoe de vaardigheid deze gebruikt
azure.yaml Hiermee vindt u azd services, agentprojectmappen, hostinstellingen voor implementatie en omgevingsbindingen.
.azure/<environment>/.env Resolveert geauthenticeerde azd omgevingswaarden, zoals abonnement, resourcegroep, projectendpoint, agentnaam, registry en Application Insights-verbindingsreeks.
.foundry/agent-metadata.yaml Slaat Foundry-specifieke overlaystatus op, zoals verwijzingen naar evaluatiesuites, verwijzingen naar datasets, lokale cachepaden, samenvattingen van resultaten en niet-azd-overschrijvingen.
.foundry/agent-metadata.<env>.yaml Slaat omgevingsspecifieke overlaystatus op voor een doel, zoals productie of CI.
agent.yaml Biedt lokale agentconfiguratie voor het maken, implementeren, aanroepen en evalueren van werkstromen.
eval.yaml Definieert de intentie voor lokale evaluatie, zoals het datasetbestand, de namen van beoordelaars, de slagingsdrempel, het aantal steekproeven, de terugzoekperiode voor traceringen en generatie-instructies.

Gebruik voor implementatie- en evaluatieworkflows bij voorkeur .foundry/agent-metadata.yaml voor niet-geheime overlaystatus. Sla geen geheimen op in .foundry bestanden. Als azd al een implementatiewaarde bevat, zoals een projecteindpunt of registry, laat de codeeragent dan de waarde van azd gebruiken in plaats van deze in de metadata te dupliceren.

Troubleshooting

Probleem Resolutie / Besluit
De host kan de skill niet vinden. Controleer of de invoegtoepassing is geïnstalleerd en laad de host opnieuw of start deze opnieuw, zodat inhoud van de invoegtoepassing opnieuw wordt geïndexeerd.
MCP-hulpmiddelen verschijnen niet. Controleer of Node.js is geïnstalleerd, npx werkt en of de Azure- en Foundry MCP-serververmeldingen zijn toegevoegd voor uw host.
Azure aanvragen mislukken met verificatiefouten. Voer az login opnieuw uit. Voor azd workflows moet u ook azd auth login uitvoeren.
De agent gebruikt het verkeerde abonnement. Stel het beoogde Azure-abonnement in Azure CLI in voordat u de prompt opnieuw probeert.
Foundry-projectbewerkingen zijn mislukt. Controleer of uw account toegang heeft tot het Foundry-project en de vereiste Azure RBAC-rollen.

Verwante inhoud

  • Last updated on