GitHub Copilot aracı modunu kullanmaya başlama

Visual Studio'da GitHub Copilot aracı moduyla, üst düzey bir görev belirtmek için doğal dil kullanabilirsiniz. Yapay zeka bir plan oluşturur, kod düzenlemeleri yapar, terminal komutlarını çalıştırır, araçları çağırır ve değişiklikleri kod tabanınıza uygular. İnşa sonuçları, birim testi hataları veya araç çıktıları gibi sonuçları izler ve gereklilik halinde süreçte yeniden döngüye girer.

Sorma modundan farklı olarak, aracı modu tek bir yanıttan sonra durmaz. Hedefe ulaşana kadar adımlar çalıştırılmaya ve iyileştirilmeye devam edilir, aksi takdirde daha fazla giriş gereklidir.

Prerequisites

Visual Studio 2022 sürüm 17.14 veya üzeri gerekir.

Aracı modunu kullanma

Aracı modunda Copilot otonom olarak çalışır ve isteminiz için ilgili bağlamı belirler.

Başlamak için şu adımları izleyin:

1. Copilot Sohbet penceresini açın, modu genişletmek için Ask'i seçin ve ardından Agent'ı seçin.

2. İstemi girin ve gönder'i seçin veya göndermek için Enter tuşunu seçin. Üst düzey bir gereksinim belirtebilirsiniz ve üzerinde çalışılacak dosyaları belirtmeniz gerekmez.

3. Aracı modu, farklı görevleri gerçekleştirmek için birden çok araç çağırabilir. İsteğe bağlı olarak, aracının isteğinize yanıt vermek için hangi ek araçları kullanabileceğini yapılandırmak için Araçlar simgesini seçin.

Aracı modunun kullandığı ek araçları gösteren ekran görüntüsü.

4. Copilot, bir terminal komutu çalıştırmadan veya yerleşik olmayan bir araç kullanmadan önce onay ister.

Aracı onayı komutlarını gösteren ekran görüntüsü.

5. Copilot, kod düzenlemelerindeki veya terminal komutlarındaki sorunları otomatik olarak algılar ve ardından işlem uygular. Sorunlar çözülene kadar işlem yinelenir.

6. Copilot isteğinizi işlerken, önerilen kod düzenlemelerini doğrudan düzenleyicide akışa alır. Önerilen düzenlemeleri gözden geçirin ve aşağıdakilerden birini seçin:

   • Sohbet penceresindeki Toplam değişiklikler bölümünde önerilen düzenlemeleri bir bütün olarak tutun veya atın.

Önerilen düzenlemelerin listesini gösteren ekran görüntüsü.

• Tek tek dosya farklarını gözden geçirin ve bunları seçmeli olarak uygulayın.

7. Agent tarafından yapılan tek tek kod değişikliklerini incelemek istiyorsanız, her adımda belirli değişiklikleri inceleyebilirsiniz.

8. Düzenlemeleri iyileştirmek veya daha fazla özellik uygulamak için kod değişikliklerini yinelemeye devam edin.

Aracı modu araçlarını anlama

Aracı modu, bir isteği yanıtlamak için aşağıdaki araçları kullanabilir:

• Gömülü araçlar
• Model Bağlam Protokolü (MCP) araçları

Tip

Visual Studio ayrıca belirli IDE özellikleriyle tümleşen @debug, @profiler, @test ve @vs gibi yerleşik aracıları içerir. Ekip iş akışlarınız için özel aracılar da oluşturabilirsiniz. Daha fazla bilgi için bakınız GitHub Copilot'ta özel aracılar kullanma.

Aracı modunda kullanılabilen araçları görüntülemek ve yönetmek için sohbet penceresinde Araçlar simgesini seçin.

Bir aracın sonucuna bağlı olarak, Copilot genel isteği gerçekleştirmek için diğer araçları çağırabilir. Örneğin, bir kod düzenlemesi dosyada söz dizimi hatalarıyla sonuçlanırsa, Copilot başka bir yaklaşımı inceleyip farklı kod değişiklikleri önerebilir.

MCP sunucularını çalıştırarak eklediğiniz ek araçlar otomatik olarak etkinleştirilmez. Onay kutuları varsayılan olarak temizlenir ve araçları etkinleştirmek için bunları seçmeniz gerekir.

Araç onaylarını yönetme

Copilot bir aracı çağırdığında, aracı çalıştırmak için onay isteğinde bulunur. Bunun nedeni, araçların makinenizde yerel olarak çalışabilmesi ve dosyaları veya verileri değiştiren eylemler gerçekleştirmesidir.

Araç onay isteğini gösteren ekran görüntüsü.

Bir araç çağrısı yapıldıktan sonra, sohbet penceresinde, geçerli oturum veya çözüm için belirli bir aracı ya da gelecekteki tüm araç çağrılarını otomatik olarak onaylamak üzere İzin Ver açılır listesini kullanın.

