Utilize o Microsoft Foundry Skill em agentes de codificação

O Microsoft Foundry Skill fornece aos agentes de codificação orientações reutilizáveis para os fluxos de trabalho dos agentes Foundry. Utilize-o para ajudar a padronizar a implementação, avaliação, otimização de prompts, curadoria de conjuntos de dados a partir de traços e resolução de problemas em ambientes de desenvolvimento habilitados por agentes.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Se não tiveres, cria uma conta Azure gratuita.

  • Um host de agente de programação, como o GitHub Copilot no Visual Studio Code, Copilot CLI ou Claude Code.

  • Node.js 18 ou posterior no seu PATH. O plugin utiliza npx para iniciar servidores MCP em hosts compatíveis.

  • Git, para que o host possa descarregar conteúdo de plugin e de competências.

  • CLI do Azure instalado e autenticado:

    az login

  • Azure Developer CLI instalado e autenticado se planeia usar fluxos de trabalho de implementação azd:

    azd auth login

  • Um projeto Microsoft Foundry se quiser que o agente inspecione ou modifique os recursos com âmbito de projeto. Para os passos de configuração, veja Criar um projeto.

O que a competência Foundry oferece

A competência microsoft-foundry é uma metacompetência para o trabalho na Foundry. Ajuda um agente de codificação a escolher o fluxo de trabalho correto do Foundry, carregar a sub-competência correspondente, inspecionar as ferramentas MCP disponíveis do Foundry e manter o contexto de implementação e avaliação consistente entre turnos.

Use-o quando quiser que o agente ajude nestas áreas de capacidade:

Área de capacidade O que a habilidade ajuda o agente a fazer
Configuração inicial do Foundry Criar ou ligar a um projeto Foundry, fornecer um recurso Foundry, escolher uma configuração pública ou isolada em rede, e preparar o espaço de trabalho para o desenvolvimento do agente.
Acesso e capacidade Verifique atribuições de RBAC, identidades geridas, principais de serviço, quotas, disponibilidade de modelos, capacidade regional e pré-requisitos de implementação.
Implantação do modelo Implemente modelos com predefinições rápidas ou definições personalizadas, como versão, SKU, capacidade e configuração responsável por IA.
Personalização do modelo Aperfeiçoe os modelos com ajuste supervisionado, otimização direta de preferências ou fluxos de trabalho de ajuste por reforço.
Criação de agentes Crie aplicações agente alojadas que utilizem o Microsoft Agent Framework, LangGraph ou frameworks personalizados em Python ou C#.
Implantação de agentes Containerize um agente, crie e envie imagens para o Azure Container Registry, crie ou atualize implementações de agentes alojados e volte a implementar após alterações de código.
Invocação e testes Envie mensagens de uma única interação ou de várias interações para agentes implementados, agentes de teste de prompts e agentes alojados para teste que usam protocolos baseados em HTTP ou WebSocket.
Avaliação e otimização Executar avaliações em lote, configurar avaliações contínuas, comparar versões, otimizar prompts, melhorar as instruções do agente e preparar trabalhos no Agent Optimizer.
Trabalho com rastos e conjuntos de dados Consultar rastos, analisar latência ou falhas, correlacionar resultados de avaliação com respostas e organizar conjuntos de dados de avaliação a partir de rastos de produção.
Resolução de problemas Inspecionar registos de agentes alojados, consultar telemetria, diagnosticar falhas de implementação ou em tempo de execução e planear um ciclo de reparação e reimplantação.

A competência instalada inclui subcompetências especializadas para essas áreas. Normalmente não precisas de nomear diretamente a sub-habilidade. Pede o resultado que queres, e o agente de programação usa as instruções de skill para encaminhar a tarefa.

Installation

A extensão Foundry Toolkit para VS Code vem com a Foundry Skill. Para instalar a extensão, consulte Trabalhar com a extensão Microsoft Foundry para o Visual Studio Code.

Após a instalação, recarregue o Visual Studio Code se solicitado. Abre o Copilot Chat, muda para o modo agente e confirma que as habilidades de Foundry estão disponíveis. Quando solicitado, inicie sessão com a conta Azure que tem acesso ao seu projeto Foundry.

