Was ist GitHub Copilot Upgrade?

GitHub Copilot Upgrade ist ein GitHub Copilot Agent, mit dem Sie unterstützte Projekte aktualisieren und modernisieren können. Es führt Sie durch Bewertung, Empfehlungen, Codeänderungen und Validierung in Visual Studio, Visual Studio Code, GitHub Copilot CLI und GitHub.com.

Verwenden Sie diesen Agent, um:

• Aktualisieren Sie Frameworks, Compiler und Abhängigkeiten.
• Modernisieren Sie anwendungsarchitektur und ersetzen Sie Bibliotheken.
• Bewerten Sie den Code, die Konfiguration und die Abhängigkeiten Ihrer Anwendung.
• Überprüfen Sie, ob Ihre App erfolgreich erstellt und getestet wird.

Unterstützte Technologien

Wählen Sie das Technologiepaket aus, das Ihrem Projekt entspricht:

Jedes Technologiepaket kann eigene Szenarien, fokussierte Funktionen, Voraussetzungen und Validierungsprozesse bereitstellen. Zusätzliche Technologiepakete können den Agent erweitern, ohne die gemeinsamen Workflowkonzepte zu ändern.

Scenarios

Der Agent stellt mehrere End-to-End-Modernisierungsworkflows bereit, die als Szenarien bezeichnet werden. Jedes Szenario ist ein verwalteter Workflow, der Sie durch eine bestimmte Art von Upgrade oder Migration führt:

Informationen zu technologiespezifischen Details finden Sie unter .NET Szenarien und Fähigkeiten oder JavaScript- und TypeScript-Funktionen.

Feedback geben

Microsoft wertet Ihr Feedback und verwendet es, um den Agent zu verbessern. Geben Sie Feedback über eine der folgenden Optionen ab:

• Verwenden Sie in Visual Studio die optionen Suggest a feature und Report a problem.

• Melde ein Problem im GitHub-Repository des Upgrade Agent.

Voraussetzungen

Richten Sie GitHub Copilot Upgrade in Ihrer Entwicklungsumgebung ein, bevor Sie den Agent verwenden. Installationsschritte finden Sie unter Installieren GitHub Copilot Upgrades.

Aktualisieren von .NET-Projekten

Der Upgrade-Agent unterstützt das Upgrade von C#- und Visual Basic Projekten der folgenden Typen:

• ASP.NET Core (und verwandte Technologien wie MVC, Razor Pages und Web-API)
• ASP.NET Webformulare
• Blazor
• Azure Functions
• Windows Presentation Foundation (WPF)
• Windows Forms
• WinUI
• .NET MAUI und Xamarin
• Klassenbibliotheken
• Konsolen-Apps
• Testprojekte (MSTest, NUnit und xUnit)

Informationen zum Starten eines Upgrades finden Sie unter Upgrade einer .NET-App mit GitHub Copilot Upgrade.

Unterstützte Upgradepfade

Der Agent unterstützt die folgenden Upgradepfade:

Migrieren von .NET-Projekten zu Azure

Um Ihre .NET Anwendungen zu Azure zu migrieren, verwenden Sie den GitHub Copilot Modernisierungs-Agent. Der Modernisierungs-Agent verarbeitet Azure spezifische Szenarien wie Datenbankmigration, Speicher, Identität, Messaging und Bereitstellung.

Überwachen von Upgrades mit dem Dashboard

Das Upgrade-Dashboard bietet eine visuelle Ansicht einer Upgradesitzung in GitHub Copilot CLI und GitHub Copilot App. Verwenden Sie seine Panels, um den Gesamtfortschritt, Szenarien, Aufgaben, Projekte, Abhängigkeiten, Bewertungsergebnisse, Upgradeoptionen und Agentaktivitäten nachzuverfolgen.

Um das Dashboard zu öffnen, bitten Sie Copilot, es während einer Upgradesitzung anzuzeigen. Das Dashboard ist derzeit in Visual Studio, Visual Studio Code oder anderen IDEs nicht verfügbar. Ausführliche Informationen zu den einzelnen Panels finden Sie unter Überwachen von Upgrades mit dem Upgrade-Dashboard.

So funktioniert es

Informationen zum Starten eines Upgrade- oder Migrationsprozesses finden Sie unter:

1. Starten Sie den Agent mit einer der folgenden Methoden:

   • Visual Studio: Klicken Sie mit der rechten Maustaste auf die Lösung oder das Projekt im Projektmappen-Explorer und wählen Sie Modernize aus. Öffnen Sie alternativ das GitHub-Copilot Chat-Fenster, und geben Sie folgendes ein@Modernize.
   • Visual Studio Code: Öffnen Sie den Bereich GitHub Copilot Chat, und geben Sie @upgrade ein.
   • GitHub Copilot CLI: Geben Sie @upgrade gefolgt von Ihrer Upgrade- oder Migrationsanforderung ein.
   • GitHub-App Copilot: Wählen Sie in der Agentauswahl die Option Upgradeaus.

2. Informieren Sie den Agent, was aktualisiert oder migriert werden soll.

Wenn Sie den Upgrade-Agent bitten, Ihre App zu aktualisieren, fordert Copilot Sie zunächst auf, einen neuen Branch zu erstellen, wenn Sie in einem Git-Repository arbeiten. Anschließend wird Copilot Ihr Projekt bewerten und einen dreistufigen Workflow ausführen. Jede Phase erzeugt Markdown-Dateien unter .github/upgrades/{scenarioId} Ihrem Repository, damit Sie überprüfen können, was als Nächstes kommt, bevor Sie fortfahren. Wenn .github/upgrades/{scenarioId} bereits von einem vorherigen Versuch existiert, fragt Copilot, ob der Vorgang fortgesetzt oder neu gestartet werden soll.

