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.
Hızlı başlangıç kılavuzu
İlk ajan görüşmenizi yapın, yanıtları yayınlayın ve özel bir ajan oluşturun.
Antigravity Agent
Varsayılan aracının özellikleri, araçları, çok formatlı girişi ve fiyatlandırması.
AI Studio'daki temsilciler
Kod yazmadan ajan prototipi oluşturmak için görsel deneme alanı.
Kullanılabilir yönetilen aracıları
- Antigravity agent: Gemini 3.8 Flash ile oluşturulmuş genel amaçlı yönetilen ajan. Google tarafından barındırılan güvenli bir Linux sanal alanında kod çalıştırır, dosyaları yönetir ve web'de arama yapar.
agent_configsimgesini kullanarak temel modeli (ör. Gemini 3.6 Flash veya Gemini 3.5 Flash-Lite) yapılandırabilir ve özel bir aracı oluşturmak için kendi talimatlarınız, becerileriniz ve verilerinizle genişletebilirsiniz. - Deep Research: Pazar analizi, durum tespiti ve literatür incelemeleri 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 ajanı.
Güvenlik ve en iyi uygulamalar
Her aracı, işletim sistemi düzeyinde yalıtılmış bir korumalı alan ortamında ç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 Verilenler 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. Gizli dizileri yönetilen kimlik bilgileri olarak saklayın ve kimliklerine göre referans verin. Böylece çıkış proxy'si bunları istek sırasında ekler ve bunlar hiçbir zaman sanal alan içinde açığa çıkmaz. Aracı, 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 istekli olduğunuz kimlik bilgilerini sağlayın.
- Kimlik bilgilerini düzenli aralıklarla değiştirin.
Kimlik bilgisi türleri ve yönetim işlemleri için Kimlik bilgileri başlıklı makaleyi inceleyin. Ayrıca, izin verilenler listesi kuralında satır içi olarak başlıklar da ayarlayabilirsiniz. Ağ yapılandırması bölümüne bakın.
İ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 ajanlar, Gemini model jetonlarına ve araç kullanımına dayalı bir kullandıkça öde modelini kullanır. Tek bir etkileşim, genellikle 100.000 ila 3.000.000 jeton tüketen birden fazla muhakeme 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 maliyetlere bakın. Yönetilen aracılar, ücretsiz katmanda ücretsiz sıklık sınırlaması 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 | Sanal makineler, kaynakları korumak için 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ım başlıklı makaleyi inceleyin. |
| Maksimum ajan sayısı | En fazla 1.000 yönetilen ajana sahip olabilirsiniz. |
Ajan çerçeveleri
Ayrıca aşağıdaki çerçeveleri ve SDK'ları kullanarak Gemini ile ajanlar 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: İşbirlikçi, rol oynayan otonom yapay zeka ajanlarını 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'sı: Google Antigravity'yi destekleyen aynı araçları, aracı döngüsünü ve bağlam yönetimini kullanarak Python'da programlanabilen otonom yapay zeka aracıları oluşturun.