O que é GitHub Copilot atualização?

GitHub Copilot atualização é um agente GitHub Copilot que ajuda você a atualizar projetos para versões mais recentes do .NET de forma rápida e confiante. Ele orienta você por meio de avaliação, recomendações de solução, correções de código e validação em Visual Studio, Visual Studio Code, GitHub Copilot CLI e GitHub.com.

Use este agente para:

  • Atualize para uma versão mais recente do .NET.
  • Modernize seu aplicativo .NET, especialmente durante a atualização do .NET Framework.
  • Avalie o código, a configuração e as dependências do aplicativo.
  • Valide se o aplicativo compila e testa com êxito.

Cenários

O agente fornece vários fluxos de trabalho de modernização de ponta a ponta chamados cenários. Cada cenário é um fluxo de trabalho gerenciado que orienta você por meio de um tipo específico de atualização ou migração:

Scenario Descrição Prompt de exemplo
Atualização de versão do .NET Atualizações de versões de .NET mais antigas para .NET 8, 9, 10 ou posterior. "Atualizar minha solução para .NET 10"
Conversão no estilo SDK Converte o formato de projeto herdado em estilo SDK. "Converter para o estilo SDK"
Atualização do Newtonsoft.Json Substitui Newtonsoft.Json por System.Text.Json. "Atualização de Newtonsoft.Json"
Atualização do SqlClient Atualizações de System.Data.SqlClient para Microsoft. Data.SqlClient. "Atualizar SqlClient"
Azure Functions atualização Atualiza Azure Functions do modelo de trabalho em processo para o modelo de trabalhador isolado. "Atualizar meu Azure Functions"
Kernel semântico para os Agentes Atualiza Kernel semântico Agents para Microsoft Agent Framework. "Atualizar meus agentes de SK"
Integração do Aspire Adiciona suporte a Aspire inner loop e à implantação no Azure. "Adicionar Aspire ao meu aplicativo"
Aspire atualização de versão Atualiza aplicativos existentes Aspire para versões mais recentes. "Atualizar minha Aspire versão"
Atualização de WebForms para Blazor Atualiza aplicativos ASP.NET Web Forms para Blazor. "Migrar meu aplicativo Web Forms para Blazor"

Para obter uma referência completa de todos os cenários e mais de 30 habilidades de atualização internas, consulte Cenários e referência de habilidades.

Fornecer comentários

Microsoft valoriza seus comentários e o usa para melhorar o agente. Deixe comentários usando uma destas opções:

Pré-requisitos

Configure GitHub Copilot atualização em seu ambiente de desenvolvimento antes de usar o agente. Para obter as etapas de instalação, consulte Instalar GitHub Copilot atualização.

Atualizar projetos de .NET

O agente de atualização dá suporte à atualização de projetos C# e Visual Basic dos seguintes tipos:

  • ASP.NET Core (e tecnologias relacionadas, como MVC, Razor Pages e API Web)
  • ASP.NET Web Forms
  • Blazor
  • Azure Functions
  • Windows Presentation Foundation (WPF)
  • Windows Forms
  • WinUI
  • .NET MAUI e Xamarin
  • Bibliotecas de classes
  • Aplicativos de console
  • Projetos de teste (MSTest, NUnit e xUnit)

Para iniciar uma atualização, consulte Atualizar um aplicativo .NET com GitHub Copilot atualização.

Caminhos de atualização com suporte

O agente dá suporte aos seguintes caminhos de atualização:

Source Target
.NET Framework (qualquer versão) .NET 8 ou posterior
.NET Framework (qualquer versão) .NET Framework 4.8.1
.NET Core 1.x–3.x .NET 8 ou posterior
.NET 5 ou posterior .NET 8 ou posterior

Migrar projetos .NET para Azure

Para migrar seus aplicativos .NET para Azure, use o agente de modernização GitHub Copilot. O agente de modernização lida com cenários específicos Azure, como migração de banco de dados, armazenamento, identidade, mensagens e implantação.

Monitorar atualizações com o painel

O Painel de Atualização fornece uma exibição visual de uma sessão de atualização na CLI GitHub Copilot e GitHub Copilot aplicativo. Use seus painéis para acompanhar o progresso geral, cenários, tarefas, projetos, dependências, resultados de avaliação, opções de atualização e atividade do agente.

Para abrir o painel, peça a Copilot para mostrá-lo durante uma sessão de atualização. No momento, o painel não está disponível em Visual Studio, Visual Studio Code ou outros IDEs. Para obter detalhes sobre cada painel, consulte Monitorar atualizações com o Painel de Atualização.

Como funciona

Para iniciar um processo de atualização ou migração, consulte:

  1. Inicie o agente usando um destes métodos:

    • Visual Studio: clique com o botão direito do mouse na solução ou projeto em Gerenciador de Soluções e selecione Modernize. Como alternativa, abra a janela Copilot Chat do GitHub e digite @Modernize.
    • Visual Studio Code: abra o painel GitHub Copilot Chat e digite @upgrade.
    • GitHub Copilot CLI: digite @upgrade seguido de sua solicitação de atualização ou migração.
    • GitHub aplicativo Copilot: No seletor do Agente, selecione Upgrade.

  2. Diga ao agente o que deve ser atualizado ou migrado.

