Compartilhar via

Referência de cenários e habilidades

GitHub Copilot modernização para .NET ajuda você a modernizar por scenarios e skills:

  • Scenarios são fluxos de trabalho gerenciados de ponta a ponta para as principais metas de atualização, como a atualização do .NET Framework para o .NET 10. Os cenários coordenam o ciclo de vida completo: avaliação, planejamento e execução tarefa por tarefa.
  • As habilidades são recursos focados para tarefas de atualização específicas, como converter EF6 no EF Core ou substituir o WCF pelo CoreWCF. As habilidades são ativadas automaticamente quando o agente encontra código relevante durante uma atualização.

O agente dá suporte a projetos C# e Visual Basic.

Dica

Você não precisa memorizar nomes. Descreva o que você deseja ("upgrade to .NET 10", "upgrade my EF6 code", "replace Newtonsoft.Json") e o agente carrega automaticamente o cenário e as habilidades certos. Você também pode perguntar: "Com o que você pode me ajudar?"

Cenários

Os cenários são os fluxos de trabalho de atualização de nível superior do agente. Quando você inicia uma conversa, o agente identifica o melhor cenário para sua meta e o orienta passo a passo.

Scenario O que faz Prompt de exemplo
.NET atualização de versão Atualiza projetos de qualquer versão de .NET mais antiga para .NET 8 ou posterior. "Atualizar minha solução para .NET 10"
Conversão no estilo SDK Converte arquivos de projeto herdados em formato de SDK moderno. "Converter meus projetos no estilo SDK"
Atualização newtonsoft.json Substitui Newtonsoft.Json por System.Text.Json em uma solução. "Upgrade de Newtonsoft.Json"
Atualização do SqlClient Atualiza System.Data.SqlClient para Microsoft. Data.SqlClient. "Atualizar o SqlClient para o pacote moderno"
Azure Functions upgrade Atualiza Azure Functions do modelo de trabalho em processo para isolado. "Atualizar meu Azure Functions"
Kernel semântico to Agents Atualizações dos Agentes de SK para o Microsoft Agent Framework. "Atualizar meus agentes de SK"

Para obter um passo a passo de ponta a ponta, consulte os conceitos do Core.

atualização de versão do .NET

O cenário mais comum. Atualiza seus projetos de qualquer variante de .NET mais antiga para a mais recente:

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

O agente analisa o grafo de dependência, verifica a compatibilidade do NuGet, identifica alterações interruptivas e cria um plano de tarefas usando a melhor estratégia para sua solução (de baixo para cima, de cima para baixo ou tudo de uma vez). Se seus projetos precisarem de conversões de formato, o agente os manipulará automaticamente como parte da atualização.

Conversão no estilo SDK

Converte arquivos e .csproj herdados .vbproj no formato moderno no estilo SDK sem alterar as estruturas de destino. O agente manipula a conversão automaticamente durante as atualizações de versão. Execute esse cenário de forma independente, se necessário.

Atualização newtonsoft.json

Newtonsoft.Json Substitui por System.Text.Json toda a solução. Manipula conversores personalizados, [JsonProperty] atributos, JObject/JArray uso e configurações de serialização.

Atualização do SqlClient

Atualizações de System.Data.SqlClient para Microsoft.Data.SqlClient. Lida com a alteração de comportamento padrão Encrypt=true e cadeia de conexão diferenças.

atualização Azure Functions

Atualiza Azure Functions do modelo de hospedagem em processo para o modelo de trabalho isolado com Program.cs e HostApplicationBuilder. Inclui a atualização do Application Insights.

Kernel semântico ao Microsoft Agent Framework

Atualizações de Kernel semântico Agents (ChatCompletionAgent, OpenAIAssistantAgent) para Microsoft Agent Framework. Atualiza pacotes e padrões de API.

Habilidades de atualização: comuns

Habilidades de atualização de uso geral que se aplicam entre tipos de projeto.

