O GitHub Copilot Modernization é um agente interativo do GitHub Copilot que adiciona capacidades ao seu ambiente de desenvolvimento. Este artigo responde a perguntas frequentes. Para mais informações, veja O que é modernização do GitHub Copilot.
A ferramenta requer uma das seguintes subscrições do GitHub Copilot:
- Copilot Free (A partir do Visual Studio 2026 versão 18.1)
- Copilot Pro
- Copilot Pro+
- Negócio Copilot
- Copilot Enterprise
A modernização do GitHub Copilot está disponível no Visual Studio, Visual Studio Code, GitHub Copilot CLI e no GitHub.com. Para Visual Studio, está incluído em Visual Studio 2026 (ou Visual Studio versão 17.14.17 de 2022 e posteriores).
Para mais informações sobre a instalação, instalar a modernização do GitHub Copilot.
Agente de modernização
O que o agente pode fazer?
A modernização do GitHub Copilot ajuda-te a atualizar os teus projetos .NET (.NET, .NET Core e .NET Framework) para versões mais recentes do .NET. Também ajuda a modernizar serviços para o Azure, atualiza dependências e corrige erros de código após a atualização. O agente executa os seguintes passos numa sessão de chat do Copilot:
- Analisa os seus projetos e propõe um plano de modernização.
- Executa uma série de tarefas para modernizar os seus projetos de acordo com o plano.
- Opera em uma ramificação de trabalho dentro de um repositório Git local.
- Corrige automaticamente os problemas durante a transformação do código.
- Reporta o progresso e permite o acesso a alterações de código e registos.
- Aprende com as tuas interações durante a sessão para melhorar as transformações subsequentes.
Que limitações existem?
- O agente requer um repositório Git local.
- As sugestões de upgrade não garantem que sigam as melhores práticas.
- As correções e correções de código que forneces ao Copilot durante o processo de atualização não persistem e não são lembradas para futuras atualizações.
Que modelo devo usar?
Usa um bom modelo de programação. A disponibilidade dos modelos depende da sua subscrição do Copilot e do ambiente. Para uma comparação de modelos, veja GitHub Copilot comparação de modelos de IA.
Posso treinar o modelo com base na minha base de código?
Não. Ao contrário das ferramentas tradicionais de IA, onde pode inserir prompts livres, o agente opera de forma estruturada. A IA está integrada no processo de construir e corrigir, pelo que os prompts que utiliza estão pré-definidos e ligados ao plano de atualização. Não podes treiná-lo na tua base de código, mas é usado como contexto pelo agente.
Posso personalizar ou orientar o agente?
O agente utiliza a personalização que o Copilot oferece, como ficheiros de instruções e competências. A personalização baseia-se no que o teu Copilot suporta. O agente inclui mais de 30 competências de modernização pré-instaladas que são carregadas automaticamente com base nas tecnologias detetadas no seu código fonte. Também podes criar habilidades e cenários personalizados. Para mais informações, consulte Aplicar instruções de atualização personalizada.
Se ajustar manualmente uma correção, fornecer instruções adicionais no chat ou atualizar o Markdown no ficheiro do plano, o agente irá aprender com essa interação no curto prazo. Preferências e decisões são guardadas scenario-instructions.md na .github/upgrades/ pasta para que persistam entre sessões.
O agente armazena meu código-fonte?
O agente nunca armazena a tua base de código nem usa o teu código para treinar o modelo. Assim que a atualização é concluída, o agente apaga os dados da sessão.
Posso dar a minha opinião?
Yes! Existem duas formas de fornecer feedback:
- No Visual Studio, utilize as funcionalidades Sugira uma funcionalidade e Reporte um Problema.
- Registar um problema no repositório GitHub modernize-dotnet.
Que dados são recolhidos?
O agente recolhe telemetria apenas sobre tipos de projetos, intenção de melhorar e duração da atualização. Os dados são agregados através do seu ambiente de desenvolvimento e não contêm informação identificável pelo utilizador. Para mais informações sobre a política de privacidade da Microsoft, consulte Visual Studio Programa de Melhoria da Experiência do Cliente.
Posso desativar a telemetria?
Yes. No Visual Studio, selecione Ajuda>Privacidade>Definições de Privacidade>"Não, não gostaria de participar." As definições de telemetria podem variar consoante o ambiente de desenvolvimento. Verifique as definições de privacidade da sua ferramenta para mais informações.
Atualizar as aplicações .NET
O que o agente pode atualizar?
A modernização do GitHub Copilot ajuda-te a atualizar os teus projetos .NET ou a modernizá-los para o Azure. O agente suporta múltiplos cenários para além das atualizações do framework, incluindo integração com o Aspire, conversão ao estilo SDK, atualização Newtonsoft.Json, atualização do SqlClient, atualização do Funções do Azure e atualização do Kernel Semântico para o Microsoft Agent Framework. Para uma referência completa, veja Cenários e referências de competências.
O agente trabalha com os seguintes tipos de projetos:
- Funções do Azure
- Aplicações de consola e bibliotecas de classes
- Tecnologias Web, tais como:
- MVC
- Blazor
- Razor Pages
- API Web
- Tecnologias de ambiente de trabalho como Windows Forms, Windows Presentation Foundation e WinUI
- .NET MAUI e Xamarin
- Projetos de teste como MSTest, NUnit e xUnit
- Projetos do .NET Framework
O agente suporta tanto C# como Visual Basic.
Para que versões .NET posso atualizar?
O agente suporta os seguintes caminhos de atualização:
| Fonte | Target |
|---|---|
| Framework .NET (qualquer versão) | .NET 8 ou posterior |
| .NET Core 1.x–3.x | .NET 8 ou posterior |
| .NET 5 ou posterior | .NET 8 ou posterior |
Posso usar o agente offline?
Não. O agente requer uma ligação à internet e a infraestrutura cloud do GitHub Copilot. O agente trabalha com todos os níveis de subscrição do Copilot, incluindo o nível gratuito.
O agente modifica ficheiros fora da solução?
Não. O agente só modifica ficheiros dentro do seu espaço de trabalho e da .github/upgrades/ pasta. Os dados personalizados das tarefas permanecem no teu repositório.
Posso aceitar parcialmente as alterações do agente?
Yes. Como cada tarefa é comprometida separadamente, podes selecionar commits específicos usando comandos Git padrão. Revise o histórico de commits com git log --oneline e utilize git cherry-pick para selecionar alterações individuais.
Migrar para o Azure
O que o agente pode migrar?
O agente ajuda a migrar e implementar as suas aplicações .NET para o Azure, incluindo:
- Aplicações Web
- Aplicações API
- Funções do Azure
- Aplicações em contentores
Os cenários de migração incluem:
- Migração de bases de dados
- Armazenamento
- Identidade
- Messaging
- Transmissão de eventos
- Exploração Florestal
- Segurança
Para obter mais informações sobre esses cenários, consulte Tarefas predefinidas para migração.
Posso acompanhar o progresso da avaliação?
Yes. Monitorize o progresso da avaliação através da interface do Visual Studio. O agente fornece feedback em tempo real e atualizações de estado. Outros ambientes de desenvolvimento podem oferecer diferentes opções de monitorização.
No Visual Studio, monitorize o progresso da avaliação visualizando a saída da linha de comandos enquanto a avaliação decorre:
- Vai a Ver>Saída para abrir a janela de Saída .
- Na janela Saída, encontre o menu suspenso Mostrar saída de.
- Selecione AppModernizationExtension na lista suspensa.
- A saída da linha de comando da ferramenta de avaliação aparece aqui, mostrando o progresso em tempo real.
Ou, acede à janela de Saída com o atalho de teclado Ctrl+Alt+O.
Conteúdo relacionado
Para saber mais, consulte O que é a modernização do GitHub Copilot?