Araç onayı seçimlerini AraçlarSeçenekleri bölmesinde sıfırlayabilirsiniz. Tüm Ayarlar>GitHub>Copilot>Tools bölümünü genişletin.

Visual Studio'da GitHub Copilot araç çağrı ayarlarını gösteren ekran görüntüsü.

Düzenlemeleri kabul etme veya atma

Copilot, düzenlenen dosyaları sohbet penceresindeki Toplam değişiklikleri listesinde listeler.

Düzenlenen dosyaların listesini gösteren ekran görüntüsü.

Değişiklikleri tek tek gözden geçirmek için her dosyayı seçin. Her kod öbeklerinde yapılan düzenlemeleri tutabilir veya geri alabilirsiniz.

Alternatif olarak, Toplam değişiklik listesinde, En son Koru veya Geri Al'ı seçtiğinizden bu yana yapılan tüm düzenlemeler için Koru veya Geri Al'ı seçin.

Düzenlemeleri geri döndürme

Kod düzenleme isteğinde bulunurken bazı değişiklikleri geri almak isteyebilirsiniz. Geri dönmek için, istemediğiniz değişiklikleri içeren istemden önce denetim noktasının yanındaki Geri Yükle'yi seçin.

Düzenlemeleri geri alma işlemini gösteren ekran görüntüsü.

Şu anda Visual Studio Copilot aracısı adım adım geri almayı veya yinelemeyi desteklemez.

Aracı modu isteğini kes

Devam eden bir isteği kesmek için iptal edebilirsiniz. bir isteği iptal etmek tüm çalışan araçları ve terminal komutlarını durdurur.

Derlemeyi durdurmak için üst araç çubuğundan Oluştur'u ve ardından İptal'i seçin. Alternatif olarak Ctrl+Break klavye kısayolunu da kullanabilirsiniz.

Aracı modunda planlama (Önizleme)

Uyarı

Planlama, Visual Studio 2022 sürüm 17.14 ile genel önizlemede kullanılabilir. Bu özellik etkin geliştirme aşamasındadır ve kullanıcı geri bildirimlerine göre gelişebilir.

Aracı modunda Planning Copilot karmaşık veya çok adımlı istekleri yürütmeden önce yapılandırılmış, izlenebilir görevlere ayırmasına olanak tanır.

Planlama etkin olduğunda Copilot:

• Hedefleri ve ilerlemeyi özetleyen, kullanıcıya yönelik bir markdown planı oluşturur.
• İç JSON planı (), adım izleme, akıl yürütme ve koordinasyon için LLM tarafından okunabilir bir geçici not defteri olarak hizmet verir.

Bu yapı Copilot tutarlı kalmasına, planını dinamik olarak güncelleştirmesine ve geliştiricilere yaptıklarına görünürlük sağlamaya yardımcı olur.

Nasıl çalışır?

İstek analizi

Bir görev birden çok adım gerektirdiğinde, Copilot planlama moduna girer.

Plan oluşturma

• Markdown planı: Görevi, adımları ve ilerleme durumunu okunabilir bir biçimde açıklar.
• JSON planı: Aynı planı makine ayrıştırılabilir biçiminde yakalayan yapılandırılmış, LLM tarafından okunabilir bir biçim. Bu JSON dosyası, Copilot planı sırayla tutarlı bir şekilde güncelleştirmesine ve yorumlamasına olanak tanır.

Yürütme ve yineleme

Copilot, devam ederken her iki dosyayı da güncelleştirerek plandaki her adımı yürütür.

• Markdown planı düzenleyicide görünür bir şekilde güncelleştirilir.
• Copilot adımları iyileştirip, yeniden sıralayıp veya uyarladıkça JSON planı perde arkasında gelişir.

Depolama

Her iki dosya da içinde depolanır.

Planlamada kullanılan araçlar

Planlama'yı etkinleştirdiğinizde, ayrılmış bir iç araç kümesi etkin hale gelir. Bu araçlar Copilot yürütme sırasında planları nasıl oluşturduğunu, güncelleştirip sonlandırduğunu koordine eder.

Tool	Description
plan	Kullanıcı isteğinden ilk yapılandırılmış planı oluşturur.
uyum_planı	Yeni bağlam veya geri dönüşe göre planı düzeltir veya ayarlar.
güncelleme_planı_ilerlemesi	Adım tamamlama durumunu güncelleştirir ve plan durumunu eşitler.
gözlemi_kaydet	Sonraki eylemleri etkileyen çalışma zamanı sonuçlarını veya içgörülerini yakalar.
finish_plan	Tüm adımlar tamamlandığında planı sonlandırır.

Bu araçlar, Copilot çok adımlı iş akışlarını artımlı olarak yönetmesini, yürütme durumunu korumasını ve kullanıcı amacına uygun kalmasını sağlar.

Planlama araçlarını etkinleştirme ve yönetme

