Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
peningkatan GitHub Copilot adalah agen GitHub Copilot yang membantu Anda meningkatkan proyek ke versi .NET yang lebih baru dengan cepat dan percaya diri. Ini memandu Anda melalui penilaian, rekomendasi solusi, perbaikan kode, dan validasi di Visual Studio, Visual Studio Code, GitHub Copilot CLI, dan GitHub.com.
Gunakan agen ini untuk:
- Tingkatkan ke versi .NET yang lebih baru.
- Modernisasi aplikasi .NET Anda, terutama ketika meningkatkannya dari .NET Framework.
- Menilai kode, konfigurasi, dan dependensi aplikasi Anda.
- Validasi bahwa aplikasi Anda berhasil dibuat dan diuji.
Scenarios
Agen menyediakan beberapa alur kerja modernisasi end-to-end yang disebut skenario. Setiap skenario adalah alur kerja terkelola yang memandu Anda melalui jenis peningkatan atau migrasi tertentu:
| Scenario | Deskripsi | Contoh tanggapan |
|---|---|---|
| peningkatan versi .NET | Peningkatan dari versi .NET yang lebih lama ke .NET 8, 9, 10, atau yang lebih baru. | "Tingkatkan solusi saya ke .NET 10" |
| Konversi gaya SDK | Mengonversi format proyek warisan ke gaya SDK. | "Konversi ke gaya SDK" |
| Peningkatan Newtonsoft.Json | Mengganti Newtonsoft.Json dengan System.Text.Json. | "Memperbarui dari Newtonsoft.Json" |
| Peningkatan SqlClient | Peningkatan dari System.Data.SqlClient ke Microsoft. Data.SqlClient. | "Perbarui SqlClient" |
| peningkatan Azure Functions | Meningkatkan Azure Functions dari dalam proses ke model pekerja yang terisolasi. | "Tingkatkan Azure Functions saya" |
| Kernel Semantik untuk Agen | Meningkatkan Agen Kernel Semantik ke Kerangka Kerja Agen Microsoft. | "Tingkatkan agen SK saya" |
| Aspire integrasi | Aspire Menambahkan dukungan untuk penyebaran inner-loop dan Azure. | "Tambahkan Aspire ke aplikasi saya" |
| Aspire peningkatan versi | Meningkatkan Aspire aplikasi yang sudah ada ke versi yang lebih baru. | "Tingkatkan versi saya Aspire " |
| Peningkatan dari WebForms ke Blazor | Meningkatkan aplikasi ASP.NET Web Form ke Blazor. | "Migrasikan aplikasi Formulir Web saya ke Blazor" |
Untuk referensi lengkap semua skenario dan 30+ keterampilan peningkatan yang sudah terpasang, lihat Skenario dan referensi keterampilan.
Berikan tanggapan
Microsoft nilai umpan balik Anda dan menggunakannya untuk meningkatkan agen. Tinggalkan umpan balik menggunakan salah satu opsi ini:
Di Visual Studio, gunakan fitur Suggest dan Laporkan masalah opsi.
Ajukan masalah di repositori GitHub Agen Peningkatan.
Prasyarat
Siapkan peningkatan GitHub Copilot di lingkungan pengembangan Anda sebelum menggunakan agen. Untuk langkah-langkah penginstalan, lihat Menginstal peningkatan GitHub Copilot.
Meningkatkan proyek .NET
Agen peningkatan mendukung peningkatan C# dan proyek Visual Basic dari jenis berikut:
- ASP.NET Core (dan teknologi terkait seperti MVC, Razor Pages, dan Web API)
- ASP.NET Web Form
- Blazor
- Azure Functions
- Windows Presentation Foundation (WPF)
- Formulir Windows
- WinUI
- .NET MAUI dan Xamarin
- Pustaka kelas
- Aplikasi konsol
- Proyek pengujian (MSTest, NUnit, dan xUnit)
Untuk memulai peningkatan, lihat Meningkatkan aplikasi .NET dengan peningkatan GitHub Copilot.
Jalur peningkatan yang didukung
Agen mendukung jalur peningkatan berikut:
| Source | Target |
|---|---|
| .NET Framework (versi apa pun) | .NET 8 atau yang lebih baru |
| .NET Framework (versi apa pun) | .NET Framework 4.8.1 |
| .NET Core 1.x–3.x | .NET 8 atau yang lebih baru |
| .NET 5 atau yang lebih baru | .NET 8 atau yang lebih baru |
Memigrasikan proyek .NET ke Azure
Untuk memigrasikan aplikasi .NET Anda ke Azure, gunakan agen modernisasi GitHub Copilot. Agen modernisasi menangani skenario khusus Azure seperti migrasi database, penyimpanan, identitas, olahpesan, dan penyebaran.
Memantau peningkatan dengan dasbor
Dasbor Peningkatan menyediakan tampilan visual sesi peningkatan di GitHub Copilot CLI dan aplikasi GitHub Copilot. Gunakan panelnya untuk melacak kemajuan, skenario, tugas, proyek, dependensi, hasil penilaian, opsi peningkatan, dan aktivitas agen secara keseluruhan.
Untuk membuka dasbor, minta Copilot untuk menampilkannya selama sesi peningkatan. Dasbor saat ini tidak tersedia di Visual Studio, Visual Studio Code, atau ID Lainnya. Untuk detail tentang setiap panel, lihat Memantau peningkatan dengan Dasbor Peningkatan.
Cara kerjanya
Untuk memulai proses peningkatan atau migrasi, lihat:
Mulai agen dengan menggunakan salah satu metode ini:
-
Visual Studio: Klik kanan solusi atau proyek di Penjelajah Solusi dan pilih Modernize. Atau, buka jendela Copilot Chat GitHub dan ketik
@Modernize. -
Visual Studio Code: Buka panel GitHub Copilot Chat dan ketik
@upgrade. -
GitHub Copilot CLI: Ketik
@upgradediikuti oleh permintaan peningkatan atau migrasi Anda. -
GitHub aplikasi Copilot: Di pemilih Agen, pilih
Upgrade.
-
Visual Studio: Klik kanan solusi atau proyek di Penjelajah Solusi dan pilih Modernize. Atau, buka jendela Copilot Chat GitHub dan ketik
Beritahu agen apa yang harus ditingkatkan atau dimigrasikan.
Saat Anda meminta agen peningkatan untuk meningkatkan aplikasi, Copilot terlebih dahulu meminta Anda untuk membuat cabang baru jika Anda bekerja di repositori Git. Kemudian Copilot menilai proyek Anda dan menjalankan alur kerja tiga tahap. Setiap tahap menghasilkan file Markdown di bawah .github/upgrades/{scenarioId} repositori Anda sehingga Anda dapat meninjau apa yang akan datang berikutnya sebelum melanjutkan. Jika .github/upgrades/{scenarioId} sudah ada dari upaya sebelumnya, Copilot bertanya apakah akan melanjutkan atau memulai dari awal.
Copilot dimulai dengan memeriksa struktur proyek, dependensi, dan pola kode Anda untuk membangun penilaian komprehensif. File assessment.md mencantumkan perubahan yang merusak, masalah kompatibilitas API, pola yang tidak direkomendasikan lagi, dan cakupan peningkatan.
Setelah penilaian, Copilot menjalankan tiga tahap berikut:
Assessment: Copilot memeriksa struktur proyek, dependensi, dan pola kode Anda, lalu menyajikan keputusan strategi untuk tinjauan Anda, seperti strategi peningkatan (bottom-up, top-down, atau all-at-once), pendekatan peningkatan proyek, opsi modernisasi teknologi, dan penanganan kompatibilitas. Copilot menyimpan keputusan yang dikonfirmasi ke
upgrade-options.md.Planning: Copilot mengonversi penilaian dan opsi yang dikonfirmasi menjadi spesifikasi terperinci. Dokumen file strategi peningkatan, pendekatan refaktorisasi, jalur dependensi, dan mitigasi risiko.
Execution: Copilot memecah rencana menjadi tugas konkret berurutan dengan kriteria validasi di
tasks.md. Setiap tugas menjelaskan satu perubahan dan bagaimana Copilot mengonfirmasinya berhasil.
Edit salah satu file Markdown di .github/upgrades/{scenarioId} untuk menyesuaikan langkah-langkah peningkatan atau menambahkan konteks sebelum Anda maju.
Meningkatkan strategi
Selama tahap penilaian, agen mengevaluasi solusi Anda dan merekomendasikan salah satu strategi ini:
| Strategy | Paling cocok untuk | Deskripsi |
|---|---|---|
| Bawah ke atas | Solusi besar dengan grafik dependensi mendalam | Meningkatkan proyek tingkat bawah terlebih dahulu, lalu bekerja ke atas. |
| Atas ke bawah | Umpan balik cepat tentang aplikasi utama | Meningkatkan proyek aplikasi terlebih dahulu, lalu memperbaiki dependensi. |
| All-at-once | Solusi kecil dan sederhana | Meningkatkan semua proyek dalam satu putaran. |
Mode jalur
Agen mendukung dua mode alur yang mengontrol berapa banyak jeda untuk input Anda:
- Otomatis: Agen bekerja melalui semua tahap tanpa menjeda, berhenti hanya pada pemblokir asli. Terbaik untuk pengguna berpengalaman dan melakukan peningkatan yang sederhana.
- Dipandu: Agen berhenti sejenak di setiap batas tahap sehingga Anda dapat meninjau penilaian, rencana, dan tugas sebelum melanjutkan. Terbaik untuk pengguna pertama kali dan solusi kompleks.
Beralih antar mode kapan saja dengan mengatakan "jeda" (untuk memasuki mode terpandu) atau "lanjutkan" (untuk memasuki mode otomatis).
Manajemen status
Agen menyimpan semua status peningkatan di .github/upgrades/{scenarioId}/. Folder berisi:
| File | Kegunaan |
|---|---|
assessment.md |
Analisis solusi Anda |
upgrade-options.md |
Keputusan peningkatan yang dikonfirmasi |
plan.md |
Rencana tugas yang diurutkan |
tasks.md |
Dasbor kemajuan langsung |
scenario-instructions.md |
Memori persisten agen, termasuk preferensi, keputusan, dan instruksi kustom |
tasks/{taskId}/task.md |
Cakupan dan konteks per tugas |
tasks/{taskId}/progress-details.md |
Catatan dan hasil eksekusi per tugas |
Karena semua status berada di folder ini, Anda dapat menutup IDE Anda, beralih antar sesi, atau bahkan beralih antar lingkungan pengembangan (misalnya, mulai di Visual Studio Code dan melanjutkan di Visual Studio). Agen melanjutkan dari titik terakhirnya.
Tip
Terapkan .github/upgrades/ folder ke cabang Anda. Status berkomitmen berfungsi sebagai cadangan dan memungkinkan anggota tim melihat kemajuan peningkatan.
Lakukan peningkatan
Setelah setiap tahap selesai, tinjau dan ubah file yang dihasilkan sesuai kebutuhan, lalu beri tahu Copilot untuk melanjutkan ke tahap berikutnya.
Ketika Anda mencapai tahap Execution, beri tahu Copilot untuk memulai peningkatan. Jika Copilot mengalami masalah, Copilot mencoba mengidentifikasi penyebabnya dan menerapkan perbaikan. Jika Copilot tidak dapat memperbaiki masalah, Copilot meminta bantuan Anda. Saat Anda melakukan intervensi, Copilot belajar dari perubahan yang Anda buat dan mencoba menerapkannya secara otomatis jika masalah muncul lagi.
Peningkatan hasil
Saat Copilot menjalankan setiap tugas, ia memperbarui file tasks.md di .github/upgrades/{scenarioId} dengan status dari setiap langkah. Pantau kemajuan dengan meninjau file ini. Copilot membuat commit Git untuk setiap bagian proses, sehingga Anda dapat membatalkan perubahan atau meninjau perubahan.
Setelah peningkatan selesai, Copilot menampilkan langkah berikutnya dalam respons obrolan.
Telemetri
Alat ini mengumpulkan data tentang jenis proyek, niat untuk meningkatkan, dan meningkatkan durasi. Lingkungan pengembangan mengumpulkan dan menggabungkan data dan tidak berisi informasi yang dapat diidentifikasi pengguna. Untuk informasi selengkapnya tentang kebijakan privasi Microsoft, lihat Program Peningkatan Pengalaman Pelanggan Visual Studio.