Aracılara Genel Bakış

Gemini API'deki yönetilen ajanlar, yapılandırılabilir bir ajan koşumu sağlar. Tek bir API çağrısı, aracının akıl yürüttüğü, kod yürüttüğü, dosyaları yönettiği ve web'de bağımsız olarak gezindiği bir Linux sanal alanı sağlar.

Kullanılabilir yönetilen aracı sayısı

  • Antigravity ajanı: Gemini 3.5 Flash tarafından desteklenen, genel amaçlı yönetilen ajan. Google tarafından barındırılan güvenli bir Linux korumalı alanında kod çalıştırır, dosyaları yönetir ve web'de arama yapar. Özel bir temsilci oluşturmak için kendi talimatlarınız, becerileriniz ve verilerinizle genişletebilirsiniz.
  • Deep Research: Pazar analizi, gerekli özen ve literatür taramaları gibi kullanım alanları için çok adımlı araştırma görevlerini planlayan, yürüten ve sentezleyen bağımsız araştırma aracısı.

Güvenlik ve en iyi uygulamalar

Her aracı, işletim sistemi düzeyinde yalıtılmış bir korumalı alanda çalışır. Korumalı alan, varsayılan olarak sınırsız giden ağ erişimine sahiptir. İzin verilenler listesi kullanarak ağ erişimini kısıtlayabilir veya devre dışı bırakabilirsiniz.

Ağ erişimi

Varsayılan olarak, ortamların sınırsız giden ağ erişimi vardır. Giden trafiği belirli alanlarla veya joker karakter kalıplarıyla kısıtlamak için network izin verilenler listesini kullanın. Yapılandırma ayrıntıları için Ağ İzin Verme Listesi (AI Studio) veya Ağ kuralları (API) başlıklı makaleleri inceleyin.

Harici araçlar ve API'ler

Ajanı genişletmek için harici araçlar ve API'ler bağlayabilirsiniz. Yalnızca güvenilir kaynaklardan gelen araçları kullanın ve izinleri gereken minimum düzeyde tutun. Kimlik bilgileri, çıkış proxy'si başlık dönüşümleri aracılığıyla güvenli bir şekilde eklenebilir ve hiçbir zaman korumalı alan içinde kullanıma sunulmaz. Ajan, erişebildiği tüm kimlik bilgilerini kullanabilir. Bu nedenle, yalnızca tam kapsamlı erişim izni vermeye hazır olduğunuz kimlik bilgilerini sağlayın.

  • En az ayrıcalıklı hizmet hesaplarını veya API anahtarlarını kullanın.
  • Uzun ömürlü anahtarlar yerine kısa ömürlü jetonları tercih edin.
  • Yalnızca tam kapsamını vermeye hazır olduğunuz kimlik bilgilerini sağlayın.
  • Kimlik bilgilerini düzenli aralıklarla döndürün.

Başlık dönüşümlerini yapılandırma hakkında ayrıntılı bilgi için Kimlik bilgileri başlıklı makaleyi inceleyin.

İnsan denetimi

Çıktıları (oluşturulan kod, veri dönüşümleri, yapılandırma değişiklikleri) dağıtmadan önce her zaman doğrulayın. Bu, özellikle verileri değiştiren veya harici sistemlerle etkileşimde bulunan görevler için önemlidir.

Fiyatlandırma

Yönetilen aracılar, Gemini model jetonlarına ve araç kullanımına dayalı bir kullandıkça öde modeli kullanır. Tek bir etkileşim, genellikle 100 bin ila 3 milyon jeton tüketen birden fazla akıl yürütme döngüsünü tetikleyebilir. Önizleme sırasında ortam işlem ücreti alınmaz. Görev başına dökümler için tahmini maliyetler bölümüne bakın. Yönetilen aracılar, ücretsiz katmanda ücretsiz hız sınırı ve kullanım kotasıyla da kullanılabilir.

Sınırlar

Sınır Açıklama
Ortamın kullanım ömrü Ortamlar, 7 gün boyunca işlem yapılmadığında kalıcı olarak silinir.
VM Spin-down Kaynakları korumak için VM'ler kısa bir süre işlem yapılmadığında kapatılır. Bir sonraki istek, durumu (baştan başlatma ile) geri yükler.
Önceden Yüklenmiş Yazılım Python 3.12 ve Node.js 22'nin bulunduğu Ubuntu tabanlı ortam. Ortamın temel görüntüsü hakkında daha fazla bilgi için Önceden yüklenmiş yazılımlar başlıklı makaleyi inceleyin.
Maks. ajan sayısı En fazla 1.000 yönetilen aracıya sahip olabilirsiniz.

Ajan çerçeveleri

Aşağıdaki çerçeveleri ve SDK'ları kullanarak Gemini ile ajanlar da oluşturabilirsiniz:

  • LangChain / LangGraph: Grafik yapılarını kullanarak durum bilgisi olan, karmaşık uygulama akışları ve çoklu ajan sistemleri oluşturun.
  • LlamaIndex: RAG ile geliştirilmiş iş akışları için Gemini ajanlarını özel verilerinize bağlayın.
  • CrewAI: Ortak çalışmaya dayalı, rol oynayan otonom yapay zeka temsilcilerini yönetin.
  • Vercel AI SDK: JavaScript/TypeScript'te yapay zeka destekli kullanıcı arayüzleri ve temsilciler oluşturun.
  • Google ADK: Birlikte çalışabilen yapay zeka temsilcileri oluşturmak ve düzenlemek için kullanılan açık kaynaklı bir çerçeve.
  • Antigravity SDK: Google Antigravity'yi destekleyen aynı araçları, aracı döngüsünü ve bağlam yönetimini kullanarak Python'da programlanabilir, bağımsız yapay zeka aracıları oluşturun.