Co je upgrade GitHub Copilot?

GitHub Copilot upgrade je agent GitHub Copilot, který pomáhá upgradovat projekty na novější verze .NET rychle a bez obav. Provede vás posouzením, doporučeními k řešení, opravami kódu a ověřováním napříč Visual Studio, Visual Studio Code, rozhraním příkazového řádku GitHub Copilot a GitHub.com.

Tento agent použijte k:

  • Upgradujte na novější verzi .NET.
  • Modernizujte aplikaci .NET, zejména při upgradu z rozhraní .NET Framework.
  • Vyhodnoťte kód, konfiguraci a závislosti aplikace.
  • Ověřte, že se vaše aplikace úspěšně sestaví a testuje.

Scenarios

Agent poskytuje několik komplexních pracovních postupů modernizace označovaných jako scénáře. Každý scénář je spravovaný pracovní postup, který vás provede konkrétním typem upgradu nebo migrace:

Scénář Description Příklad výzvy
aktualizace verze .NET Upgraduje ze starších verzí .NET na .NET 8, 9, 10 nebo novější. Aktualizujte moje řešení na .NET 10
Převod stylu sady SDK Převede starší formát projektu na styl sady SDK. "Převést na styl sady SDK"
Aktualizace Newtonsoft.Json Nahradí Newtonsoft.Json System.Text.Json. Aktualizace z Newtonsoft.Json
Upgrade SqlClient Upgraduje z System.Data.SqlClient na Microsoft. Data.SqlClient. "Aktualizace SqlClient"
Aktualizace Azure Functions Upgraduje Azure Functions z procesu na izolovaný pracovní model. Aktualizovat moje Azure Functions
Sémantické jádro k agentům Upgraduje agenty Sémantické jádro na Microsoft Agent Framework. Upgrade agentů SK
Integrace Aspire Přidává Aspire podporu pro inner-loop a nasazení do Azure. "Přidat Aspire do aplikace"
Aspire aktualizace verze Upgraduje existující Aspire aplikace na novější verze. Upgradovat moji Aspire verzi
Upgrade WebForms-to-Blazor Upgraduje aplikace ASP.NET Web Forms na Blazor. Migrace aplikace Web Forms do Blazoru

Úplný přehled všech scénářů a 30 integrovaných dovedností upgradu najdete v referenčních informacích ke scénářům a dovednostem.

Poskytnout zpětnou vazbu

Microsoft hodnotí vaši zpětnou vazbu a používá ji ke zlepšení agenta. Napište nám svůj názor pomocí některé z těchto možností:

Předpoklady

Před použitím agenta nastavte GitHub Copilot upgrade ve vývojovém prostředí. Postup instalace najdete v tématu Instalace GitHub Copilot upgradu.

Aktualizujte projekty .NET

Agent upgradu podporuje upgrade projektů C# a Visual Basic následujících typů:

  • ASP.NET Core (a související technologie, jako jsou MVC, Razor Pages a webové rozhraní API)
  • ASP.NET Web Forms
  • Blazor
  • Azure Functions
  • Windows Presentation Foundation (WPF (Windows Presentation Foundation))
  • model model Windows Forms
  • WinUI
  • .NET MAUI a Xamarin
  • Knihovny tříd
  • Konzolové aplikace
  • Projekty testů (MSTest, NUnit a xUnit)

Pokud chcete spustit upgrade, přečtěte si téma Upgrade aplikace .NET s GitHub Copilot upgradem.

Podporované cesty upgradů

Agent podporuje následující cesty upgradu:

Source Target
.NET Framework (libovolná verze) .NET 8 nebo novější
.NET Framework (libovolná verze) .NET Framework 4.8.1
.NET Core 1.x–3.x .NET 8 nebo novější
.NET 5 nebo novější .NET 8 nebo novější

Migrace projektů .NET do Azure

Pokud chcete migrovat .NET aplikace do Azure, použijte agenta modernizace GitHub Copilot. Agent modernizace zpracovává Azure konkrétní scénáře, jako je migrace databáze, úložiště, identita, zasílání zpráv a nasazení.

Monitorování upgradů pomocí řídicího panelu

Řídicí panel upgradu poskytuje vizuální zobrazení relace upgradu v GitHub Copilot rozhraní příkazového řádku a GitHub Copilot aplikaci. Pomocí jejích panelů můžete sledovat celkový průběh, scénáře, úkoly, projekty, závislosti, výsledky posouzení, možnosti upgradu a aktivitu agenta.

Pokud chcete řídicí panel otevřít, požádejte Copilot, aby ho zobrazil během relace upgradu. Řídicí panel není momentálně k dispozici v Visual Studio, Visual Studio Code nebo jiných prostředích ID. Podrobnosti o jednotlivých panelech najdete v tématu Monitorování upgradů pomocí řídicího panelu upgradu.

Jak to funguje

Postup spuštění upgradu nebo migrace najdete v tématu:

  1. Spusťte agenta některou z těchto metod:

    • Visual Studio: Klikněte pravým tlačítkem na řešení nebo projekt v Průzkumník řešení a vyberte Modernize. Případně otevřete okno Copilot Chat GitHubu a zadejte @Modernize.
    • Visual Studio Code: Otevřete panel GitHub Copilot Chat a zadejte @upgrade.
    • GitHub Copilot CLI: Zadejte @upgrade a potom požadavek na upgrade nebo migraci.
    • GitHub aplikace Copilot: Ve výběru agenta vyberte Upgrade.

  2. Sdělete agentovi, co chcete upgradovat nebo migrovat.

