Bu sayfa, Cloud Translation API ile çevrilmiştir.

Yardımcı sohbeti, eşli programlama için kullanma

Bu belgede, entegre geliştirme ortamınızda (IDE) Gemini Code Assist aracı modunu eşli programcı olarak nasıl yapılandırıp kullanacağınız açıklanmaktadır.

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üzenleyip onaylayarak aracının davranışını kontrol edin.

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.

Başlamadan önce

VS Code

IDE'nizde kullanmak istediğiniz Gemini Code Assist sürümünü ayarlayın:
- Bireysel kullanıcılar için Gemini Code Assist
- Gemini Code Assist Standard veya Enterprise

IntelliJ

IDE'nizde kullanmak istediğiniz Gemini Code Assist sürümünü ayarlayın:

Temsilci modunu kullanma

Aracı modunda Gemini'dan üst düzey hedefleri ve karmaşık görevleri tamamlamasını isteyebilirsiniz.

Aracı modundan en iyi şekilde yararlanmak için istemle ilgili en iyi uygulamaları uygulayın ve mümkün olduğunca fazla ayrıntı verin.

Temsilci moduna geçmek için:

VS Code

Gemini Code Assist sohbetini açmak için IDE'nizin etkinlik çubuğunda spark Gemini Code Assist'i tıklayın.
Aracı moduna girmek için Aracı açma/kapatma düğmesini tıklayın. Temsilci moduna geçildiğinde açma/kapatma düğmesi vurgulanır, normal sohbet modunda ise gri renkte görünür.
Gemini Code Assist sohbetine isteminizi girin.

Gemini, isteminize yanıt verir veya bir aracı kullanmak için izin ister.

Aracı durdurmak için Durdur'u tıklayın.

Standart Gemini Code Assist sohbetini kullanmak için Yeni sohbet'i tıklayarak yeni bir sohbet oluşturun.

Gemini Code Assist temsilci modu, Gemini CLI tarafından desteklenir.

IntelliJ

Araç penceresi çubuğunda spark Gemini'ı tıklayın. İstendiğinde oturum açın.
Aracı sekmesini seçin.
Temsilcinin yapmasını istediğiniz görevi açıklayın.
Temsilci görevi tamamlamak için gerekli adımları uygularken değişiklikleri inceleyip onaylayabilirsiniz.
İsteğe bağlı: Değişiklikleri otomatik olarak onaylamak için ayarlar Aracı seçenekleri'ni seçin ve Değişiklikleri otomatik olarak onayla'nın yanındaki onay kutusunu tıklayın.

Dikkat: Temsilci, makinenizin dosya sistemine ve terminal işlemlerine, ayrıca kullanmak üzere yapılandırdığınız tüm araçlara erişebilir. Değişiklikleri nerede ve ne zaman otomatik olarak onayladığınıza son derece dikkat edin.

Aracı modu için araçları yapılandırma

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 ya da özel hizmet uygulamaları yer alır.

Yerleşik araçların kullanımını kontrol etme

Aracı modunda dosya arama, dosya okuma, dosya yazma, terminal komutları gibi yerleşik araçlarınıza erişebilirsiniz.

VS Code

Aracı modunda Gemini'ın hangi araçlara erişebileceğini kontrol etmek için coreTools ve excludeTools ayarlarını kullanabilirsiniz.

coreTools: Modele sunulmasını istediğiniz araçların listesini belirtmenize olanak tanır. Ayrıca, destekleyen araçlar için komuta özgü kısıtlamalar da belirtebilirsiniz. Örneğin, Gemini ayarları JSON'unuza aşağıdakileri eklediğinizde yalnızca ls -l kabuk komutunun yürütülmesine izin verilir:"coreTools": ["ShellTool(ls -l)"].
excludeTools: Modelin kullanmasını istemediğiniz araçların listesini belirtmenize olanak tanır. Ayrıca, destekleyen araçlar için komuta özgü kısıtlamalar da belirtebilirsiniz. Örneğin, Gemini ayarları JSON'ınıza aşağıdakileri eklemek rm -rf komutunun kullanılmasını engeller: "excludeTools": ["ShellTool(rm -rf)"].

