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 çağrınızı 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 temsilci prototipi oluşturmak için görsel deneme alanı.
Kullanılabilir yönetilen aracı sayısı
- 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 korumalı alanında kod çalıştırır, dosyaları yönetir ve web'de arama yapar.
agent_configkullanarak temel modeli (ör. Gemini 3.7 Flash, Gemini 3.6 Flash veya Gemini 3.5 Flash) yapılandırabilir ve ö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 ajanı.
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. Çıkış proxy'sinin istek sırasında bunları eklemesi ve sandbox'ta hiçbir zaman gösterilmemesi için gizli dizileri yönetilen kimlik bilgileri olarak saklayın ve kimliklerine göre referans verin. 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 hazır 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. İzin verilenler listesi kuralında üstbilgileri satır içi olarak 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 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 maliyetlere 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 ajana 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.