Para mais informações sobre a configuração do MCP em Visual Studio Code, consulte Comece com o Azure MCP Server e Comece com o Foundry MCP Server.

Se o teu host já tiver configuração de servidor MCP e só precisas do conteúdo da habilidade, instala a microsoft-foundry habilidade diretamente:

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

O percurso apenas de competências descarrega as orientações sobre o fluxo de trabalho do Foundry. Usa o plugin Azure Skills quando quiseres instalar o skill, a configuração do Azure MCP Server e a configuração do Foundry MCP Server em conjunto.

Verifica a configuração

Após a instalação, experimente estas verificações com o seu agente de codificação:

  • Pergunte What AI models are available in Microsoft Foundry? A resposta deve usar ferramentas do Foundry em vez de um resumo genérico.
  • Pergunte a List my Azure resource groups. A resposta deve usar as ferramentas MCP do Azure depois de se autenticar.
  • Num projeto de agente Foundry, pergunte Use the Microsoft Foundry Skill to review this agent for deployment readiness. A resposta deve identificar verificações de fluxo de trabalho como configuração, acesso ao projeto, implementação do modelo, dados de avaliação e validação da implementação.

Se uma verificação falhar, recarregue o host, confirme que o plugin foi instalado com sucesso e verifique se az login usa a subscrição que contém os seus recursos do Foundry.

Usa a competência num projeto

Abra a pasta que contém o código do seu agente Foundry. Pede o resultado que queres e inclui o projeto-alvo, o ambiente, a pasta do agente ou o nome da implementação, se já o conheceres.

Utilize estes padrões de prompt para tirar partido das capacidades da competência:

Goal Exemplo de prompt Fluxo de trabalho típico
Configurar a Foundry para um novo agente Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Configuração do Project, implementação do modelo, criação de agentes, implementação e invocação.
Crie um ambiente privado Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Planeamento de rede privada, seleção de templates, verificações de implementação e validação.
Implementar um agente hospedado existente Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Resolução do contexto do espaço de trabalho, construção de contentores, push ACR, implementação de agentes hospedados e teste de fumo.
Reimplantação após alterações ao código Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Atualização da implementação, invocação e seguimento da avaliação.
Teste um agente Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Pesquisa de agentes, invocação e revisão de respostas.
Avaliar a qualidade Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Configuração do conjunto de avaliações, verificações do conjunto de dados e dos avaliadores, avaliação em lote e resumo dos resultados.
Otimizar instruções Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Análise de avaliação, otimização rápida, revisão de candidatos e avaliação de seguimento.
Construir um conjunto de dados de avaliação Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Rastreio de consultas, curadoria de conjuntos de dados, controlo de versões e rastreio da linhagem dos dados.
Resolver uma falha Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Verificação de invocação, registos, telemetria, análise da causa raiz, plano de reparação, reimplantação e novo teste.
Verificar acesso ou capacidade Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Revisão de atribuição de funções, consulta de quotas, planeamento de capacidades e passos de remediação.
Ajuste um modelo Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Preparação do conjunto de dados, configuração do treino, revisão de pontos de verificação, implementação em produção do modelo e avaliação.

Antes de aprovar alterações ou comandos, reveja o plano, os ficheiros gerados e os recursos do Azure que o agente propõe criar ou modificar. Para tarefas de implementação, ajuste fino e provisionamento, confirme atribuições de funções e recursos que suportam custos antes de o agente executar comandos.

Utilize as funcionalidades do Foundry Toolkit no VS Code

Foundry Toolkit para Visual Studio Code também disponibiliza competências específicas da Foundry no VS Code. Estas competências, como vscode-microsoft-foundry e foundrytk-quick-start, focam-se na experiência de desenvolvimento de VS Code: integração no Foundry Toolkit, exploração de modelos, construção de agentes, seleção de um modelo, implementação de um agente, avaliação de desempenho e gestão de caixas de ferramentas. São diferentes da competência principal microsoft-foundry , que fornece uma base de conhecimento mais ampla e detalhes concretos do fluxo de trabalho para gestão de recursos Foundry, RBAC, quotas, implementação de modelos, implementação de agentes hospedados, avaliação, rastreamento e resolução de problemas. Instale o Foundry Toolkit for VS Code para disponibilizar estas competências fornecidas pela extensão na sua experiência como agente VS Code.