Hem excludeTools hem de coreTools listesinde yer alan bir araç hariç tutulur.

Aracı modunda kullanılabilen yerleşik araçları yapılandırmak için aşağıdakileri yapın:

~/.gemini/settings.json konumundaki Gemini ayarları JSON dosyanızı açın. Burada ~, ana dizininizdir.
Aracı araç kullanımını onaylı araçlar listesiyle sınırlamak için Gemini ayarları JSON'unuza aşağıdaki satırı ekleyin:
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
TOOL_NAME_1 ve TOOL_NAME_2 yerine, aracının erişmesini istediğiniz yerleşik araçların adlarını girin.

İstediğiniz sayıda yerleşik aracı listeleyebilirsiniz. Varsayılan olarak, tüm yerleşik araçlar temsilci tarafından kullanılabilir.
Aracı belirli araç komutlarıyla sınırlamak için Gemini ayarları JSON'unuza aşağıdaki satırı ekleyin:
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
Aşağıdakini değiştirin:
- TOOL_NAME: yerleşik aracın adı
- COMMAND: Aracının kullanabilmesini istediğiniz yerleşik araç komutunun adı.
Bir aracı temsilci kullanımının dışında tutmak için Gemini ayarları JSON'unuza aşağıdaki satırı ekleyin:
```
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
TOOL_NAME_1 ve TOOL_NAME_2 simgelerini, temsilci kullanımının dışında tutmak istediğiniz yerleşik araçların adlarıyla değiştirin.
Bir araç komutunu aracı kullanımının dışında bırakmak için Gemini ayarları JSON'unuza aşağıdaki satırı ekleyin:
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
Aşağıdakini değiştirin:
- TOOL_NAME: yerleşik aracın adı
- COMMAND: Temsilci kullanımının dışında bırakmak istediğiniz yerleşik araç komutunun adı.

coreTools ve excludeTools yapılandırma ayarları hakkında daha fazla bilgi için Gemini CLI yapılandırma belgelerine bakın.

IntelliJ

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

MCP sunucularını yapılandırma

VS Code

Aracı modunda hangi sunucuların kullanılacağını kontrol etmek için sunucu dokümanlarına göre bu sunucuları Gemini ayarları JSON'unuza ekleyin.

MCP sunucunuzun gerektirdiği bağımlılıkları yükleyin.
~/.gemini/settings.json konumundaki Gemini ayarları JSON dosyanızı açın. Burada ~, ana dizininizdir.

Sunucu talimatlarına göre, yerel veya uzak MCP sunucularını Gemini ayarları JSON'unuza ekleyin.

Aşağıdaki örnekte iki uzak Cloudflare MCP sunucusu ekleniyor ve yerel makineye GitHub ile GitLab sunucuları yükleniyor.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gitlab"]
    },
    "cloudflare-observability": {
      "command": "npx",
      "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
    },
    "cloudflare-bindings": {
      "command": "npx",
      "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
    }
  }
}

Komut paletini açın ve Developer: Reload Window'u (Geliştirici: Pencereyi Yeniden Yükle) seçin.

Yapılandırdığınız MCP sunucuları, aracının aracı modunda kullanabileceği şekilde kullanılabilir.

IntelliJ

Aracı modunda hangi sunucuların kullanılabilir olduğunu kontrol etmek için bu sunucuları bir mcp.json dosyasına ekleyin ve IDE'nizin yapılandırma dizinine yerleştirin.

MCP sunucunuzun gerektirdiği bağımlılıkları yükleyin.
IDE'nizin yapılandırma dizininde bir mcp.json dosyası oluşturun.

Sunucu talimatlarına göre, yerel veya uzak MCP sunucularını Gemini ayarları JSON'unuza ekleyin.

Aşağıdaki örnekte uzak Cloudflare MCP sunucusu ekleniyor ve yerel makineye GitHub ile GitLab sunucuları yükleniyor.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gitlab"]
    },
    "cloudflare-observability": {
      "command": "npx",
      "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
    },
    "cloudflare-bindings": {
      "command": "npx",
      "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
    }
  }
}

Yapılandırdığınız MCP sunucuları, aracının aracı modunda kullanabileceği şekilde kullanılabilir.

MCP sunucusu kimlik doğrulaması

Bazı MCP sunucuları kimlik doğrulama gerektirir. Gerekli kullanıcı jetonlarını oluşturmak için sunucu belgelerindeki talimatları uygulayın ve ardından bunları uygun şekilde belirtin. Yerel sunucular ortam değişkenlerini kabul edebilir. Uzak sunucular ise üstbilgilerdeki kimlik bilgilerini kabul edebilir.

VS Code

Kimlik doğrulama gerektiren MCP sunucularını Gemini ayarları JSON'unuza ekleyebilirsiniz.

Aşağıdaki örnekte, GitHub'ın yerel ve uzak MCP sunucuları için kişisel erişim jetonunun nasıl belirtileceği gösterilmektedir:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

Burada ACCESS_TOKEN, kullanıcının erişim jetonudur.

IntelliJ

Kimlik doğrulaması gerektiren MCP sunucularını mcp.json dosyanıza ekleyebilirsiniz.

Aşağıdaki örnekte, GitHub yerel sunucusu için kişisel erişim jetonu eklenmektedir:

{
  "mcpServers": {
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

Burada ACCESS_TOKEN, kullanıcının erişim jetonudur.

Bağlam dosyası oluşturma

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. Daha fazla bilgi için Aracı modu bağlamı başlıklı makaleyi inceleyin.

VS Code

Bağlamın uygulanmasını istediğiniz kapsamla eşleşen bir konumda GEMINI.md adlı bir dosya oluşturun. Aşağıdaki tabloda, farklı kapsamlar için bağlam dosyalarının konumları ayrıntılı olarak açıklanmaktadır:

Kapsam	Konum
Tüm projeleriniz	`~/.gemini/GEMINI.md`
Belirli bir proje	Çalışma dizininiz veya proje kökünüze (`.git` klasörüyle tanımlanır) ya da ana dizininize kadar olan tüm üst dizinler.
Bir projenin belirli bir bileşeni, modülü veya alt bölümü	Çalışma dizininizin alt dizinleri.

Aracının bellek sistemi, birden fazla konumdaki bağlam dosyaları yüklenerek oluşturulur. Daha spesifik dosyalardaki (ör. belirli bileşenler veya modüller için olanlar) bağlam, ~/.gemini/GEMINI.md konumundaki genel bağlam dosyası gibi daha genel bağlam dosyalarındaki içeriği geçersiz kılar veya tamamlar.

Aracının kullanmasını istediğiniz tüm kuralları, stil kılavuzu bilgilerini veya bağlamı Markdown biçiminde yazın ve dosyayı kaydedin. Daha fazla bilgi için GitHub'daki örnek bağlam dosyasına bakın.

Aracı, bağlam dosyanızdaki bilgileri ve kendisine gönderdiğiniz tüm istemleri içerir.

IntelliJ

Projenizin kök dizininde GEMINI.md veya AGENT.md adlı bir dosya oluşturun.
Aracının kullanmasını istediğiniz tüm kuralları, stil kılavuzu bilgilerini veya bağlamı Markdown biçiminde yazın ve dosyayı kaydedin.

Aracı, bağlam dosyanızdaki bilgileri ve kendisine gönderdiğiniz tüm istemleri içerir. Ayrıca, @FILENAME söz dizimiyle dosyayı manuel olarak ekleyerek de bağlam ekleyebilirsiniz. Burada FILENAME, dahil etmek istediğiniz bağlamsal bilgileri içeren dosyanın adıdır.

Komutları kullanma

Eğik çizgi / komutları, terminal penceresindeki komutlara benzer komutları hızlıca çalıştırmanıza olanak tanır.

VS Code

Aracı modunda aşağıdaki Gemini CLI komutlarını kullanabilirsiniz:

/tools: Temsilci modu oturumunuzda kullanılabilen araçların listesini gösterir.
/mcp: Yapılandırılmış Model Context Protocol (MCP) sunucularını, bağlantı durumlarını, sunucu ayrıntılarını ve kullanılabilir araçları listeler.

Gemini KSA komutları hakkında daha fazla bilgi için Gemini KSA Komutları başlıklı makaleyi inceleyin. Tüm Gemini CLI komutlarının aracı modunda kullanılamadığını unutmayın.

IntelliJ

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

Aracı işlemlerine her zaman izin ver

Tüm aracı işlemlerine otomatik olarak izin verebilirsiniz.

Tüm aracı işlemlerine otomatik olarak izin vermek için:

VS Code

Tüm aracı işlemlerine otomatik olarak izin vermek için yolo modunu kullanın. Yalnızca güvenilen çalışma alanlarında Yolo modu kullanılabilir.

Yolo modunu yapılandırmak için:

VS Code kullanıcı ayarları JSON dosyanızı açın:
1. Komut paletini (ctrl/command + Shift + P) açın.
2. Preferences: Open User Settings (JSON)'ı (Tercihler: Kullanıcı Ayarlarını Aç (JSON)) seçin.

VS Code kullanıcı ayarları JSON dosyanıza aşağıdakileri ekleyin:

//other settings...

"geminicodeassist.agentYoloMode": true,
//other settings...

Komut paletini açın ve Developer: Reload Window'u (Geliştirici: Pencereyi Yeniden Yükle) seçin.

Temsilci modu, yolo modunu kullanır ve istem gönderdiğinizde işlem yapmadan önce izin istemez. Kısıtlanmış bir çalışma alanı kullanıldığında, bu ayardan bağımsız olarak aracı, işlem yapmadan önce istemde bulunur.

IntelliJ

Değişiklikleri otomatik olarak onaylamak için Gemini sohbet aracısı sekmesinde ayarlar Aracı seçenekleri'ni seçin ve Değişiklikleri otomatik olarak onayla'nın yanındaki onay kutusunu tıklayın.

Aracı modu, tüm istekleri otomatik olarak onaylar ve istem gönderdiğinizde işlem yapmadan önce izin istemez.

Ek istemler

Aşağıdaki istemleri kendi bilgilerinizle deneyin:

"Bu depo ne işe yarar? Mimarinin nasıl çalıştığını anlamama yardımcı ol."
"Bu [sınıf/işlev] ne işe yarar?"
"Bu kod tabanına bir özellik ekle: "[link-or-path-to-codebase]"."
"[A] ve [B] işlevlerini, ortak [C] yöntemini kullanacak şekilde yeniden düzenle."
"Fix the GitHub issue [link-to-github-issue]." ([GitHub sorununu düzelt [link-to-github-issue]].)
"Kullanıcının [ortam] içinde [görev] yapmasına olanak tanıyan bir kullanıcı arayüzüyle [amaç] için bir uygulama oluştur."
"Bu depodaki kitaplık sürümlerini [X] sürümünden [Y] sürümüne taşı."
"Bu Go kodunun performansını, daha hızlı çalışacak şekilde optimize et."
"Bu özelliği geliştirmek için [name-of-API] API'sini kullanın."
"[X], [Y] ve [Z] işlemlerini yapacak bir algoritma uygula."

Sırada ne var?

Gemini Code Assist'e genel bakış başlıklı makaleyi okuyun.
Bazı örnek MCP sunucularını inceleyin.
GitHub'da daha fazla MCP sunucusu bulun.
IDE'nizden geri bildirim gönderin.

Yardımcı sohbeti, eşli programlama için kullanma Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Sınırlamalar

Başlamadan önce

VS Code

IntelliJ

Temsilci modunu kullanma

VS Code

IntelliJ

Aracı modu için araçları yapılandırma

Yerleşik araçların kullanımını kontrol etme

VS Code

IntelliJ

MCP sunucularını yapılandırma

VS Code

IntelliJ

MCP sunucusu kimlik doğrulaması

VS Code

IntelliJ

Bağlam dosyası oluşturma

VS Code

IntelliJ

Komutları kullanma

VS Code

IntelliJ

Aracı işlemlerine her zaman izin ver

VS Code

IntelliJ

Ek istemler

Sırada ne var?

Yardımcı sohbeti, eşli programlama için kullanma