Quando você solicita ao agente de atualização para atualizar seu aplicativo, Copilot primeiro solicitará que você crie uma nova ramificação se estiver trabalhando em um repositório Git. Em seguida, Copilot avalia seu projeto e executa um fluxo de trabalho de três estágios. Cada estágio produz arquivos Markdown dentro de .github/upgrades/{scenarioId} no seu repositório para que você possa examinar o que vem a seguir antes de continuar. Se .github/upgrades/{scenarioId} já existir de uma tentativa anterior, Copilot perguntará se deseja continuar ou começar de novo.

Copilot começa examinando a estrutura do projeto, as dependências e os padrões de código para criar uma avaliação abrangente. O assessment.md arquivo lista mudanças significativas, problemas de compatibilidade de API, padrões preteridos e o escopo de atualização.

Após a avaliação, Copilot executa os três estágios a seguir:

  1. Assessment: Copilot examina a estrutura do projeto, as dependências e os padrões de código e, em seguida, apresenta decisões de estratégia para sua revisão, como a estratégia de atualização (de baixo para cima, de cima para baixo ou tudo ao mesmo tempo), abordagem de atualização de projeto, opções de modernização de tecnologia e tratamento de compatibilidade. O Copilot armazena as decisões confirmadas em upgrade-options.md.

  2. Planning: Copilot converte a avaliação e suas opções confirmadas em uma especificação detalhada. O arquivo plan.md documenta estratégias de atualização, abordagens de refatoração, caminhos de dependência e mitigações de risco.

  3. Execution: Copilot divide o plano em tarefas sequenciais e concretas com critérios de validação em tasks.md. Cada tarefa descreve uma única alteração e como Copilot confirma que ela foi bem-sucedida.

Edite qualquer um dos arquivos .github/upgrades/{scenarioId} markdown para ajustar as etapas de atualização ou adicionar contexto antes de avançar.

Atualizar Estratégias

Durante o estágio de avaliação, o agente avalia sua solução e recomenda uma destas estratégias:

Strategy Mais adequado para Descrição
De baixo para cima Soluções grandes com grafos de dependência profunda Atualiza os projetos de nível inferior primeiro e, em seguida, procede para cima.
De cima para baixo Comentários rápidos sobre o aplicativo principal Atualiza primeiro o projeto de aplicativo e, em seguida, corrige as dependências.
Tudo de uma vez Soluções pequenas e simples Atualiza todos os projetos de uma só vez.

Modos de fluxo

O agente suporta dois modos de fluxo que controlam quanto tempo ele pausa para receber sua entrada.

  • Automático: O agente trabalha em todos os estágios sem pausar, parando apenas em bloqueadores genuínos. Melhor para usuários experientes e atualizações simples.
  • Guiado: O agente pausa em cada limite de estágio para que você possa examinar a avaliação, o plano e as tarefas antes de prosseguir. Melhor para usuários iniciantes e soluções complexas.

Alterne entre os modos a qualquer momento dizendo "pausar" (para entrar no modo guiado) ou "continuar" (para entrar no modo automático).

Gerenciamento de estado

O agente armazena todo o estado de atualização em .github/upgrades/{scenarioId}/. A pasta contém:

Arquivo Purpose
assessment.md Análise da solução
upgrade-options.md Decisões de atualização confirmadas
plan.md Plano de tarefa ordenado
tasks.md Painel de progresso ao vivo
scenario-instructions.md Memória persistente do agente, incluindo preferências, decisões e instruções personalizadas
tasks/{taskId}/task.md Escopo e contexto por tarefa
tasks/{taskId}/progress-details.md Resultados e notas de execução por tarefa

Como todo o estado reside nessa pasta, você pode fechar o IDE, alternar entre sessões ou até mesmo alternar entre ambientes de desenvolvimento (por exemplo, iniciar no VS Code e continuar no Visual Studio). O agente continua de onde parou.

Dica

Envie a pasta para o branch .github/upgrades/. O estado comprometido serve como uma cópia de segurança e permite que os membros da equipe visualizem o progresso da atualização.

Realizar a atualização

Após a conclusão de cada estágio, examine e modifique os arquivos gerados conforme necessário e, em seguida, diga a Copilot para continuar para o próximo estágio.

Quando chegar ao estágio Execution, diga ao Copilot para iniciar a atualização. Se o Copilot encontrar um problema, ele tentará identificar a causa e aplicar uma correção. Se Copilot não puder corrigir o problema, ele pedirá sua ajuda. Quando você intervém, Copilot aprende com as alterações feitas e tenta aplicá-las automaticamente se o problema aparecer novamente.

Resultados da atualização

À medida que o Copilot executa cada tarefa, ele atualiza o arquivo tasks.md em .github/upgrades/{scenarioId} com o status de cada etapa. Monitore o progresso examinando este arquivo. Copilot cria uma confirmação do Git para cada parte do processo, para que você possa reverter as alterações ou examinar o que foi alterado.

Quando a atualização for concluída, Copilot exibirá as próximas etapas na resposta do chat.

Telemetry

A ferramenta coleta dados sobre tipos de projeto, intenção de atualização e duração da atualização. O ambiente de desenvolvimento coleta e agrega os dados e não contém informações identificáveis pelo usuário. Para obter mais informações sobre a política de privacidade da Microsoft, consulte o Programa de Aperfeiçoamento da Experiência do Cliente do Visual Studio.

Conteúdo relacionado

  • Last updated on