Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 skillou Node.js 22.20 ou posterior se você usar a CLI cross-agentskills. - 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 habilidade do .NET builder ainda não está em uma versão com marcação, portanto, você precisa especificar a ref @main. Visualize a habilidade 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 habilidades entre agentes
Como alternativa, instale a habilidade com a CLI skills entre agentes:
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
Avise naturalmente o agente de codificação. Os clientes compatíveis descobrem e ativam a habilidade com base nos metadados; 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 estruturas de destino, versão do SDK, gerenciamento de pacotes e pacotes
Microsoft.Agents.AI.*instalados. - Escolha o menor padrão indicado, como um agente simples, um agente, 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 ref
@mainaté que uma versão marcada inclua a habilidade. - 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 concentradas, consulte:
- Origem da habilidade Construtor
- Catálogo de habilidades do Agent Framework
- Pull request da habilidade do criador
Próximas Etapas
Vá mais fundo:
A habilidade do criador do Microsoft Agent Framework para Python, agent-framework-builder-python, apresenta 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 agentes com planejamento, listas de tarefas, 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 pelo Microsoft Foundry.
A habilidade é exclusiva do 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 skillou Node.js 22.20 ou posterior se você usar a CLI cross-agentskills. - Python 3.11 ou posterior. O Agent Framework 1.24 não oferece mais suporte ao Python 3.10 nem o testa, embora os metadados do pacote ainda permitam a instalação.
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 marcada mais recente:
gh skill install microsoft/agent-framework agent-framework-builder-python
Fixe a versão 1.23 do Python quando você precisar de diretrizes 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 habilidades entre agentes
Como alternativa, instale a habilidade com a CLI skills entre agentes:
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
Avise naturalmente o agente de codificação. Os clientes compatíveis descobrem e ativam a habilidade com base nos metadados; 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 indicado, como um agente simples, um agente, 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 marcação do repositório python-1.23.0. Sua versão de metadados de habilidade é 0.3.
- Use o comando de instalação não qualificada para a versão marcada mais recente.
- Fixe
@python-1.23.0quando a reprodutibilidade for importante. - Use
@mainsomente 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 concentradas, consulte:
- Habilidade do construtor liberada
- Catálogo de habilidades do Agent Framework
- Pull request da habilidade do criador
Próximas Etapas
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 de Go do Agent Framework para obter as diretrizes atuais.