¿Qué es GitHub Copilot actualización?

GitHub Copilot actualización es un agente de GitHub Copilot que le ayuda a actualizar proyectos a versiones más recientes de .NET de forma rápida y segura. Le guía a través de la evaluación, las recomendaciones de soluciones, las correcciones de código y la validación en Visual Studio, Visual Studio Code, GitHub Copilot CLI y GitHub.com.

Use este agente para:

  • Actualice a una versión más reciente de .NET.
  • Modernice la aplicación de .NET, especialmente al actualizar desde .NET Framework.
  • Evalúe el código, la configuración y las dependencias de la aplicación.
  • Valide que la aplicación se compila y prueba correctamente.

Escenarios

El agente proporciona varios flujos de trabajo de modernización de un extremo a otro denominados escenarios. Cada escenario es un flujo de trabajo administrado que le guía a través de un tipo específico de actualización o migración:

Scenario Description Mensaje de ejemplo
actualización de versión de .NET Actualiza desde versiones anteriores de .NET a .NET 8, 9, 10 o posterior. "Actualizar mi solución a .NET 10"
Conversión de estilo SDK Convierte el formato de proyecto heredado al estilo del SDK. "Convertir al estilo del SDK"
Actualización de Newtonsoft.Json Reemplaza Newtonsoft.Json por System.Text.Json. "Actualización de Newtonsoft.Json"
Actualización de SqlClient Actualiza de System.Data.SqlClient a Microsoft.Data.SqlClient. "Actualizar SqlClient"
Actualización de Azure Functions Actualiza Azure Functions del modelo en proceso al modelo de trabajo aislado. "Actualizar mi Azure Functions"
Núcleo semántico a agentes Actualiza los agentes de Kernel semántico a Microsoft Agent Framework. "Actualizar mis agentes de SK"
Integración de Aspire Añade compatibilidad con Aspireinner-loop y el despliegue en Azure. "Agregar Aspire a mi aplicación"
Aspire actualización de versión Actualiza las aplicaciones existentes Aspire a versiones más recientes. "Actualizar mi Aspire versión"
Actualización de WebForms a Blazor Actualiza las aplicaciones ASP.NET Web Forms a Blazor. "Migrar mi aplicación Web Forms a Blazor"

Para obtener una referencia completa de todos los escenarios y más de 30 aptitudes de actualización integradas, consulte Escenarios y referencia de aptitudes.

Enviar comentarios

Microsoft valora sus comentarios y los utiliza para mejorar su agente. Deje comentarios con cualquiera de estas opciones:

Prerequisites

Configure GitHub Copilot actualización en el entorno de desarrollo antes de usar el agente. Para conocer los pasos de instalación, consulte Instalación de GitHub Copilot actualización.

Actualización de proyectos de .NET

El agente de actualización admite la actualización de proyectos de C# y Visual Basic de los siguientes tipos:

  • ASP.NET Core (y tecnologías relacionadas como MVC, Razor Pages y Web API)
  • Formularios Web de ASP.NET
  • Blazor
  • Azure Functions
  • Windows Presentation Foundation (WPF)
  • Windows Forms
  • WinUI
  • .NET MAUI y Xamarin
  • Bibliotecas de clases
  • Aplicaciones de consola
  • Proyectos de prueba (MSTest, NUnit y xUnit)

Para iniciar una actualización, consulte Actualización de una aplicación de .NET con GitHub Copilot actualización.

Rutas de actualización compatibles

El agente admite las siguientes rutas de actualización:

Source Objetivo
.NET Framework (cualquier versión) .NET 8 o posterior
.NET Framework (cualquier versión) .NET Framework 4.8.1
.NET Core 1.x–3.x .NET 8 o posterior
.NET 5 o posterior .NET 8 o posterior

Migración de proyectos de .NET a Azure

Para migrar las aplicaciones de .NET a Azure, use el agente de modernización de GitHub Copilot. El agente de modernización controla escenarios específicos de Azure, como la migración de bases de datos, el almacenamiento, la identidad, la mensajería y la implementación.

Supervisión de actualizaciones con el panel

El panel de actualización proporciona una vista visual de una sesión de actualización en GitHub Copilot CLI y GitHub Copilot aplicación. Use sus paneles para realizar un seguimiento del progreso general, los escenarios, las tareas, los proyectos, las dependencias, los resultados de la evaluación, las opciones de actualización y la actividad del agente.

Para abrir el panel, pida Copilot mostrarlo durante una sesión de actualización. El panel no está disponible actualmente en Visual Studio, Visual Studio Code u otros IDE. Para obtener más información sobre cada panel, consulte Supervisión de actualizaciones con el Panel de actualización.

Cómo funciona

Para iniciar un proceso de actualización o migración, consulte:

  1. Inicie el agente usando uno de estos métodos.

    • Visual Studio: haga clic con el botón derecho en la solución o proyecto en Explorador de soluciones y seleccione Modernize. Como alternativa, abra la ventana Copilot Chat de GitHub y escriba @Modernize.
    • Visual Studio Code: abra el panel GitHub Copilot Chat y escriba @upgrade.
    • GitHub Copilot CLI: escriba @upgrade seguido de la solicitud de actualización o migración.
    • GitHub aplicación Copilot: en el selector del agente, seleccione Upgrade.

  2. Dígale al agente qué actualizar o migrar.

