Usa Microsoft Foundry Skill negli agenti di programmazione

La Microsoft Foundry Skill fornisce indicazioni riutilizzabili per gli agenti di codifica per i flussi di lavoro dell'agente Foundry. Usalo per contribuire a standardizzare il deployment, la valutazione, l'ottimizzazione dei prompt, la preparazione dei dataset a partire dalle tracce e le attività di risoluzione dei problemi negli ambienti di sviluppo con supporto per gli agenti.

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Se non è disponibile, creare un account Azure gratuito.

  • Un host per agenti di codifica, ad esempio GitHub Copilot in Visual Studio Code, la CLI di Copilot o Claude Code.

  • Node.js 18 o versione successiva su PATH. Il plug-in usa npx per avviare i server MCP in host compatibili.

  • Git, in modo che l'host possa scaricare i contenuti dei plug-in e delle skill.

  • interfaccia della riga di comando di Azure installato ed autenticato:

    az login

  • Azure Developer CLI installato ed autenticato se si prevede di usare flussi di lavoro di distribuzione azd:

    azd auth login

  • Un progetto Microsoft Foundry se si vuole che l'agente controlli o modifichi le risorse con ambito progetto. Per la procedura di installazione, vedere Creare un progetto.

Che cosa offre la funzionalità Foundry

La competenza microsoft-foundry è una metacompetenza per il lavoro in Foundry. Consente a un agente di codifica di scegliere il flusso di lavoro Foundry corretto, caricare la sotto-competenza corrispondente, esaminare gli strumenti MCP foundry disponibili e mantenere coerente il contesto di distribuzione e valutazione tra turni.

Usarlo quando si vuole che l'agente aiuti con queste aree di funzionalità:

Area di funzionalità Quale competenza aiuta l'agente
Configurazione iniziale di Foundry Creare o connettersi a un progetto Foundry, effettuare il provisioning di una risorsa Foundry, scegliere la configurazione pubblica o isolata dalla rete e preparare l'area di lavoro per lo sviluppo dell'agente.
Accesso e capacità Verificare assegnazioni RBAC, identità gestite, entità di servizio, quota, disponibilità del modello, capacità dell'area geografica e prerequisiti per la distribuzione.
Implementazione del modello Distribuire modelli con impostazioni rapide o impostazioni personalizzate, ad esempio versione, SKU, capacità e configurazione di intelligenza artificiale responsabile.
Personalizzazione del modello Perfezionare i modelli con flussi di lavoro di fine-tuning supervisionato, ottimizzazione diretta delle preferenze o fine-tuning con rinforzo.
Creazione di agenti Creare applicazioni agente ospitate che usano Microsoft Framework agent, LangGraph o framework personalizzati in Python o C#.
Distribuzione dell'agente Creare un contenitore per un agente, creare e inviare immagini ad Registro Azure Container, creare o aggiornare le distribuzioni di agenti ospitati e ridistribuire dopo le modifiche al codice.
Invocazione e test Inviare messaggi a turno singolo o a più turni agli agenti distribuiti, testare gli agenti prompt e testare gli agenti ospitati che usano protocolli basati su HTTP o WebSocket.
Valutazione e ottimizzazione Eseguire valutazioni batch, configurare la valutazione continua, confrontare le versioni, ottimizzare le richieste, migliorare le istruzioni degli agenti e preparare i processi di Agent Optimizer.
Lavoro di traccia e set di dati Interrogare le tracce, analizzare la latenza o i malfunzionamenti, correlare i risultati della valutazione con le risposte e organizzare i set di dati di valutazione a partire dalle tracce di produzione.
Troubleshooting Esaminare i log dell'agente ospitato, eseguire query sui dati di telemetria, diagnosticare gli errori di distribuzione o di runtime e pianificare un ciclo di ripristino e ridistribuimento.

La competenza installata include competenze secondarie specializzate per tali aree. In genere non è necessario denominare direttamente la competenza secondaria. Chiedere il risultato che si desidera e l'agente di coding usa le istruzioni della competenza per instradare l'attività.

Installazione

L'estensione Foundry Toolkit per VS Code include la competenza Foundry. Per installare l'estensione, consulta Usare l'estensione Microsoft Foundry per Visual Studio Code.

Dopo l'installazione, se richiesto, ricaricare Visual Studio Code. Aprire Copilot Chat, passare alla modalità agente e verificare che le competenze di Foundry siano disponibili. Quando richiesto, accedere con l'account Azure che ha accesso al progetto Foundry.