Copilot beginnen, ihre Projektstruktur, Abhängigkeiten und Codemuster zu untersuchen, um eine umfassende Bewertung zu erstellen. Die Datei assessment.md enthält eine Auflistung der grundlegenden Änderungen, Probleme mit der API-Kompatibilität, veraltete Muster sowie den Umfang des Upgrades.

Nach der Bewertung führt Copilot die folgenden drei Phasen aus:

1. Assessment: Copilot untersucht Ihre Projektstruktur, Abhängigkeiten und Codemuster und stellt dann Strategieentscheidungen für Ihre Überprüfung vor, z. B. die Upgradestrategie (bottom-up, top-down oder all-at-once), Projektupgradeansatz, Technologiemodernisierungsoptionen und Kompatibilitätsbehandlung. Copilot speichert bestätigte Entscheidungen in upgrade-options.md.

2. Planning: Copilot konvertiert die Bewertung und Ihre bestätigten Optionen in eine detaillierte Spezifikation. Die plan.md Datei dokumentiert Upgradestrategien, Umgestaltungsansätze, Abhängigkeitspfade und Risikominderungen.

3. Execution: Copilot teilt den Plan in sequentielle, konkrete Aufgaben mit Validierungskriterien in tasks.md. Jeder Vorgang beschreibt eine einzelne Änderung und wie Copilot bestätigt, dass er erfolgreich war.

Bearbeiten Sie eine der Markdown-Dateien in .github/upgrades/{scenarioId}, um die Upgradeschritte anzupassen oder Kontext hinzuzufügen, bevor Sie fortfahren.

Upgrade-Strategien

Während der Bewertungsphase bewertet der Agent Ihre Lösung und empfiehlt eine der folgenden Strategien:

Flussmodus

Der Agent unterstützt zwei Flussmodi, die steuern, wie lange er für Ihre Eingabe pausiert.

• Automatisch: Der Agent arbeitet durch alle Phasen, ohne zu pausieren und nur bei echten Blockern zu stoppen. Am besten geeignet für erfahrene Benutzer und einfache Upgrades.
• Geführt: Der Agent hält an jeder Abschnittsgrenze an, damit Sie die Bewertung, den Plan und die Aufgaben überprüfen können, bevor Sie fortfahren. Optimal für Erstmalige Benutzer und komplexe Lösungen.

Wechseln Sie jederzeit zwischen den Modi, indem Sie "Pause" (um in den geführten Modus zu wechseln) oder "Weiter" (um in den automatischen Modus zu wechseln) sagen.

Zustandsverwaltung

Der Agent speichert den gesamten Upgradestatus in .github/upgrades/{scenarioId}/. Der Ordner enthält:

Da sich der gesamte Zustand in diesem Ordner befindet, können Sie Ihre IDE schließen, zwischen Sitzungen wechseln oder sogar zwischen Entwicklungsumgebungen wechseln (z. B. in VS Code starten und in Visual Studio fortfahren). Der Agent nimmt an der Stelle auf, an der er aufgehört hat.

Durchführen des Upgrades

Überprüfen und ändern Sie nach Abschluss jeder Phase die generierten Dateien nach Bedarf, und teilen Sie dann Copilot mit, die nächste Phase fortzusetzen.

Wenn Sie die Phase Execution erreichen, teilen Sie Copilot mit, das Upgrade zu starten. Wenn Copilot ein Problem aufweist, versucht er, die Ursache zu identifizieren und einen Fix anzuwenden. Wenn Copilot das Problem nicht beheben kann, fordert er Ihre Hilfe auf. Wenn Sie eingreifen, lernt Copilot von den änderungen, die Sie vornehmen, und versucht, sie automatisch anzuwenden, wenn das Problem erneut auftritt.

Ergebnisse des Upgrades

Wenn Copilot jede Aufgabe ausführt, aktualisiert sie die Datei tasks.md in .github/upgrades/{scenarioId} mit dem Status jedes Schritts. Überwachen Sie den Fortschritt, indem Sie diese Datei überprüfen. Copilot erstellt einen Git-Commit für jeden Teil des Prozesses, sodass Sie Änderungen zurücksetzen oder überprüfen können, was geändert wurde.

Nach Abschluss des Upgrades zeigt Copilot die nächsten Schritte in der Chatantwort an.

Telemetry

Das Tool sammelt Daten zu Projekttypen, Absicht zum Upgrade und Upgradedauer. Die Entwicklungsumgebung sammelt und aggregiert die Daten und enthält keine benutzeridentifizierbaren Informationen. Weitere Informationen zu den Datenschutzrichtlinien von Microsoft finden Sie im Programm zur Verbesserung der Benutzerfreundlichkeit von Visual Studio.

Verwandte Inhalte

• GitHub Copilot-Upgrade installieren
• Upgrade einer .NET-App mit GitHub Copilot Upgrade
• Überwachen von Upgrades mit dem Upgrade-Dashboard
• Kernkonzepte
• .NET Szenarien und Fähigkeiten
• Bewährte Methoden
• Problembehandlung für das GitHub Copilot-Upgrade
• häufig gestellte Fragen zum Upgrade GitHub Copilot