Perguntas frequentes sobre a modernização do GitHub Copilot

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:

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
  • Email
  • 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:

  1. Vá para Ver>Saída para abrir a janela Saída.
  2. Na janela Saída, encontre o menu suspenso Mostrar saída de.
  3. Selecione AppModernizationExtension na lista suspensa.
  4. 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.

Para saber mais, consulte O que é a modernização do GitHub Copilot?.