A modernização do GitHub Copilot é um agente interativo do GitHub Copilot que adiciona funções ao seu ambiente de desenvolvimento. Este artigo responde às perguntas frequentes. Para obter mais informações, consulte O que é a modernização do GitHub Copilot.
A ferramenta requer uma das seguintes assinaturas de GitHub Copilot:
- Copilot Gratuito (começando com Visual Studio 2026 versão 18.1)
- Copilot Pro
- Copilot Pro+
- Copilot Business
- Copilot Enterprise
A funcionalidade de modernização do GitHub Copilot está disponível no Visual Studio, Visual Studio Code, GitHub Copilot CLI e no GitHub.com. Para Visual Studio, ele está incluído no Visual Studio 2026 (ou Visual Studio versão 17.14.17 de 2022 e mais recente).
Para obter mais informações sobre a instalação, Instalar a atualização do GitHub Copilot.
Agente de modernização
O que o agente pode fazer?
Com o GitHub Copilot, a modernização ajuda a atualizar seus projetos de .NET (.NET, .NET Core e .NET Framework) para as versões mais recentes do .NET. Ele também ajuda a modernizar serviços para Azure, atualiza dependências e corrige erros no código após a atualização. O agente executa as seguintes etapas em uma sessão de chat Copilot:
- Analisa seus projetos e propõe um plano de modernização.
- Executa uma série de tarefas para modernizar seus projetos de acordo com o plano.
- Opera em um branch de trabalho em um repositório Git local.
- Corrige problemas automaticamente durante a transformação de código.
- Relata o progresso e permite o acesso a alterações de código e logs.
- Aprende com suas interações durante a sessão para melhorar as transformações subsequentes.
Quais são as limitações?
- O agente requer um repositório Git local.
- As sugestões de atualização não garantem seguir as práticas recomendadas.
- Correções de código e correções que você fornece para Copilot durante o processo de atualização não persistem e não são lembradas para atualizações futuras.
Qual modelo devo usar?
Use um bom modelo de codificação. A disponibilidade do modelo depende de sua assinatura e ambiente Copilot. Para obter uma comparação de modelos, consulte 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 de IA tradicionais em que você pode inserir prompts de forma livre, o agente opera de maneira estruturada. A IA é inserida no processo de build e correção, portanto, os prompts usados são predefinidos e vinculados ao plano de atualização. Você não pode treiná-lo em sua base de código, mas é usado como contexto pelo agente.
Posso personalizar ou orientar o agente?
O agente usa a personalização que o Copilot fornece, como arquivos de instrução e habilidades. A personalização depende das funcionalidades que o seu Copilot oferece. O agente inclui mais de 30 habilidades de modernização internas que são carregadas automaticamente com base nas tecnologias detectadas em sua base de código. Você também pode criar habilidades e cenários personalizados. Para obter mais informações, consulte Aplicar instruções de atualização personalizadas.
Se você ajustar manualmente uma correção, fornecer instruções adicionais no chat ou atualizar o Markdown no arquivo de plano, o agente aprenderá com essa interação a curto prazo. As preferências e as decisões são salvas em .github/upgrades/ na pasta scenario-instructions.md para que persistam entre as sessões.
O agente armazena meu código-fonte?
O agente nunca armazena sua base de código ou usa seu código para treinar o modelo. Depois que uma atualização for concluída, o agente excluirá os dados da sessão.
Posso fornecer comentários?
Yes! Há duas maneiras de fornecer comentários:
- Em Visual Studio, use os recursos Suggest a feature e Reportar um problema.
- Registre um problema no repositório GitHub modernize-dotnet.
Quais dados são coletados?
O agente coleta telemetria apenas sobre tipos de projeto, intenção de atualização e duração da atualização. Os dados são agregados por meio do seu ambiente de desenvolvimento e não contêm informações identificáveis pelo usuário. Para obter mais informações sobre a política de privacidade do Microsoft, consulte Visual Studio Customer Experience Improvement Program.
Posso desabilitar a telemetria?
Sim. Em Visual Studio, selecione Help>Privacy>Privacy Settings>"Não, Eu não gostaria de participar." as configurações de telemetria podem variar de acordo com o ambiente de desenvolvimento. Verifique as configurações de privacidade da ferramenta para obter mais informações.
Atualizar aplicativos .NET
O que o agente pode atualizar?
A modernização com GitHub Copilot ajuda você a atualizar ou modernizar seus projetos de .NET para o Azure. O agente dá suporte a vários cenários além de atualizações de framework, incluindo integração com o Aspire, conversão no estilo SDK, atualização do Newtonsoft.Json, atualização do SqlClient, atualização do Azure Functions e atualização de Kernel semântico para Microsoft Agent Framework. Para obter uma referência completa, consulte a referência de cenários e habilidades.
O agente trabalha com esses tipos de projeto:
- Azure Functions
- Aplicativos de console e bibliotecas de classes
- Tecnologias da Web como:
- MVC
- Blazor
- Razor Pages
- Web API
- Tecnologias da área de trabalho, como Windows Forms, Windows Presentation Foundation e WinUI
- .NET MAUI e Xamarin
- Testar projetos como MSTest, NUnit e xUnit
- projetos do .NET Framework
O agente dá suporte a C# e Visual Basic.
Para quais versões .NET posso atualizar?
O agente dá suporte aos seguintes caminhos de atualização:
| Fonte | Meta |
|---|---|
| .NET Framework (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 conexão com a Internet e a infraestrutura de nuvem GitHub Copilot. O agente funciona com todas as camadas de assinatura Copilot, incluindo a camada gratuita.
O agente modifica arquivos fora da solução?
Não. O agente modifica apenas os arquivos no workspace e na .github/upgrades/ pasta. Os dados da tarefa personalizada permanecem no repositório.
Posso aceitar parcialmente as alterações do agente?
Sim. Como cada tarefa é confirmada separadamente, você pode escolher confirmações específicas usando comandos Git padrão. Reveja o histórico de commits com git log --oneline e use git cherry-pick para selecionar alterações individuais.
Migrar para Azure
O que o agente pode migrar?
O agente ajuda a migrar e implantar seus aplicativos .NET para Azure, incluindo:
- Aplicativos Web
- Aplicativos de API
- Azure Functions
- Aplicativos em contêineres
Os cenários de migração incluem:
- Migrando bancos de dados
- Armazenamento
- Identidade
- Messaging
- Streaming de eventos
- Registro em log
- Segurança
Para obter mais informações sobre esses cenários, consulte Tarefas predefinidas para migração.
Posso monitorar o progresso da avaliação?
Sim. Monitore o progresso da avaliação por meio da interface Visual Studio. O agente fornece comentários em tempo real e atualizações de status. Outros ambientes de desenvolvimento podem oferecer diferentes opções de monitoramento.
Em Visual Studio, monitore o progresso da avaliação exibindo a saída da linha de comando enquanto a avaliação é executada:
- Vá para Ver>Saída para abrir a janela 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 é exibida aqui, mostrando o progresso em tempo real.
Ou acesse a janela 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?.