Planlamayı etkinleştirmek için:

1. Tools>Options bölmesini açın, ve Tüm Ayarlar>GitHub>Copilot>Copilot Sohbet bölümünü genişletin.

2. Planlamayı Etkinleştir onay kutusunu seçin.

Planlamayı etkinleştirdikten sonra Planlama araçları sohbet penceresindeki Araçlar listesinde görünür:

Aracı modunda tüm alt araçların etkinleştirildiği Planlama araçları grubunu gösteren ekran görüntüsü.

Planlama aracı kümesini doğrudan sohbet penceresindeki Araçlar listesinden seçerek devre dışı bırakabilirsiniz. Planlama araçlarını devre dışı bırakmanız gerekiyorsa, yalnızca birini değil tümünü devre dışı bırakmanızı öneririz. Değişiklikler geçerli sohbet oturumunuza hemen uygulanır.

Tip

Tek tek araçları devre dışı bırakmak, farklı planlama davranışlarıyla denemeler yapmanızı veya geliştirme sırasında belirli adımlarda hata ayıklamanızı sağlar.

Sınırlamalar

• Planlar, el ile kaydedilmediği sürece oturum sona erdiğinde geçici olarak depolanır ve silinir.
• Yapılandırılmış durum izleme nedeniyle hafif gecikme süresi yükü vardır.
• Bazı özel aracılar planlamayı henüz desteklemiyor olabilir.

Görüş bildirin

Aracı modunda planlamayı etkin bir şekilde geliştiriyoruz. Geri bildiriminizi paylaşın, sorun bildirin veya iyileştirme önerin: Copilot Sohbette Planlama – Visual Studio Geliştirici Topluluğu

Sıkça sorulan sorular

Aracı modu dosyalarımda hangi görünürlüğe sahip?

Aracı modu yalnızca şu verileri işleyebilir:

• Çözümün parçası olan yerel dosyalar.
• Açık çözüm dizininde veya alt dizinlerinde bulunan yerel dosyalar.

Aracı modu, dosya dışlama yoluyla dışlanan dosyalara ve dizinlere erişemez.

Terminal komutları için aracı modu, çalışan Visual Studio işlemiyle aynı izinlere sahiptir ve önceki kısıtlamalarla sınırlı değildir. Önerilen terminal komutlarını çalıştırmadan önce dikkatle gözden geçirin.

Copilot Sohbet penceresinde soru modu ve aracı modunu görmüyorum

Aşağıdaki sorun giderme adımlarını belirtilen sırada uygulayın:

1. Visual Studio 17.14 veya sonraki bir sürümü kullandığınızdan emin olun.

   • Help>Hakkında Visual Studio konumundaki sürümü denetleyin.

   • 17.14 veya sonraki bir sürümü kullanmıyorsanız, Visual Studio Yükleyicisi'ni açın ve derlemenizi güncelleştirin.

2. Sohbet bölmesinde Aracı modunu etkinleştir seçeneğinin seçili olduğunu onaylayın.

   Tools>Options bölmesinde, Tüm Ayarlar>GitHub>Copilot>Copilot Chat bölümünü genişletin, seçeneğini belirleyin ve seçeneğin belirlenip belirlen olmadığını doğrulayın.

3. Visual Studio yeniden başlatmayı deneyin.

Ne zaman sor modunu ve aracı modunu kullanmalıyım?

• Eğer 'Uygula' seçeneğini ya da kodu kendiniz kopyalayıp yapıştırmayı seçmediğiniz sürece hiçbir kod düzenlemesi yapılmayacağından %100 emin olmak istiyorsanız, Sorma modu mükemmeldir.
• Aracı modu, aynı kavramsal soruları işleyebilir ve kodu düzenleme aracı özellikleriyle birlikte uygulamadan kod örnekleri oluşturabilir.
• MCP özelliklerini kullanmak istiyorsanız aracı modunun seçili olması gerekir.

Visual Studio'da Copilot Düzenlemeleri'ne ne oldu?

Aracı modu, hatalarda yineleme yapma, araçları kullanma ve kod değişikliklerini otomatik olarak uygulama özelliği daha fazla olan Copilot Düzenlemelerinin evrimidir.

Yönetici olarak, Visual Studio kullanıcılar için aracı modunun kullanımını nasıl denetleyebilirim?

Visual Studio aracı modu, yöneticiler için GitHub Copilot panosundaki Editor önizleme özellikleri bayrağına tabidir. Yönetici bu ayarı kapatırsa, bu aboneliğin altındaki kullanıcılar Visual Studio aracı modunu kullanamaz.

Daha fazla bilgi için bkz. Kuruluşunuzdaki GitHub Copilot için ilkeleri ve özellikleri yönetme.

İlgili içerik

• GitHub Copilot'ta özel aracıları kullanma
• GitHub Copilot Edits
• GitHub Copilot Ücretsiz