Crie aplicativos do Agent Framework com um agente de codificação

A skill de criação do Microsoft Agent Framework para .NET, agent-framework-builder-dotnet, fornece diretrizes mantidas pela Microsoft aos agentes de codificação compatíveis para a criação de soluções do Agent Framework para .NET (C#). Ele ajuda o agente de codificação a escolher um padrão apropriado e carregar progressivamente as diretrizes focadas para a tarefa.

A habilidade pode orientar o trabalho com:

  • Agentes simples, provedores de modelos, ferramentas, sessões, histórico, provedores de contexto e middleware.
  • Aproveite agentes com tarefas, modos, memória, aprovações, habilidades, agentes em segundo plano, ferramentas de shell, compactação e loops.
  • Fluxos de trabalho e orquestrações integradas e definições declarativas.
  • Avaliação, observabilidade, clientes personalizados, agentes personalizados e integrações.
  • Hospedagem e implantação.

A habilidade fornece diretrizes de desenvolvimento para um agente de codificação externo. Ele não é um pacote NuGet e não funciona dentro do seu aplicativo do Agent Framework.

Importante

Essa habilidade de agente de codificação é diferente de runtime Agent Skills. As habilidades de runtime são carregadas por um agente do Agent Framework enquanto o aplicativo é executado. A skill Builder ajuda um agente de codificação a criar ou modificar o código-fonte do aplicativo.

Dica

Emparelhe a habilidade do construtor com o servidor MCP do Microsoft Learn. A habilidade fornece ao agente de codificação o fluxo de trabalho e as diretrizes de implementação do Agent Framework, enquanto o Learn MCP Server permite que ele pesquise a documentação Microsoft atual, busque artigos completos e localize exemplos de código durante a tarefa. Configure este ponto de extremidade HTTP streamable público e não autenticado em um agente de codificação compatível:

https://learn.microsoft.com/api/mcp

Pré-requisitos

  • Um agente de codificação que dá suporte à especificação open Agent Skills.
  • GitHub CLI com os comandos de visualização gh skill ou Node.js 22.20 ou posterior se você usar a CLI cross-agent skills.
  • Um SDK de .NET com suporte no momento para novos aplicativos do Agent Framework.

O gerenciamento de habilidades da CLI do GitHub está em versão prévia e sujeito a alterações.

Examinar e instalar com GitHub CLI

A skill do .NET builder ainda não está em um release com tag, portanto, você precisa especificar a ref @main. Visualize a skill antes de instalá-la:

gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main

Instale a skill:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

A instalação padrão tem escopo de projeto e destina-se ao GitHub Copilot em uso não interativo. Selecione outro agente de código compatível ou escopo de usuário quando necessário:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent codex

Para ver as opções atuais de cliente e escopo, consulte gh skill install.

Instalar com a CLI de skills cross-agent

Como alternativa, instale a habilidade com a CLI cross-agent skills:

npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet

Examine os agentes de codificação com suporte da CLI e os requisitos de runtime antes da instalação.

Usar a habilidade

Instrua o agente de codificação naturalmente. Clientes compatíveis descobrem e ativam a habilidade a partir dos metadados dela; não suponha um comando de barra universal.

Prompts de exemplo:

  • Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with todos, file access, and safe shell tooling.
  • Review this .NET Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.

Inclua restrições como o provedor de modelo, o destino de hospedagem, os requisitos de persistência, o limite de segurança e a versão de .NET de destino quando você os conhece.

O que o agente de codificação deve fazer

A habilidade instrui um agente de codificação a:

  • Inspecione a solução existente, incluindo frameworks de destino, versão do SDK, gerenciamento de pacotes e pacotes instalados Microsoft.Agents.AI.*.
  • Escolha o menor padrão adequado, como um agente simples, um arcabouço, um fluxo de trabalho, uma orquestração ou uma definição declarativa.
  • Carregue apenas as referências focadas relevantes.
  • Adicione apenas o conjunto estreito de pacotes de que o aplicativo precisa e verifique a maturidade de cada pacote antes de depender dele, pois alguns pacotes são pré-lançamento.
  • Leia pontos de extremidade, modelos e chaves da configuração e prefira credenciais de token em vez de chaves de API codificadas.
  • Valide o aplicativo gerado com os testes existentes do repositório e amostras executáveis.

A habilidade não garante que o código gerado esteja pronto para produção. Examine o plano do agente de codificação, as opções de pacote, os limites de segurança, os comandos e as alterações geradas antes da aprovação.

Versionamento e confiança

A habilidade é uma habilidade de consumidor pública, instalável e mantida pela Microsoft. Sua versão de metadados de habilidade é 0.1.

  • Use a @main referência até que uma release tagueada inclua a skill.
  • Visualizar o conteúdo da skill antes da instalação e examinar as atualizações antes de confiar em novos scripts ou instruções.

Para as referências de origem e específicas, consulte:

Próximas Etapas 

Criar seu primeiro agente

Vá mais fundo:

A builder skill do Microsoft Agent Framework para Python, agent-framework-builder-python, fornece aos agentes de codificação compatíveis diretrizes mantidas pela Microsoft para a criação de soluções do Python Agent Framework. Ele ajuda o agente de codificação a escolher um padrão apropriado e carregar progressivamente as diretrizes focadas para a tarefa.

A habilidade pode orientar o trabalho com:

  • Agentes simples, provedores de modelo, ferramentas, aprovações, sessões, histórico e provedores de contexto.
  • Aproveite os agentes com planejamento, TODOs, memória, compactação, arquivos, agentes em segundo plano, ferramentas de shell e loops.
  • Fluxos de trabalho funcionais e de grafo, orquestrações integradas e definições declarativas.
  • Avaliação, observabilidade, middleware, clientes personalizados, agentes personalizados e integrações.
  • Auto-hospedagem e desenvolvimento de agente hospedado no Microsoft Foundry.

A habilidade é exclusiva de Python. Ele fornece diretrizes de desenvolvimento para um agente de codificação externo; não é um pacote de Python, não é instalado por pip install agent-frameworke não é executado dentro de seu aplicativo do Agent Framework.

Importante

Essa habilidade de agente de codificação é diferente de runtime Agent Skills. As habilidades de runtime são carregadas por um agente do Agent Framework enquanto o aplicativo é executado. A skill Builder ajuda um agente de codificação a criar ou modificar o código-fonte do aplicativo.

Dica

Emparelhe a habilidade do construtor com o servidor MCP do Microsoft Learn. A habilidade fornece ao agente de codificação o fluxo de trabalho e as diretrizes de implementação do Agent Framework, enquanto o Learn MCP Server permite que ele pesquise a documentação Microsoft atual, busque artigos completos e localize exemplos de código durante a tarefa. Configure este ponto de extremidade HTTP streamable público e não autenticado em um agente de codificação compatível:

https://learn.microsoft.com/api/mcp

Pré-requisitos

  • Um agente de codificação que dá suporte à especificação open Agent Skills.
  • GitHub CLI com os comandos de visualização gh skill ou Node.js 22.20 ou posterior se você usar a CLI cross-agent skills.
  • Python 3.11 ou posterior para novos aplicativos do Agent Framework. O Agent Framework 1.23 ainda dá suporte a Python 3.10, mas Python 3.10 atingiu o fim da vida útil upstream.

O gerenciamento de habilidades da CLI do GitHub está em versão prévia e sujeito a alterações.

Examinar e instalar com GitHub CLI

Visualizar a habilidade lançada antes de instalá-la:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Instale a versão mais recente com tag:

gh skill install microsoft/agent-framework agent-framework-builder-python

Fixe a versão 1.23 do Python quando precisar de orientações reproduzíveis:

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

A instalação padrão tem escopo de projeto e destina-se ao GitHub Copilot em uso não interativo. Selecione outro agente de código compatível ou escopo de usuário quando necessário:

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

Para ver as opções atuais de cliente e escopo, consulte gh skill install.

Instalar com a CLI de skills cross-agent

Como alternativa, instale a habilidade com a CLI cross-agent skills:

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

Examine os agentes de codificação com suporte da CLI e os requisitos de runtime antes da instalação.

Usar a habilidade

Instrua o agente de codificação naturalmente. Clientes compatíveis descobrem e ativam a habilidade a partir dos metadados dela; não suponha um comando de barra universal.

Prompts de exemplo:

  • Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with planning, todos, file access, and safe shell tooling.
  • Review this Python Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

Inclua restrições como o provedor de modelos, destino de hospedagem, requisitos de persistência, perímetro de segurança e versão do Python compatível quando você os conhecer.

O que o agente de codificação deve fazer

A habilidade instrui um agente de codificação a:

  • Escolha o menor padrão adequado, como um agente simples, um arcabouço, um fluxo de trabalho, uma orquestração ou uma definição declarativa.
  • Carregue apenas as referências focadas relevantes.
  • Prefira as diretrizes atuais do Microsoft Learn, referências de API pública, informações de ciclo de vida do pacote e amostras mantidas para detalhes voláteis.
  • Instale conjuntos reduzidos de pacotes em vez de presumir que cada integração seja estável ou necessária.
  • Preservar limites explícitos de sessão, aprovação, autenticação e hospedagem.
  • Valide o aplicativo gerado com os testes, verificações de tipo e exemplos executáveis existentes do repositório.

A habilidade não garante que o código gerado esteja pronto para produção. Examine o plano do agente de codificação, as opções de pacote, os limites de segurança, os comandos e as alterações geradas antes da aprovação.

Versionamento e confiança

A habilidade é uma habilidade de consumidor pública, instalável e mantida pela Microsoft, lançada na tag do repositório python-1.23.0. Sua versão de metadados de habilidade é 0.3.

  • Use o comando install sem qualificador para a release mais recente com tag.
  • Fixar @python-1.23.0 quando a reprodutibilidade for importante.
  • Use @main somente quando desejar intencionalmente orientações ainda não publicadas.
  • Visualizar o conteúdo da skill antes da instalação e examinar as atualizações antes de confiar em novos scripts ou instruções.

Para as referências de origem e específicas, consulte:

Próximas Etapas 

Criar seu primeiro agente

Vá mais fundo:

Note

Uma skill de builder do Microsoft Agent Framework para Go ainda não está disponível. Use o tutorial de introdução do Go e os exemplos do Agent Framework Go para obter diretrizes atuais.

  • Última atualização em