Temsilci modu

Bu belgede, Gemini Code Assist'teki aracı modu açıklanmaktadır.

Aracı modu, VS Code entegre geliştirme ortamında (IDE) kullanılabilir. Temsilci modunu kullanmaya başlamak için Temsilci sohbetini eşli programcı olarak kullanma başlıklı makaleyi inceleyin.

VS Code'daki aracı modu, Gemini CLI tarafından desteklenir.

Aracı modunda aşağıdakileri ve daha fazlasını yapabilirsiniz:

  • Kodunuzla ilgili sorular sorun.
  • Oluşturulan içeriği iyileştirmek için bağlamı ve yerleşik araçları kullanın.
  • Aracının yeteneklerini genişletmek için MCP sunucularını yapılandırın.
  • Birden fazla adımdan oluşan karmaşık görevlerin çözümlerini alın.
  • Tasarım belgelerinden, sorunlardan ve TODO yorumlardan kod oluşturun.
  • Planlara ve yürütme sırasında araç kullanımına yorum yaparak, bunları düzenleyerek ve onaylayarak aracının davranışını kontrol edin.

Temsilci modunun işleyiş şekli

Aracı modunda isteminiz, Gemini API'ye kullanılabilir araçların listesiyle birlikte gönderilir. Gemini API, istemi işler ve yanıt döndürür. Yanıt, doğrudan bir cevap veya mevcut bir aracı kullanma isteği olabilir.

Bir araç istendiğinde aracı kullanmaya hazırlanan temsilci, aracı açık izinle veya izinsiz kullanmasına izin verilip verilmediğini kontrol eder:

  • Dosya sistemini değiştiren veya kaynaklar üzerinde mutasyon işlemleri gerçekleştiren araç istekleri için, Gemini'ı araçların her zaman kullanılmasına izin verecek şekilde yapılandırmadıysanız işlemi onaylamanızı ister.
  • Salt okunur olan araç istekleri, görevi tamamlamadan önce izin istemeyebilir.

Bir aracın kullanımına izin vermeniz istendiğinde işlemi onaylayabilir veya reddedebilirsiniz. Aracı, bir araca veya sunucuya her zaman izin verme ya da benzer işlemlere izin verme seçenekleri de sunabilir. Daha fazla bilgi için Aracı işlemlerine her zaman izin verme başlıklı makaleyi inceleyin.

Aracın kullanımına izin verildikten veya izin kendiliğinden verildikten sonra aracı, gerekli işlemi tamamlamak için kullanır ve bu işlemin sonucu Gemini API'ye geri gönderilir. Gemini, araç işleminin sonucunu işler ve başka bir yanıt oluşturur. Bu işlem ve değerlendirme döngüsü, görev tamamlanana kadar devam eder.

Gemini, karmaşık görevlerde onayınız için üst düzey bir plan gösterebilir. İşleme başlamadan önce planı ayrıntılı bir şekilde düzenleyebilir ve sohbet bölümünde sorular sorabilirsiniz. Plana onay verebilirsiniz. Planı onayladıktan sonra, temsilci ilk görev üzerinde çalışmaya başlar ve planı uygularken gerektiğinde sizden açıklama veya izin ister.

Temsilci modu bağlamı

Bağlam, temsilcinin belirli bir istem için daha iyi yanıtlar oluşturmasına olanak tanır. Bağlam; IDE'nizdeki dosyalardan, yerel sistem klasörlerinizdeki dosyalardan, araç yanıtlarından ve istem ayrıntılarınızdan alınabilir.

IDE'nize ve ayarlarınıza bağlı olarak, aracı için farklı bağlamlar kullanılabilir.

Aşağıdaki sekmelerde, farklı IDE'ler için bağlamın nasıl toplandığı ayrıntılı olarak açıklanmaktadır.

VS Code

Aşağıdaki bağlam alma yöntemleri genellikle Gemini Code Assist'in aracı modunda kullanılabilir:

  • IDE çalışma alanınızdaki bilgiler
  • grep, terminal, file read veya file write gibi yerleşik araçlardan gelen araç yanıtları.
  • Google Arama yanıtları
  • İstemde veya araç tarafından sağlanan belirli bir URL'deki içerik.
  • Markdown'da oluşturduğunuz bağlam dosyaları.

Aracı belleği

VS Code'daki Gemini Code Assist aracı modu, araca bağlam sağlayan GEMINI.md dosyalarını bulup yüklemek için Gemini CLI bellek keşfi hizmetinden yararlanır. Bellek keşfetme hizmeti, bu dosyaları hiyerarşik olarak arar. Arama, mevcut çalışma dizininden başlar ve proje köküne ve ana dizininize doğru ilerler. Alt dizinlerde de arama yapar.

Global, proje düzeyinde ve bileşen düzeyinde bağlam dosyaları oluşturabilirsiniz. Bu dosyalar, modele en alakalı bilgileri sağlamak için birleştirilir.

Yüklenen tüm GEMINI.md dosyaların birleştirilmiş içeriğini görmek için /memory show komutunu, dosyaları yeniden yüklemek için ise /memory refresh komutunu kullanabilirsiniz.

Gemini CLI uzantıları

Gemini Code Assist aracı modu işlevlerini yapılandırmak ve genişletmek için Gemini CLI uzantılarını kullanabilirsiniz.

Temsilci, uzantıları iki konumda arar:

  • WORKSPACE/.gemini/extensions, mevcut çalışma alanınızdır.WORKSPACE
  • ~/.gemini/extensions (burada ~, ana dizininizdir).

Aracı, her iki konumdaki tüm uzantıları yükler. Ancak her ikisinde de aynı ada sahip bir uzantı varsa çalışma alanı dizinindeki uzantı öncelikli olur. Her uzantı, gemini-extension.json dosyası içeren bir dizindir. Bu dosya, uzantının yapılandırmasını içerir.

Daha fazla bilgi için Gemini KSA uzantıları başlıklı makaleyi inceleyin.

IntelliJ

Bu özellik, IntelliJ için Gemini Code Assist'te veya diğer JetBrains IDE'lerinde desteklenmez.

Araçlar

Araçlar, bir temsilcinin isteminize yanıt verirken bağlam ve işlemler için kullanabileceği geniş bir hizmet kategorisidir. Örnek araçlar arasında grep ve dosya okuma/yazma gibi yerleşik araçlar, yerel veya uzak Model Bağlamı Protokolü (MCP) sunucuları ve bunların yürütülebilir işlevleri ile özel hizmet uygulamaları yer alır.

Sırada ne var?