FAQ sobre modernização do GitHub Copilot

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:

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

  1. Vai a Ver>Saída para abrir a janela de 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 aparece aqui, mostrando o progresso em tempo real.

Ou, acede à janela de Saída com o atalho de teclado Ctrl+Alt+O.

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