Como funciona a habilidade

Quando um agente de programação utiliza a Microsoft Foundry Skill, segue alguns padrões comuns:

  1. Começa com a descoberta do MCP do Foundry, para que saiba quais as ferramentas e parâmetros do Foundry disponíveis no seu ambiente.
  2. Carrega a sub-competência que corresponde ao seu fluxo de trabalho, como criação, implementação, invocação, avaliação, rastreio, resolução de problemas, RBAC, quota ou implementação do modelo.
  3. Resolve o contexto do projeto e do agente do teu espaço de trabalho antes de propor alterações ou comandos.
  4. Prefere as ferramentas estruturadas do Foundry e do Azure MCP quando estão disponíveis.
  5. Pede valores em falta apenas quando não podem ser resolvidos a partir do teu prompt, ficheiros de workspace ou contexto autenticado do Azure.

A habilidade suporta dois tipos comuns de agentes:

Tipo de agente Caso de uso
Agente de prompt Um agente apoiado por LLM que utiliza uma implementação de modelo e configuração de prompts.
Agente hospedado Um agente baseado em contentores que executa código personalizado no Foundry Agent Service.

Para fluxos de trabalho de agentes alojados, a capacidade também pode funcionar com agentes que utilizam os protocolos responses, invocations ou invocations_ws. Use invocations_ws para cenários WebSocket em tempo real ou duplex, como agentes de voz ou interações de streaming.

Ficheiros do espaço de trabalho que a funcionalidade utiliza

A funcionalidade procura o contexto do projeto e do agente no Foundry em ficheiros comuns do espaço de trabalho. Mantenha estes ficheiros atualizados para que o seu agente de codificação possa fazer recomendações específicas e repetíveis.

Ficheiro ou pasta Como a competência utiliza isso
azure.yaml Localiza azd serviços, pastas de projeto do agente, definições do host de implementação e associações de ambiente.
.azure/<environment>/.env Resolve os valores autenticados do ambiente azd, como subscrição, grupo de recursos, ponto final do projeto, nome do agente, registo e cadeia de ligação do Application Insights.
.foundry/agent-metadata.yaml Armazena o estado da sobreposição específico do Foundry, como referências a suítes de avaliação, referências a conjuntos de dados, caminhos de cache locais, resumos de resultados e substituições não azd.
.foundry/agent-metadata.<env>.yaml Armazena o estado de sobreposição específico do ambiente para um alvo, como produção ou CI.
agent.yaml Fornece configuração local de agentes para fluxos de trabalho de criação, implementação, invocação e avaliação.
eval.yaml Define a intenção local de avaliação, como ficheiro de conjunto de dados, nomes dos avaliadores, limiar de passagem, contagem de amostras, análise de traços e instruções de geração.

Para fluxos de trabalho de implementação e avaliação, prefere-se .foundry/agent-metadata.yaml para estado de sobreposição não secreto. Não guardes segredos em .foundry ficheiros. Se azd já fornecer um valor de implementação, como um endpoint de projeto ou registo, deixe o agente de codificação usar o azd valor em vez de o duplicar nos metadados.

Resolução de problemas

Problema Resolução
O anfitrião não encontra a habilidade. Confirma que o plugin foi instalado com sucesso, depois recarrega ou reinicia o host para que ele reindexe o conteúdo dos plugins.
As ferramentas MCP não aparecem. Confirma Node.js está instalado, npx funciona e as entradas do servidor MCP Azure e Foundry foram adicionadas para o teu host.
Os pedidos do Azure falham com erros de autenticação. Execute novamente az login. No caso de fluxos de trabalho com azd, execute também azd auth login.
O agente usa a subscrição errada. Defina a subscrição Azure pretendida no CLI do Azure antes de tentar novamente o prompt.
As operações do projeto da fundição falham. Confirme que a sua conta tem acesso ao projeto Foundry e as funções necessárias no Azure RBAC.

Conteúdo relacionado

  • Last updated on