Habilidade O que faz
Convertendo em estilo SDK Converte arquivos de projeto herdados em formato de SDK moderno. Usa a ordenação topológica para soluções de vários projetos.
Atualizando o Autofac para .NET DI Remove totalmente o Autofac e atualiza todos os registros para injeção interna de dependência ASP.NET Core.
Integrating Autofac com .NET Mantém o Autofac como o contêiner de DI, mas moderniza sua integração ASP.NET Core.
Atualizando namespaces de criptografia Corrige a divisão de System.Security.Cryptography namespace para tipos como X509Certificate2 e SignedCms.
Atualizando Newtonsoft para System.Text.Json Atualização completa de Newtonsoft.Json. Manipula conversores, atributos, tipos dinâmicos e configurações.
Atualizando Kernel semântico para Agentes Atualiza as APIs do agente Kernel semântico para o Microsoft Agents AI Framework.
Atualizando para o MSMQ. Mensagens Atualizações de System.Messaging (somente .NET Framework) para MSMQ.Messaging para .NET Core.
Convertendo em Gerenciamento Central de Pacotes Converte o controle de versão do pacote NuGet por projeto em gerenciamento de pacote centralizado usando Directory.Packages.props.
Modernizando a versão do C# Atualiza o código C# para usar recursos de linguagem mais recentes (C# 7.0 a 15). Faz alterações dotnet format mecânicas em lotes e usa o julgamento de LLM para transformações semânticas.
Atualizando referências anuláveis em C# Habilita tipos de referência anuláveis e resolve sistematicamente todos os avisos CS86xx. Aborda estratégias de distribuição, diretrizes de anotação e considerações específicas da estrutura.

Habilidades de atualização: acesso a dados

Habilidades para atualizar camadas de acesso a dados, incluindo Entity Framework, LINQ para SQL e bibliotecas de clientes SQL.

Habilidade O que faz
Atualizando o EDMX para Code-First Converte modelos de Database-First () EF6 em.edmx EF Core Code-First. Scaffolds entidades do banco de dados.
Atualizando o EF DbContext Registra DbContext na injeção de dependência ASP.NET Core. Manipula os padrões EF6 para EF Core e EF Core existentes.
Atualizando Code-First do EF6 para o EF Core Atualiza o EF6 Code-First para o EF Core. Troca pacotes, atualiza namespaces e substitui EntityTypeConfiguration e DbModelBuilder.
Atualizando para Microsoft. Data.SqlClient Atualizações de System.Data.SqlClient. Lida com a alteração padrão Encrypt=true e cadeia de conexão diferenças.

Habilidades de atualização: Web e ASP.NET

Habilidades para atualizar aplicativos do ASP.NET Framework para ASP.NET Core.

Atualização do ASP.NET Framework

Habilidade O que faz
Upgrade ASP.NET Framework para Core Atualização abrangente do ASP.NET Framework (MVC/WebAPI) para ASP.NET Core, incluindo controladores, exibições, middleware, autenticação e configuração.
Upgrade ASP.NET Identity Atualiza ASP.NET MVC Identity para ASP.NET Core Identity, incluindo IdentityDbContext, UserManager, SignInManager e middleware de autenticação.
Atualizando Global.asax Converte eventos de ciclo de vida Global.asax (Application_Start, Application_Error) em ASP.NET Core Program.cs e middleware.
Atualizando o OWIN para middleware Substitui o middleware OWIN/Katana (IAppBuilder, OwinMiddleware) por equivalentes de ASP.NET Core.
Atualizando a autenticação de cookie OWIN Atualiza o middleware de autenticação de cookie OWIN para ASP.NET Core autenticação de cookie.
Atualizando o OAuth OWIN para JWT Atualiza a autenticação de token de portador OAuth OWIN para ASP.NET Core autenticação do portador JWT.
Atualizando o OWIN OpenID Connect Atualiza o middleware do OWIN OpenID Connect para ASP.NET Core autenticação do OpenID Connect.

Recursos do MVC

Habilidade O que faz
Atualizando a autenticação do MVC Atualiza ASP.NET MVC autenticação para ASP.NET Core middleware de identidade e autenticação.
Atualizando o agrupamento do MVC System.Web.Optimization Converte o agrupamento em marcas diretas <script>/<link> ou empacotadores modernos.
Atualizando a configuração do MVC Atualiza as configurações de web.config e app.config para o sistema de configuração de ASP.NET Core (appsettings.json, variáveis de ambiente).
Atualizando a negociação de conteúdo do MVC Atualiza os padrões de negociação de conteúdo e os formatadores para ASP.NET Core.
Atualizando controladores MVC Atualiza controladores MVC e WebAPI para padrões de controlador ASP.NET Core.
Atualizando a injeção de dependência do MVC Atualiza os registros de contêiner de DI para a injeção de dependência interna do ASP.NET Core.
Atualizando filtros MVC Converte filtros MVC globais (FilterConfig, GlobalFilters) em ASP.NET Core middleware e pipeline de filtro.
Atualizando o pipeline HTTP do MVC Atualiza módulos HTTP e manipuladores para ASP.NET Core middleware.
Atualizando o HttpContext do MVC Atualiza System.Web.HttpContext uso para ASP.NET Core HttpContext.
Atualizando o registro em log do MVC Atualiza o registro em log para Microsoft.Extensions.Logging.
Atualizando a associação de modelo do MVC Atualiza padrões de associação de modelo para ASP.NET Core associação de modelo.
Atualizando exibições do Razor do MVC Atualiza exibições do Razor, layouts e componentes de exibição para ASP.NET Core Razor.
Atualizando o roteamento do MVC Converte o roteamento RouteCollection para ASP.NET Core roteamento de ponto de extremidade (MapControllerRoute, roteamento de atributo).
Atualizando o estado da sessão do MVC Atualiza o estado da sessão para ASP.NET Core sessão distribuída.
Atualizando arquivos estáticos do MVC Atualiza o tratamento de arquivos estáticos para o middleware de arquivos estáticos do ASP.NET Core.
Atualizando adaptadores do MVC System.Web Usa adaptadores System.Web para atualização incremental do ASP.NET Framework para o ASP.NET Core.
Atualizando a validação do MVC Atualiza os atributos e padrões de validação para ASP.NET Core validação.

