Araçlar, Gemini modellerinin yeteneklerini genişleterek dünyada işlem yapmalarını, anlık bilgilere erişmelerini ve karmaşık hesaplama görevlerini gerçekleştirmelerini sağlar. Modeller, hem standart istek-yanıt etkileşimlerinde hem de Live API'yi kullanan gerçek zamanlı akış oturumlarında araçları kullanabilir.
Araçlar, bir modelin sorguları yanıtlamak için kullanabileceği belirli özelliklerdir (ör. Google Arama veya kod yürütme). Gemini API, tam olarak yönetilen bir dizi yerleşik araç sunar. Ayrıca Function Calling'i kullanarak özel araçlar da tanımlayabilirsiniz.
Çok adımlı, hedefe yönelik sistemler oluşturmak için Agents Overview (Temsilcilere Genel Bakış) başlıklı makaleyi inceleyin.
Kullanılabilir yerleşik araçlar
| Araç | Açıklama | Kullanım Alanları |
|---|---|---|
| Google Arama | Halüsinasyonları azaltmak için yanıtları güncel olaylar ve web'deki bilgilerle temellendirin. | Yakın zamandaki etkinliklerle ilgili soruları yanıtlama, çeşitli kaynaklardan bilgileri doğrulama |
| Google Haritalar | Yerler bulabilen, yol tarifi alabilen ve zengin Local Context sağlayabilen konuma duyarlı asistanlar oluşturun. | Birden fazla durak içeren seyahat planları oluşturma, kullanıcı ölçütlerine göre yerel işletmeleri bulma |
| Kod Yürütme | Modelin, matematik problemlerini çözmek veya verileri doğru şekilde işlemek için Python kodu yazıp çalıştırmasına izin verin. | Karmaşık matematik denklemlerini çözme, metin verilerini hassas bir şekilde işleme ve analiz etme |
| URL Bağlamı | Modeli, belirli web sayfalarından veya dokümanlardan içerik okuyup analiz etmeye yönlendirin. | Belirli URL'lere veya belgelere göre soruları yanıtlama, farklı web sayfalarındaki bilgileri alma |
| Bilgisayar Kullanımı (Önizleme) | Gemini'ın ekranı görüntülemesine ve web tarayıcısı kullanıcı arayüzleriyle etkileşim kurmak için işlemler oluşturmasına izin verin (istemci tarafı yürütme). | Web tabanlı tekrarlanan iş akışlarını otomatikleştirme, web uygulaması kullanıcı arayüzlerini test etme |
| Dosya Arama | Veriyle Artırılmış Üretim'i (RAG) etkinleştirmek için kendi dokümanlarınızı dizine ekleyin ve arayın. | Teknik kılavuzlarda arama yapma, özel verilerle ilgili soruları yanıtlama |
Belirli araçlarla ilişkili maliyetler hakkında ayrıntılı bilgi için Fiyatlandırma sayfasını inceleyin.
Araç yürütme işleminin işleyiş şekli
Araçlar, modelin sohbet sırasında işlem isteğinde bulunmasına olanak tanır. Akış, aracın yerleşik (Google tarafından yönetilen) veya özel (sizin tarafınızdan yönetilen) olmasına göre farklılık gösterir.
Yerleşik araç akışı
Yerleşik araçlar (Google Arama, Google Haritalar, URL Bağlamı, Dosya Arama, Kod Yürütme) için tüm süreç tek bir API çağrısı içinde gerçekleşir:
- Siz şu istemi gönderirsiniz: "GOOG'un en son hisse senedi fiyatının karekökü nedir?"
- Gemini, araçlara ihtiyacı olduğuna karar verir ve bunları Google'ın sunucularında çalıştırır (ör. hisse senedi fiyatını arar, ardından karekökü hesaplamak için Python kodunu çalıştırır).
- Gemini, araç sonuçlarına dayalı nihai yanıtı gönderir.
Özel araç akışı (işlev çağırma)
Özel araçlar ve bilgisayar kullanımı için yürütme işlemini uygulamanız gerçekleştirir:
- Siz, işlev (araç) bildirimleriyle birlikte bir istem gönderirsiniz.
- Gemini, belirli bir işlevi çağırmak için yapılandırılmış JSON döndürebilir (ör.
{"name": "get_order_status", "args": {"order_id": "123"}}). Bu JSON'da her zaman benzersiz biridbulunur. - İşlevi uygulamanızda veya ortamınızda siz yürütürsünüz.
- Siz, işlev çağrısıyla aynı
iddeğerine sahip işlev sonuçlarını Gemini'a geri gönderirsiniz. - Gemini, sonuçları kullanarak nihai bir yanıt veya başka bir araç çağrısı oluşturur.
Daha fazla bilgi edinmek için İşlev çağırma kılavuzunu inceleyin.
Yerleşik ve özel araçları birleştirme akışı
Yerleşik araçları ve özel araçları (işlev çağrıları) birleştiren isteklerde model, farklı ortamlarda yürütmeyi koordine etmek için araç bağlamı dolaşımını kullanır:
- Siz bir istem gönderir ve etkinleştirmek istediğiniz yerleşik araçları ve özel işlevleri bildirerek birleştirme desteğini etkinleştirmek için bir işaret ayarlarsınız.
- Gemini, yerleşik araçları yürütür ve istemci tarafı işlev çağrıları oluşturulursa kullanıcıya teslim eder (hangisinin önce yürütüleceği, isteme ve modelin kararına bağlıdır). Şu bilgileri içeren bir yanıt gönderir:
- Araç çağrısının onayı
- Araç yanıtının sonuçları (model iki paralel işlev çağrısı oluşturduysa bu, JSON'dan sonra gelebilir)
- İşlevinizi çağırmak için yapılandırılmış JSON
- Bağlamı korumak için şifrelenmiş düşünce imzaları
- İşlevi uygulamanızda veya ortamınızda siz yürütürsünüz.
- Siz, Gemini'ın yanıtının tüm bölümlerini ve işlev çağrısı sonuçlarınızı döndürürsünüz.
- Gemini, birleştirilmiş tüm bağlamları kullanarak nihai yanıtı oluşturur.
Yerleşik ve özel araç kombinasyonu desteğini etkinleştirme ve bağlam dolaşımı örnekleri hakkında bilgi edinmek için Araç kombinasyonu kılavuzunu inceleyin.
Yapılandırılmış çıkışlar ve işlev çağrısı
Gemini, yapılandırılmış çıktılar üretmek için iki yöntem sunar. Modelin kendi araçlarınıza veya veri sistemlerinize bağlanarak ara adım atması gerektiğinde fonksiyon çağrısı özelliğini kullanın. Modelin nihai yanıtının belirli bir şemaya (ör. özel bir kullanıcı arayüzü oluşturmak için) kesinlikle uyması gerektiğinde Structured Outputs'u kullanın.
Araçlarla yapılandırılmış çıkışlar
Yapılandırılmış Çıkışlar'ı yerleşik araçlarla birleştirerek harici verilere veya hesaplamalara dayalı model yanıtlarının katı bir şemaya uymaya devam etmesini sağlayabilirsiniz.
Kod örnekleri için Araçlarla yapılandırılmış çıkışlar bölümüne bakın.