Bu belgede, Gemini Code Assist'teki aracı modu açıklanmaktadır.
Aracı modu, VS Code ve IntelliJ entegre geliştirme ortamlarında (IDE'ler) 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.
IntelliJ'deki aracı modu, Gemini CLI'yı kullanmaz.
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
TODOyorumlardan kod oluşturun. - Planlara ve yürütme sırasında araç kullanımına yorum yaparak, bunları düzenleyip onaylayarak aracının davranışını kontrol edin.
Temsilci modunun işleyiş şekli
Aracı modunda isteminiz, kullanılabilen araçların listesiyle birlikte Gemini API'ye 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 olarak 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ığınız sürece 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 kabul edebilir 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 kendi kendine 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şif 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.
IntelliJ
Aşağıdaki bağlam alma yöntemleri genellikle Gemini Code Assist'in aracı modunda kullanılabilir:
- Dosyalarınız, dizine eklenmiş semboller ve projenizdeki sembollerin kullanımı dahil olmak üzere IDE projenizdeki bilgiler.
- grep, file read veya file write gibi yerleşik araçlardan gelen araç yanıtları.
- IntelliJ sürüm kontrolü.
- Yapılandırılmış MCP sunucuları ve araçları
- Markdown'da oluşturduğunuz bağlam dosyaları.
Aracının kullanabileceği bağlamı, aracı modu sohbet istemi alanındaki bağlam çekmecesinde görebilirsiniz.
Araçlar
Araçlar, bir temsilcinin isteminize yanıt verirken bağlam ve işlemler için kullanabileceği geniş bir hizmet kategorisidir. Araçlar, temsilcilerin API uç noktalarına veya diğer temsilcilere işlev çağrısı yaparak güncel bilgilere erişmesini sağlar. Araçlar yalnızca bir işlev sunabilir veya birbiriyle alakalı birden fazla işlev sunabilir.
Örneğin, grep ve dosya okuma veya yazma gibi yerleşik araçlar, yerel ya da uzak Model Bağlamı Protokolü (MCP) sunucuları ve bunların yürütülebilir işlevleri ile RESTful API çağrıları.
Yerleşik araçlar
Gemini, aracı modunda yerleşik sistem araçlarınıza erişebilir. Gemini'da aracı modunda kullanılabilen yerleşik araçların listesini görmek için IDE'nizi seçin.
VS Code
Gemini CLI'daki tüm yerleşik araçlar, Gemini Code Assist'te aracı modunda kullanılabilir.
IntelliJ
read_file- Bir dosyanın metin içeriğini mutlak yolunu kullanarak alır.
write_file- Belirtilen metni, belirtilen dosyaya yazar. Dosya yoksa oluşturur.
analyze_current_file- Düzenleyicideki açık dosyayı hata ve uyarılar açısından analiz eder.
find_files- Dosya adı veya yolun bir kısmı verildiğinde dosyaların mutlak yolunu bulur.
grep- Projedeki belirli bir metin kalıbı veya normal ifade içeren tüm dosyaları bulur.
list_files- Belirli bir mutlak yoldaki tüm dosyaları ve dizinleri listeler.
resolve_symbol- Belirli bir sembol referansını orijinal bildirimine göre çözer.
find_usages- Belirli bir sembol beyanıyla ilgili tüm referanslar için projede arama yapar.
git- Bir Git komut satırı arayüzü (KSA) komutunu çalıştırır ve sonucu döndürür.
list_vcs_roots- Geçerli projedeki Git depoları gibi tüm sürüm kontrol sistemi (VCS) köklerini döndürür.
Sınırlamalar
Standart Gemini Code Assist sohbetinin bazı özellikleri, aracı modunda kullanılamayabilir veya standart sohbetteki gibi çalışmayabilir.
Okuma işlevi, temsilci modunda kullanılamaz. Gemini, aracı modundayken kaynak belirtmez ve alıntılanan kaynaklarla eşleşen kod önerilerini devre dışı bırakamazsınız.