Když se zeptáte agenta upgradu na upgrade aplikace, Copilot vás nejdřív vyzve k vytvoření nové větve, pokud pracujete v úložišti Git. Pak Copilot vyhodnocuje váš projekt a spouští třífázový pracovní postup. Každá fáze vytvoří soubory .github/upgrades/{scenarioId} Markdownu ve vašem úložišti, abyste si mohli před pokračováním prohlédnout, co se stane dál. Pokud .github/upgrades/{scenarioId} již existuje z předchozího pokusu, Copilot se zeptá, jestli chcete pokračovat nebo začít znovu.

Copilot začne zkoumáním struktury projektu, závislostí a vzorů kódu a sestavením komplexního posouzení. Soubor assessment.md obsahuje seznam zásadních změn, problémy s kompatibilitou rozhraní API, zastaralé vzory a obor upgradu.

Po posouzení Copilot spustí následující tři fáze:

  1. Assessment: Copilot prozkoumá strukturu projektu, závislosti a vzory kódu a následně prezentuje rozhodnutí o strategii kontroly, jako je strategie upgradu (shora nahoru, shora dolů nebo vše najednou), přístup k upgradu projektu, možnosti modernizace technologií a zpracování kompatibility. Copilot uloží potvrzená rozhodnutí do upgrade-options.md.

  2. Planning: Copilot převede posouzení a potvrzené možnosti na podrobnou specifikaci. Soubory plan.md dokumentují strategie upgradu, přístupy refaktoringu, cesty závislostí a zmírnění rizik.

  3. Execution: Copilot rozdělí plán na postupné konkrétní úkoly s ověřovacími kritérii v tasks.md. Každý úkol popisuje jednu změnu a způsob, jakým copilot potvrdí, že byla úspěšná.

Upravte libovolný soubor Markdownu .github/upgrades/{scenarioId} a upravte kroky upgradu nebo přidejte kontext před tím, než přejdete vpřed.

Strategie upgradu

Během fáze posouzení agent vyhodnotí vaše řešení a doporučí jednu z těchto strategií:

Strategy Nejlepší pro Description
Zdola nahoru Rozsáhlá řešení s hlubokými grafy závislostí Nejprve upgraduje koncové projekty, pak pokračuje směrem nahoru.
Shora dolů Rychlá zpětná vazba k hlavní aplikaci Nejprve upgraduje projekt aplikace a pak opraví závislosti.
Vše najednou Malá, jednoduchá řešení Aktualizuje všechny projekty najednou.

Režimy toku

Agent podporuje dva režimy průběhu procesů, které řídí, jak často se pozastaví pro vaši zpětnou vazbu.

  • Automatické: Agent funguje ve všech fázích bez pozastavení a zastavuje se pouze na pravých blokovačích. Nejvhodnější pro zkušené uživatele a jednoduché upgrady.
  • Vedené: Agent se pozastaví na jednotlivých hranicích fáze, abyste mohli před pokračováním zkontrolovat hodnocení, plán a úkoly. Nejvhodnější pro první uživatele a složitá řešení.

Mezi režimy můžete kdykoli přepínat tak, že řeknete "pozastavit" (pro vstup do režimu s asistencí) nebo "pokračovat" (pokud chcete přejít do automatického režimu).

Správa stavu

Agent ukládá veškerý stav upgradu do .github/upgrades/{scenarioId}/. Složka obsahuje:

Soubor Purpose
assessment.md Analýza vašeho řešení
upgrade-options.md Potvrzená rozhodnutí o upgradu
plan.md Uspořádaný plán úkolů
tasks.md Řídicí panel aktuálního průběhu
scenario-instructions.md Trvalá paměť agenta, včetně předvoleb, rozhodnutí a vlastních pokynů
tasks/{taskId}/task.md Rozsah a kontext pro jednotlivé úkoly
tasks/{taskId}/progress-details.md Poznámky ke spuštění jednotlivých úkolů a výsledky

Protože jsou všechny stavy uloženy v této složce, můžete zavřít IDE, přecházet mezi relacemi nebo dokonce přepínat mezi vývojovými prostředími (například začít ve VS Code a pokračovat ve Visual Studiu). Agent se zvedne tam, kde to skončilo.

Tip

Potvrďte složku .github/upgrades/ do své větve. Záložní stav slouží jako záloha a umožňuje členům týmu zobrazit průběh aktualizace.

Provedení upgradu

Po dokončení každé fáze zkontrolujte a upravte vygenerované soubory podle potřeby a pak řekněte Copilot, aby pokračovali v další fázi.

Jakmile se dostanete do fáze Execution, sdělte Copilot, že chcete spustit upgrade. Pokud Copilot narazí na problém, pokusí se identifikovat příčinu a použít opravu. Pokud Copilot problém nedokáže opravit, požádá o pomoc. Když dojde k zásahu, Copilot se naučí od provedených změn a pokusí se je automaticky použít, pokud se problém objeví znovu.

Výsledky aktualizace

Když Copilot spouští jednotlivé úlohy, aktualizuje tasks.md soubor v .github/upgrades/{scenarioId} se stavem každého kroku. Monitorujte průběh kontrolováním tohoto souboru. Copilot vytvoří potvrzení Gitu pro každou část procesu, takže můžete vrátit změny zpět nebo zkontrolovat, co se změnilo.

Po dokončení upgradu Copilot v odpovědi chatu zobrazí další kroky.

Telemetry

Nástroj shromažďuje data o typech projektů, záměru upgradovat a dobu trvání upgradu. Vývojové prostředí shromažďuje a agreguje data a neobsahuje žádné identifikovatelné informace uživatele. Pro další informace o zásadách ochrany osobních údajů společnosti Microsoft si přečtěte Visual Studio Customer Experience Improvement Program.

Související obsah

  • Last updated on