Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A skill Microsoft Agent Framework builder para .NET, agent-framework-builder-dotnet, fornece aos agentes de codificação compatíveis orientações mantidas pela Microsoft para criar soluções do Agent Framework em .NET (C#).
Ajuda o agente de código a escolher um padrão apropriado e a carregar progressivamente orientações direcionadas para a tarefa.
A competência pode orientar o trabalho com:
- Agentes simples, fornecedores de modelos, ferramentas, sessões, histórico, fornecedores de contexto e middleware.
- Use agentes com tarefas, modos, memória, aprovações, competências, agentes de fundo, ferramentas de shell, compactação e loops.
- Fluxos de trabalho e orquestrações incorporadas, e definições declarativas.
- Avaliação, observabilidade, clientes personalizados, agentes personalizados e integrações.
- Alojamento e implantação.
A skill fornece orientação de desenvolvimento a um agente de codificação externo. Não é um pacote NuGet e não corre dentro da tua aplicação Agent Framework.
Importante
Esta capacidade do agente de programação é diferente das capacidades do agente em tempo de execução. As skills de runtime são carregadas por um agente do Agent Framework enquanto a sua aplicação está a correr. A Builder Skill ajuda um agente de programação a criar ou modificar o código-fonte da sua aplicação.
Tip
Associe a competência de criação ao Microsoft Learn MCP Server. A skill oferece ao agente de programação orientação focada para o fluxo de trabalho do Agent Framework e orientações de implementação, enquanto o Learn MCP Server permite-lhe pesquisar a documentação atual da Microsoft, obter artigos completos e encontrar exemplos de código durante a tarefa. Configure este endpoint HTTP Streamable público, não autenticado, num agente de codificação compatível:
https://learn.microsoft.com/api/mcp
Pré-requisitos
- Um agente de programação que suporta a especificação aberta Agent Skills.
-
GitHub CLI com os comandos em pré-visualização
gh skill, ou Node.js 22.20 ou posterior se usares a CLI cross-agentskills. - Um SDK .NET atualmente suportado para novas aplicações Agent Framework.
A gestão de skills da CLI do GitHub está em pré-visualização e sujeita a alterações.
Reveja e instale com a CLI do GitHub
A skill do builder .NET ainda não está numa release etiquetada, por isso precisas de especificar a referência @main. Faz uma pré-visualização da skill antes de a instalar:
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 âmbito de projeto e destina-se ao GitHub Copilot em uso não interativo. Selecione outro agente de codificação suportado ou âmbito de utilizador 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 opções atuais de cliente e âmbito, veja gh skill install.
Instalar com a CLI de competências entre agentes
Como alternativa, instale a skill com a CLI cross-agent skills:
npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet
Revise os agentes de codificação suportados pela CLI e os requisitos de tempo de execução antes da instalação.
Use a habilidade
Instrua o agente de codificação naturalmente. Clientes compatíveis descobrem e ativam a competência a partir dos seus metadados; não presuma que exista um comando universal de barra.
Exemplos de prompts:
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 fornecedor do modelo, destino de alojamento, requisitos de persistência, fronteira de segurança e versão .NET do alvo quando os conhecer.
O que o agente de codificação deve fazer
A skill instrui um agente de programação para:
- Inspecionar a solução existente, incluindo frameworks de destino, versão do SDK, gestão de pacotes e pacotes instalados
Microsoft.Agents.AI.*. - Escolha o menor padrão adequado, como um agente simples, harness, workflow, orquestração ou definição declarativa.
- Carregue apenas as referências relevantes em foco.
- Adicione apenas o conjunto restrito de pacotes que a aplicação precisa e verifique a maturidade de cada pacote antes de depender deles, porque alguns pacotes são pré-lançamento.
- Leia endpoints, modelos e chaves a partir da configuração, e prefira credenciais de token em vez de chaves API codificadas fixamente.
- Valide a aplicação gerada com os testes existentes do repositório e as amostras executáveis.
A competência não garante que o código gerado esteja pronto para produção. Revise o plano do agente de codificação, escolhas de pacotes, limites de segurança, comandos e alterações geradas antes da aprovação.
Controlo de versões e confiança
A skill é pública, instalável e mantida pela Microsoft de consumidor. A versão dos metadados da skill é 0.1.
- Usa o
@mainref até que uma release etiquetada inclua a skill. - Pré-visualize o conteúdo das skills antes da instalação e revise atualizações antes de confiar em novos scripts ou instruções.
Para a fonte e referências focadas, veja:
- Origem da competência do construtor
- Catálogo de competências do Agent Framework
- Pull request da competência Builder
Passos seguintes
Vai mais fundo:
A skill de builder do Microsoft Agent Framework para Python, agent-framework-builder-python, fornece aos agentes de programação compatíveis orientações mantidas pela Microsoft para criar soluções em Python Agent Framework.
Ajuda o agente de código a escolher um padrão apropriado e a carregar progressivamente orientações direcionadas para a tarefa.
A competência pode orientar o trabalho com:
- Agentes plain, fornecedores de modelos, ferramentas, aprovações, sessões, histórico e fornecedores de contexto.
- Aproveite agentes com planeamento, tarefas, memória, compactação, ficheiros, agentes de fundo, ferramentas de shell e loops.
- Fluxos de trabalho funcionais e de grafos, orquestrações incorporadas e definições declarativas.
- Avaliação, observabilidade, middleware, clientes personalizados, agentes personalizados e integrações.
- Alojamento próprio e desenvolvimento de agentes alojados no Microsoft Foundry.
A competência é exclusiva de Python. Fornece orientação de desenvolvimento a um agente de programação externo; não é um pacote Python, não é instalado por pip install agent-framework, e não corre dentro da tua aplicação Agent Framework.
Importante
Esta capacidade do agente de programação é diferente das capacidades do agente em tempo de execução. As skills de runtime são carregadas por um agente do Agent Framework enquanto a sua aplicação está a correr. A Builder Skill ajuda um agente de programação a criar ou modificar o código-fonte da sua aplicação.
Tip
Associe a competência de criação ao Microsoft Learn MCP Server. A skill oferece ao agente de programação orientação focada para o fluxo de trabalho do Agent Framework e orientações de implementação, enquanto o Learn MCP Server permite-lhe pesquisar a documentação atual da Microsoft, obter artigos completos e encontrar exemplos de código durante a tarefa. Configure este endpoint HTTP Streamable público, não autenticado, num agente de codificação compatível:
https://learn.microsoft.com/api/mcp
Pré-requisitos
- Um agente de programação que suporta a especificação aberta Agent Skills.
-
GitHub CLI com os comandos em pré-visualização
gh skill, ou Node.js 22.20 ou posterior se usares a CLI cross-agentskills. - Python 3.11 ou posterior. O Agent Framework 1.24 já não suporta nem testa Python 3.10, embora os metadados dos pacotes ainda permitam a instalação.
A gestão de skills da CLI do GitHub está em pré-visualização e sujeita a alterações.
Reveja e instale com a CLI do GitHub
Pré-visualize a skill lançada antes de a instalar:
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
Bloqueie a versão Python 1.23 quando precisar de orientação reproduzível:
gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0
A instalação padrão tem âmbito de projeto e destina-se ao GitHub Copilot em uso não interativo. Selecione outro agente de codificação suportado ou âmbito de utilizador 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 opções atuais de cliente e âmbito, veja gh skill install.
Instalar com a CLI de competências entre agentes
Como alternativa, instale a skill com a CLI cross-agent skills:
npx skills add microsoft/agent-framework --skill agent-framework-builder-python
Revise os agentes de codificação suportados pela CLI e os requisitos de tempo de execução antes da instalação.
Use a habilidade
Instrua o agente de codificação naturalmente. Clientes compatíveis descobrem e ativam a competência a partir dos seus metadados; não presuma que exista um comando universal de barra.
Exemplos de prompts:
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 fornecedor do modelo, destino de alojamento, requisitos de persistência, limite de segurança e a versão Python suportada quando os conhecer.
O que o agente de codificação deve fazer
A skill instrui um agente de programação para:
- Escolha o menor padrão adequado, como um agente simples, harness, workflow, orquestração ou definição declarativa.
- Carregue apenas as referências relevantes em foco.
- Prefira as orientações atuais do Microsoft Learn, referências públicas de APIs, informações sobre o ciclo de vida dos pacotes e amostras mantidas para detalhes voláteis.
- Instale conjuntos reduzidos de pacotes em vez de assumir que todas as integrações são estáveis ou necessárias.
- Mantenha limites explícitos de sessão, aprovação, autenticação e hosting.
- Valide a aplicação gerada com os testes existentes do repositório, verificações de tipos e amostras executáveis.
A competência não garante que o código gerado esteja pronto para produção. Revise o plano do agente de codificação, escolhas de pacotes, limites de segurança, comandos e alterações geradas antes da aprovação.
Controlo de versões e confiança
A skill é uma skill pública, instalável e mantida pela Microsoft para consumidores, lançada na tag do repositório python-1.23.0. A versão dos metadados da skill é 0.3.
- Use o comando install não qualificado para a última versão etiquetada.
- Fixa
@python-1.23.0quando a reprodutibilidade importa. - Utilize
@mainapenas quando quiser intencionalmente orientação não divulgada. - Pré-visualize o conteúdo das skills antes da instalação e revise atualizações antes de confiar em novos scripts ou instruções.
Para a fonte e referências focadas, veja:
- Competência de construtor lançada
- Catálogo de competências do Agent Framework
- Pull request da competência Builder
Passos seguintes
Vai mais fundo:
Note
Ainda não está disponível uma skill de criação do Microsoft Agent Framework para Go. Utilize o tutorial de introdução ao Go e os exemplos do Agent Framework Go para obter orientações atualizadas.