Temsilci modu

Android Studio'daki Gemini'ın Agent modu, Gemini ile sohbet ederek deneyimleyebileceğinizden daha fazlasını sunan, karmaşık ve çok aşamalı geliştirme görevlerini yönetmek için tasarlanmıştır. Üst düzey bir hedefi açıklayabilirsiniz. Bu durumda aracı, gerekli araçları çağırarak, birden fazla dosyada değişiklik yaparak ve hataları yinelemeli olarak düzelterek bir plan oluşturup uygular. Bu aracı destekli iş akışı, karmaşık zorlukların üstesinden gelmenizi sağlayarak geliştirme sürecinizi hızlandırır.

Sistem gereksinimleri

Temsilci modu, Android Studio Narwhal Feature Drop Canary 4 sürümünden itibaren kullanılabilir. Android Studio'nun en yeni önizleme sürümünü indirin.

Başlayın

Android Studio'da Agent modunu kullanmaya başlamak için aşağıdaki adımları uygulayın:

1. Kenar çubuğunda Gemini'ı tıklayın. Gerekirse oturum açın ve ilk katılım sürecini tamamlayın.
2. Aracı sekmesini seçin.
3. Temsilcinin yapmasını istediğiniz görevi açıklayın.

4. Temsilci görevi tamamlamak için gerekli adımları uygularken değişiklikleri inceleyip onaylayabilirsiniz.

   

5. İsteğe bağlı: Değişiklikleri otomatik olarak onaylamak için Aracı seçenekleri > Değişiklikleri otomatik olarak onayla'yı seçin.

   

Kullanım örnekleri

Ajanın size yardımcı olabileceği kullanım alanlarından bazı örnekleri aşağıda bulabilirsiniz:

• Derleme hatalarını düzeltin. Aracıdan "Projemdeki derleme hatalarını düzelt" gibi bir istem kullanarak derleme hatasını düzeltmesini istediğinizde, önerilen düzeltmeyi uygular, çözümü doğrulamak için projeyi oluşturur ve sorun çözülene kadar tekrarlama yapar.

  

• Ajan modu, kullanıcı arayüzü öğelerini kendi başına ekleyebilir veya güncelleyebilir. Örneğin, "Kullanıcı tercihlerinde varsayılan olarak koyu modu ayarla" diye sorulduğunda ilgili dosyaları arar ve görevi tamamlamak için değişiklikler önerir. Kullanıcı arayüzü güncellemelerini Çalışan cihazlar araç penceresinde anında önizleyebilirsiniz.

• Uygulamanızın prototipini oluştururken ve test ederken sahte veriler kullanmak faydalıdır. Sahte verileri kendiniz manuel olarak oluşturmak yerine bu görevi aracıya verebilirsiniz. Burada, temsilciden "Sahte verilere iki oturum daha ekle"mesini istiyoruz. İlgili dosyayı bulur ve mockSessions listesine iki etkinlik daha ekler.

Deneyebileceğiniz diğer istemler:

• "Write unit tests for <class> in <module>." (<module> içindeki <class> için birim testleri yaz.)
• "Şu anda açık olan dosya için doküman oluştur."
• "Uygulama başlığını <mevcut ad> yerine <yeni ad> olarak değiştir."
• "Boş işaretçi istisnasını çöz."
• <composable name > composable'ı yeni bir dosyaya taşıyarak kodumu yeniden düzenle. Tüm içe aktarmaların güncellendiğinden emin olun."
• "Uygulamanın ana ekranına, sizi konu listesine götüren "Takip et" adlı yeni bir düğme ekle."
• "<composable name> composable'da <modifier name> değiştiricisinin dolgusunu azaltın."
• "Sosyal medyada paylaşmak için paylaşım düğmesi oluştur."

Gemini API anahtarınızı ekleme

Android Studio'daki varsayılan temsilci modunda, sınırlı bağlam penceresiyle birlikte ücretsiz günlük kota bulunur. Bağlam penceresini genişletmek için kendi Gemini API anahtarınızı ekleyerek Gemini 2.5 Pro ile 1 milyon parçaya kadar yararlanabilirsiniz.

Daha büyük bir bağlam penceresi sayesinde Gemini'a daha fazla talimat, kod ve ek gönderebilir, böylece daha yüksek kaliteli yanıtlar alabilirsiniz. Bu özellik, özellikle temsilcilerle çalışırken yararlıdır. Daha büyük bağlam, Gemini 2.5 Pro'ya karmaşık veya uzun süren görevler hakkında akıl yürütme olanağı sağlar.

API anahtarı almak için:

1. Google AI Studio'da oturum açın ve API anahtarını al düğmesini tıklayarak anahtar edinin.
2. Android Studio'da Gemini API anahtarınızı girmek için File (Android Studio on macOS) > Settings > Tools > Gemini'a (Dosya > Ayarlar > Araçlar > Gemini) gidin.
3. Android Studio'da Gemini'ı yeniden başlatın ve Agent modundan daha iyi yanıtlar alın.

Gemini API anahtarınızın güvenliğini sağlamayı unutmayın. Çünkü kişisel API anahtarıyla ilişkili Gemini API kullanımı için ek ücretler uygulanır. Gemini API anahtarınızın kullanımını AI Studio'da Get API Key > Usage & Billing (API anahtarını al > Kullanım ve Faturalandırma) bölümünden izleyebilirsiniz.

MCP sunucusu ekleme

Android Studio'daki Gemini aracısı, Model Context Protocol (MCP)'ü kullanarak harici araçlarla etkileşim kurabilir. Bu özellik, Agent modunun araçları kullanması ve harici ortamla bilgi ve yeteneklerini genişletmesi için standartlaştırılmış bir yol sağlar.

Android Studio'da MCP ana makinesine bağlayabileceğiniz birçok araç vardır. Örneğin, doğrudan Android Studio'dan çekme istekleri oluşturmak için GitHub MCP sunucusu ile entegrasyon yapabilirsiniz. Daha fazla fikir için MCP örnek sunucuları başlıklı makaleyi inceleyin.

MCP sunucusu eklemek için bir mcp.json dosyası oluşturup Studio'nun yapılandırma dizinine yerleştirin. mcp.json dosyası şu biçimde olmalıdır:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Bu dosyada listelemeniz gereken tam command ve args için entegrasyon yaptığınız MCP sunucusunun belgelerine bakın. MCP sunucusunun yazılım gereksinimlerine bağlı olarak Node.js veya Docker gibi araçları da yüklemeniz gerekebilir.

Sınırlamalar

Android Studio'nun MCP entegrasyonuyla ilgili birkaç önemli sınırlama vardır:

• MCP sunucuları, stdio aktarımını uygulamalıdır.
• Akış HTTP aktarımı, MCP kaynakları ve istem şablonları henüz desteklenmemektedir.

Aracının işleyiş şekli

Aracı modunda isteminiz, kullanılabilen araçların listesiyle birlikte Gemini API'ye gönderilir. Araçları beceri olarak düşünebilirsiniz. Dosya arama, dosya okuma, dosyalardaki metinleri arama, yapılandırdığınız MCP sunucularını kullanma gibi beceriler bu kapsamdadır.

Temsilciye bir görev verdiğinizde, bir plan oluşturur ve hangi araçların gerektiğini belirler. Bu araçlardan bazıları, temsilcinin bunları kullanabilmesi için izin vermenizi gerektirebilir. İzin verdiğinizde aracı, gerekli işlemi gerçekleştirmek için aracı kullanır ve sonucu Gemini API'ye geri gönderir. Gemini, işlemin 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.