Al pedir al agente de actualización que actualice la aplicación, Copilot primero le pedirá que cree una rama si está trabajando en un repositorio de Git. A continuación, Copilot evalúa el proyecto y ejecuta un flujo de trabajo de tres fases. Cada fase genera archivos Markdown en .github/upgrades/{scenarioId} en el repositorio para que pueda revisar lo que viene a continuación antes de continuar. Si .github/upgrades/{scenarioId} ya existe a partir de un intento anterior, Copilot pregunta si desea continuar o comenzar de nuevo.

Copilot comienza examinando la estructura del proyecto, las dependencias y los patrones de código para crear una evaluación completa. En el archivo se assessment.md enumeran los cambios importantes, los problemas de compatibilidad de API, los patrones en desuso y el ámbito de actualización.

Después de la evaluación, Copilot ejecuta las tres fases siguientes:

  1. Assessment: Copilot examina la estructura, las dependencias y los patrones de código del proyecto y, a continuación, presenta decisiones de estrategia para su revisión, como la estrategia de actualización (abajo, arriba arriba, arriba o todo a la vez), el enfoque de actualización del proyecto, las opciones de modernización de la tecnología y el control de compatibilidad. Copilot guarda las decisiones confirmadas en upgrade-options.md.

  2. Planning: Copilot convierte la evaluación y las opciones confirmadas en una especificación detallada. El plan.md archivo documenta estrategias de actualización, enfoques de refactorización, rutas de acceso de dependencias y mitigaciones de riesgos.

  3. Execution: Copilot divide el plan en tareas secuenciales y concretas con criterios de validación en tasks.md. Cada tarea describe un único cambio y cómo Copilot confirma que se realizó correctamente.

Edite cualquiera de los archivos markdown en .github/upgrades/{scenarioId} para ajustar los pasos de actualización o agregar contexto antes de avanzar.

Actualizar estrategias

Durante la fase de evaluación, el agente evalúa la solución y recomienda una de estas estrategias:

Strategy Más adecuado para Description
De abajo hacia arriba Soluciones grandes con gráficos de dependencias profundas Actualiza primero los proyectos hoja y luego progresa hacia arriba.
Arriba abajo Comentarios rápidos sobre la aplicación principal Actualiza primero el proyecto de aplicación y, a continuación, corrige las dependencias.
Todo a la vez Soluciones pequeñas y sencillas Actualiza todos los proyectos en un solo paso.

Modos de flujo

El agente admite dos modos de flujo que controlan cuánto se pausa para recibir su entrada.

  • Automático: El agente pasa por todas las etapas sin pausar, deteniéndose solo en bloqueadores genuinos. Ideal para usuarios experimentados y actualizaciones sencillas.
  • Guiado: El agente se detiene en cada límite de fase para que puedas revisar la evaluación, el plan y las tareas antes de continuar. Lo mejor para los usuarios principiantes y para soluciones complejas.

Cambie entre modos en cualquier momento diciendo "pausa" (para entrar en modo guiado) o "continuar" (para entrar en el modo automático).

Administración de estados

El agente almacena todo el estado de actualización en .github/upgrades/{scenarioId}/. La carpeta contiene:

Archivo Purpose
assessment.md Análisis de la solución
upgrade-options.md Decisiones de actualización confirmadas
plan.md Plan de tareas ordenado
tasks.md Panel de progreso activo
scenario-instructions.md Memoria persistente del agente, incluidas las preferencias, las decisiones y las instrucciones personalizadas
tasks/{taskId}/task.md Ámbito y contexto por tarea
tasks/{taskId}/progress-details.md Notas y resultados de ejecución por tarea

Dado que todo el estado reside en esta carpeta, puede cerrar el IDE, cambiar entre sesiones o incluso cambiar entre entornos de desarrollo (por ejemplo, iniciar en VS Code y continuar en Visual Studio). El agente retoma desde donde se quedó.

Sugerencia

Confirme la carpeta en la .github/upgrades/ rama. El estado comprometido actúa como respaldo y permite a los miembros del equipo ver el progreso de la actualización.

Realización de la actualización

Una vez completada cada fase, revise y modifique los archivos generados según sea necesario y, a continuación, indique a Copilot continuar con la siguiente fase.

Cuando llegue a la fase Execution, indique a Copilot iniciar la actualización. Si Copilot se encuentra en un problema, intenta identificar la causa y aplicar una corrección. Si Copilot no puede corregir el problema, solicita su ayuda. Al intervenir, Copilot aprende de los cambios que realice e intenta aplicarlos automáticamente si el problema vuelve a producirse.

Resultados de la actualización

A medida que Copilot ejecuta cada tarea, actualiza el archivo tasks.md en .github/upgrades/{scenarioId} con el estado de cada paso. Supervise el progreso revisando este archivo. Copilot crea una confirmación de Git para cada parte del proceso, por lo que puede revertir los cambios o revisar lo que ha cambiado.

Cuando finalice la actualización, Copilot muestra los pasos siguientes en la respuesta del chat.

Telemetry

La herramienta recopila datos sobre los tipos de proyecto, la intención de actualizar y la duración de la actualización. El entorno de desarrollo recopila y agrega los datos y no contiene ninguna información identificable por el usuario. Para obtener más información sobre la directiva de privacidad de Microsoft, vea Programa de mejora de la experiencia del cliente de Visual Studio.

Contenido relacionado

  • Last updated on