WCF

Habilidade O que faz
Atualizando o WCF para o CoreWCF Atualiza os serviços WCF do lado do servidor para CoreWCF para .NET 6+. Converte hospedagem, associações, extensões de comportamento e contratos assíncronos.

Habilidades de atualização: nuvem e Azure

Habilidade O que faz
Upgrade Azure Functions Startup Atualiza Azure Functions da classe Startup em processo para o modelo de trabalho isolado com Program.cs.
Atualizando Azure Functions para v2 Atualiza Azure Functions para o padrão de hospedagem v2 usando IHostApplicationBuilder.
Upgrade Azure Key Vault Atualiza o SDK de Azure Key Vault herdado para as bibliotecas Azure.Security.KeyVault modernas.
Upgrade Barramento de Serviço do Azure Atualiza o SDK de Barramento de Serviço do Azure herdado para a biblioteca Azure.Messaging.ServiceBus moderna.
Upgrade Armazenamento do Azure Atualiza o SDK de Armazenamento do Azure herdado para as bibliotecas Azure.Storage modernas.

Habilidades de atualização: bibliotecas

Habilidade O que faz
Atualizando a ADAL para MSAL Atualiza Azure Active Directory ADAL (Biblioteca de Autenticação) para Biblioteca do Microsoft Authenticator (MSAL).
Upgrade ASP.NET SignalR Atualiza ASP.NET SignalR para ASP.NET Core SignalR.
Atualizando interfaces do Bond Atualiza Microsoft serialização do Bond para alternativas modernas.
Atualizando o EDM de dados para o OData Atualiza tipos para bibliotecas Data.Edm OData.
Atualizando o OData de dados para o OData Core Atualiza Microsoft.Data.OData para Microsoft.OData.Core.
Atualizando o cliente dos Serviços de Dados Atualiza o cliente do WCF Data Services para o cliente OData moderno.
Atualizando o SDK do PowerShell Atualiza os módulos do PowerShell do Windows PowerShell 5.1 para o PowerShell 7+ com o pacote Microsoft.PowerShell.SDK.
Atualizando os Serviços SPA para o Proxy do SPA Atualiza Microsoft.AspNetCore.SpaServices para o modelo de hospedagem do Proxy spa.
Atualizando System.Spatial Atualiza Microsoft.Spatial e System.Spatial para alternativas espaciais modernas.
Atualizando o CORS do WebAPI Atualiza System.Web.Http.Cors para ASP.NET Core middleware CORS.
Atualizando o OData do WebAPI Atualiza o OData do WebAPI para ASP.NET Core OData.

Quando as habilidades são ativadas

O agente carrega as habilidades progressivamente à medida que a sessão de atualização se desenrola:

Quando O que acontece
Início da sessão O agente carrega o cenário de correspondência e todas as habilidades que são imediatamente relevantes para sua base de código.
Durante a execução Como o agente funciona por meio de tarefas, ele carrega habilidades especializadas extras sob demanda quando encontra padrões de atualização específicos, como arquivos EDMX, serviços WCF ou middleware OWIN.
Sob solicitação Você pode pedir ao agente para usar qualquer habilidade a qualquer momento. Por exemplo, "ajude-me a atualizar o WCF para o CoreWCF" ou "use a habilidade de atualização do EF6".

Você não precisa gerenciar o carregamento de habilidades. O agente o manipula automaticamente. Apenas descreva o que você precisa.

Criar suas próprias habilidades

Crie habilidades personalizadas para ensinar os padrões de agente específicos à sua base de código, como atualizações de estrutura interna, convenções de codificação ou fluxos de trabalho de atualização personalizados.

Coloque habilidades em seu repositório (.github/skills/) ou perfil de usuário (%UserProfile%/.copilot/skills/) e o agente as escolhe automaticamente.

Para obter mais informações sobre como criar habilidades personalizadas, consulte Aplicar instruções de atualização personalizadas.

Conteúdo relacionado

  • Last updated on