GitHub Copilot aracı modunu kullanmaya başlama

Visual Studio'daki 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, mod açılır listesini genişletmek için Sor'u 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.

   

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

   

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.

     

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

7. Eğer ajanın yaptığı bireysel kod değişikliklerini gözden geçirmek istiyorsanız, şu seçenekleri değerlendirebilirsiniz:

   • Her adımda belirli bir değişikliği gözden geçirin.

     

   • Değişikliklerin en son ne zaman tutulduğunu veya geri alındığını gösteren toplu değişiklikleri gözden geçirin.

     

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ı

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.

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çlar>Seçenekleri bölmesinde sıfırlayabilirsiniz. Tüm Ayarlar>GitHub>Copilot>Araçları bölümünü genişletin.

Düzenlemeleri kabul etme veya atma

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

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.

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

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 planlama, Copilot'un 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ı (plan-{sessionId}.json), 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'un tutarlı kalmasına, planını dinamik olarak güncelleştirmesine ve geliştiricilere ne yaptığına yönelik görünürlük sağlamasına 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'un 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 işlemleri yeniden sıraladıkça, uyarladıkça veya rafine ettikçe, JSON planı arka planda gelişir.

Depolama

Her iki dosya da içinde C:\Users\username\AppData\Local\Temp\VisualStudio\copilot-vsdepolanı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'un yürütme sırasında planları oluşturma, güncelleştirme ve sonlandırma şeklini 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'un çok adımlı iş akışlarını artımlı olarak yönetmesine, yürütme durumunu korumasına 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. Araçlar>Seçenekleri 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:

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 Sohbetinde 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 üzerini kullandığınızdan emin olun.

   • Visual Studio Hakkında> bölümünden 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.

   Araçlar>Seçenekleri bölmesinde Tüm Ayarlar>GitHub>Copilot Copilot>Sohbeti bölümünü genişletin ve seçeneğin belirlenip seçilmedığını doğrulayın.

3. Visual Studio'yu yeniden başlatmayı deneyin.

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

• 100% kodu kendiniz uygula veya kopyala'yı seçip yapıştırmadığınız sürece hiçbir kod düzenlemesi yapılmamasını istiyorsanız, Sorun 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 bir evrimidir.

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

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

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

İlgili içerik

• GitHub Copilot Düzenleme
• GitHub Copilot Ücretsiz