Per altre informazioni sulla configurazione mcp in Visual Studio Code, vedere Introduzione all'Azure MCP Server e Introduzione a Foundry MCP Server.

Se il tuo host ha già una configurazione del server MCP e ti serve solo il contenuto della competenza, installa direttamente la competenza microsoft-foundry:

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

Il percorso di sola competenza scarica le linee guida per il flusso di lavoro Foundry. Usa il plug-in Azure Skills quando vuoi che la skill, la configurazione del server MCP di Azure e la configurazione del server MCP di Foundry siano installati insieme.

Verificare l'installazione

Dopo l'installazione, provare a eseguire questi controlli dall'agente di codifica:

  • Ask What AI models are available in Microsoft Foundry? La risposta deve usare gli strumenti Foundry anziché un riepilogo generico.
  • Chiedi List my Azure resource groups. La risposta deve usare gli strumenti MCP Azure dopo l'autenticazione.
  • In un progetto dell'agente Foundry, chiedere Use the Microsoft Foundry Skill to review this agent for deployment readiness. La risposta deve identificare i controlli del flusso di lavoro, ad esempio configurazione, accesso al progetto, distribuzione del modello, dati di valutazione e convalida della distribuzione.

Se un controllo ha esito negativo, ricaricare l'host, verificare che il plug-in sia stato installato correttamente e verificare che az login usi la sottoscrizione che contiene le risorse Foundry.

Usare la competenza in un progetto

Aprire la cartella contenente il codice dell'agente Foundry. Chiedere il risultato desiderato e includere il progetto di destinazione, l'ambiente, la cartella dell'agente o il nome della distribuzione, se lo si conosce già.

Usare questi modelli di prompt per richiamare le funzionalità della competenza:

Obiettivo Richiesta di esempio Flusso di lavoro tipico
Configurare Foundry per un nuovo agente Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Configurazione del progetto, distribuzione del modello, creazione dell'agente, distribuzione e invocazione.
Configurare un ambiente privato Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Pianificazione della rete privata, selezione dei modelli, controlli di distribuzione e convalida.
Distribuire un agente ospitato esistente Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Risoluzione del contesto dell'area di lavoro, creazione del contenitore, push in ACR, distribuzione tramite agente ospitato e smoke test.
Ridistribuire dopo la modifica del codice Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Seguito dell'aggiornamento della distribuzione, dell'invocazione e della valutazione.
Testare un agente Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Ricerca, chiamata e revisione della risposta dell'agente.
Valutare la qualità Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Configurazione della suite di valutazione, controlli del dataset e del valutatore, valutazione batch e riepilogo dei risultati.
Ottimizzare le istruzioni Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Analisi delle valutazioni, ottimizzazione dei prompt, revisione dei candidati e valutazione di follow-up.
Creare un set di dati di valutazione Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Tracciamento delle query, gestione del set di dati, controllo delle versioni e tracciamento della provenienza.
Risolvere un errore Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Controllo delle chiamate, log, telemetria, analisi della causa radice, piano di ripristino, ridistribuzione e retest.
Controllare l'accesso o la capacità Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Revisione delle assegnazioni di ruolo, ricerca della quota, pianificazione della capacità e passaggi di correzione.
Ottimizzare un modello Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Conformità del set di dati, configurazione del training, revisione del checkpoint, distribuzione del modello e valutazione.

Prima di approvare le modifiche o i comandi, esaminare il piano, i file generati e Azure risorse che l'agente propone di creare o modificare. Per le attività di distribuzione, ottimizzazione e provisioning, verificare le assegnazioni di ruolo e le risorse con costi prima che l'agente esegua i comandi.

Usare le competenze di Foundry Toolkit in VS Code

Foundry Toolkit per Visual Studio Code rende disponibili anche competenze specifiche di Foundry in VS Code. Queste competenze, ad esempio vscode-microsoft-foundry e foundrytk-quick-start, si concentrano sull'esperienza di sviluppo di VS Code: onboarding in Foundry Toolkit, esplorazione di modelli, compilazione di agenti, selezione di un modello, distribuzione di un agente, valutazione delle prestazioni e gestione degli strumenti. Sono diversi dalla competenza di base microsoft-foundry, che fornisce una base di conoscenze più ampia e dettagli concreti sui flussi di lavoro relativi alla gestione delle risorse di Foundry, al controllo degli accessi basato sui ruoli (RBAC), alle quote, alla distribuzione dei modelli, alla distribuzione degli agenti ospitati, alla valutazione, al tracciamento e alla risoluzione dei problemi. Installare Foundry Toolkit per VS Code per rendere disponibili queste competenze fornite dall'estensione nell'esperienza dell'agente di VS Code.

Funzionamento della competenza

Quando un agente di codifica usa la Microsoft Competenza Foundry, segue alcuni modelli comuni:

  1. Inizia con il rilevamento MCP di Foundry, in modo che sappia quali strumenti e parametri di Foundry sono disponibili nel tuo ambiente.
  2. Carica la sottofunzione corrispondente al flusso di lavoro, ad esempio creazione, distribuzione, invocazione, valutazione, tracciamento, risoluzione dei problemi, controllo degli accessi in base al ruolo, quote o distribuzione di modelli.
  3. Risolve il contesto del progetto e dell'agente dall'area di lavoro prima di proporre modifiche o comandi.
  4. Predilige gli strumenti MCP strutturati di Foundry e Azure quando sono disponibili.
  5. Richiede valori mancanti solo quando non possono essere risolti dal prompt, dai file dell'area di lavoro o dal contesto di Azure autenticato.

La funzionalità supporta due tipi comuni di agenti:

Tipo di agente caso d'uso
Agente di prompt Un agente basato su un LLM che utilizza la distribuzione di un modello e la configurazione del prompt.
Agente virtuale Un agente basato su container che esegue codice personalizzato in Foundry Agent Service.

Per i flussi di lavoro di agenti ospitati, la skill può funzionare anche con agenti che usano i protocolli responses, invocations o invocations_ws. Usa invocations_ws per scenari WebSocket in tempo reale o bidirezionali, ad esempio agenti vocali o interazioni in streaming.

File dell'area di lavoro usati dalla competenza

La funzionalità ricerca il contesto del progetto Foundry e dell'agente nei file comuni dell'area di lavoro. Mantenere aggiornati questi file in modo che l'agente di codifica possa creare raccomandazioni specifiche e ripetibili.

File o cartella Come la skill lo utilizza
azure.yaml Trova azd servizi, cartelle del progetto agente, impostazioni host di distribuzione e associazioni di ambiente.
.azure/<environment>/.env Risolve i valori di ambiente azd autenticati, ad esempio sottoscrizione, gruppo di risorse, endpoint del progetto, nome agente, registro e stringa di connessione di Application Insights.
.foundry/agent-metadata.yaml Archivia lo stato dell'overlay specifico di Foundry, come i riferimenti alle suite di valutazione, i riferimenti ai dataset, i percorsi della cache locale, i riepiloghi dei risultati e gli override diversi da azd.
.foundry/agent-metadata.<env>.yaml Memorizza lo stato di overlay specifico dell'ambiente per un obiettivo, ad esempio produzione o CI.
agent.yaml Fornisce la configurazione dell'agente locale per i flussi di lavoro di creazione, distribuzione, richiamo e valutazione.
eval.yaml Definisce i parametri della valutazione locale, ad esempio il file del dataset, i nomi dei valutatori, la soglia di superamento, il numero di campioni, l'intervallo di analisi delle tracce e le istruzioni di generazione.

Per i flussi di lavoro di distribuzione e valutazione, preferisci .foundry/agent-metadata.yaml per lo stato di overlay non segreto. Non archiviare segreti nei .foundry file. Se azd fornisce già un valore di distribuzione, ad esempio un endpoint di progetto o un registro, consentire all'agente di codifica di usare il azd valore anziché duplicarlo nei metadati.

Troubleshooting

Issue Resolution
L'host non trova la competenza. Verificare che il plug-in sia stato installato correttamente, quindi ricaricare o riavviare l'host in modo da reindicizzare il contenuto del plug-in.
Gli strumenti MCP non vengono visualizzati. Verifica che Node.js sia installato, che npx funzioni e che siano state aggiunte le voci del server MCP di Azure e Foundry per il tuo host.
Le richieste di Azure non vanno a buon fine a causa di errori di autenticazione. Eseguire az login di nuovo. Per i flussi di lavoro azd, eseguire anche azd auth login.
L'agente usa la sottoscrizione errata. Impostare la sottoscrizione Azure prevista in interfaccia della riga di comando di Azure prima di ripetere la richiesta.
Le operazioni del progetto Foundry non riescono. Verifica che il tuo account abbia accesso al progetto Foundry e ai ruoli RBAC di Azure richiesti.

Contenuti correlati

  • Last updated on