GSP1209

Genel Bakış

Google Gen AI SDK, Google'ın üretken yapay zeka API hizmetlerine yönelik birleşik bir arayüz sunar. Bu SDK, üretken yapay zeka özelliklerini uygulamalara ve hizmetlere entegre etme sürecini basitleştirerek geliştiricilerin çeşitli görevler için Google'ın gelişmiş yapay zeka modellerinden faydalanmasını sağlar. Bu laboratuvarda, Google Gen AI SDK'yı inceleyerek yapay zeka hizmetlerine bağlanmayı, çeşitli istemler göndermeyi ve Gemini'dan gelen yanıtları kişiselleştirmeyi öğreneceksiniz. Ayrıca üretken yapay zekanın gücünden kendi projelerinizde yararlanabilmeniz için daha gelişmiş tekniklerle uygulamalı deneyim kazanacaksınız.

Hedefler

Bu laboratuvarda, Python için Google Gen AI SDK'yı kullanarak Gemini da dahil olmak üzere Google'ın üretken yapay zeka hizmetleriyle ve modelleriyle etkileşim kurmayı öğreneceksiniz. Bahsedeceğimiz konular:

• Gen AI SDK'yı yükleme
• Bir API hizmetine bağlanma
• Metin ve çok formatlı istemler gönderme
• Sistem talimatlarını ayarlama
• Model parametrelerini ve güvenlik filtrelerini yapılandırma
• Model etkileşimlerini yönetme (çok adımlı sohbet, içerik akışı, eşzamansız istekler)
• İleri seviye özellikleri kullanma (parça sayımı, bağlamı önbelleğe alma, işlev çağırma, metin yerleştirmeleri)

Ön koşullar

Bu laboratuvara başlamadan önce şunlar hakkında bilgi sahibi olmanız gerekir:

• Python'da temel programlama
• Genel API kavramları
• Agent Platform Workbench'teki bir Jupyter not defterinde Python kodu çalıştırma

Kurulum ve şartlar

Laboratuvarı Başlat düğmesini tıklamadan önce

Buradaki talimatları okuyun. Laboratuvarlar süreli olduğundan duraklatılamaz. Start Lab'i (Laboratuvarı başlat) tıkladığınızda başlayan zamanlayıcı, Google Cloud kaynaklarının ne süreyle kullanımınıza açık durumda kalacağını gösterir.

Bu uygulamalı laboratuvarı kullanarak, laboratuvar etkinliklerini simülasyon veya demo ortamı yerine gerçek bir bulut ortamında gerçekleştirebilirsiniz. Bunu yapabilmeniz için size yeni, geçici kimlik bilgileri verilir. Bu kimlik bilgilerini laboratuvar süresince Google Cloud'da oturum açmak ve Google Cloud'a erişmek için kullanabilirsiniz.

Bu laboratuvarı tamamlamak için gerekenler:

• Standart bir internet tarayıcısına erişim (Chrome Tarayıcı önerilir)

Not: Bu laboratuvarı çalıştırmak için tarayıcıyı gizli modda (önerilen) veya gizli tarama penceresinde açın. Aksi takdirde, kişisel hesabınızla öğrenci hesabınız arasında oluşabilecek çakışmalar nedeniyle kişisel hesabınızdan ek ücret alınabilir.

• Laboratuvarı tamamlamak için yeterli süre (Laboratuvarlar başlatıldıktan sonra duraklatılamaz.)

Not: Bu laboratuvar için yalnızca öğrenci hesabını kullanın. Farklı bir Google Cloud hesabı kullanırsanız bu hesaptan ödeme alınabilir.

Laboratuvarınızı başlatma ve Google Cloud konsolunda oturum açma

1. Start Lab (Laboratuvarı Başlat) düğmesini tıklayın. Laboratuvar için ödeme yapmanız gerekiyorsa ödeme yöntemini seçebileceğiniz bir iletişim kutusu açılır. Sağdaki Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde şunlar yer alır:

   • Open Google Cloud console (Google Cloud konsolunu aç) düğmesi
   • Bu laboratuvarda kullanmanız gereken geçici kimlik bilgileri (kullanıcı adı ve şifre)
   • Bu laboratuvarda ilerlemek için gerekebilecek diğer bilgiler

   Laboratuvar zamanlayıcısının sayfanın üst kısmına yakın bir yerde bulunduğunu ve kalan süreyi gösterdiğini unutmayın.

2. Open Google Cloud console'u (Google Cloud konsolunu aç) tıklayın (veya Chrome Tarayıcı'yı kullanıyorsanız sağ tıklayıp Bağlantıyı gizli pencerede aç'ı seçin).

   Laboratuvar, kaynakları çalıştırır ve sonra "Oturum açın" sayfasını gösteren başka bir sekme açar.

   İpucu: Sekmeleri ayrı pencerelerde, yan yana açın.

   Not: Bir hesap seçin iletişim kutusunu görürseniz Başka bir hesap kullan'ı tıklayın.

3. Gerekirse aşağıdaki kullanıcı adını kopyalayıp Oturum açın iletişim kutusuna yapıştırın.

   {{{user_0.username | "Username"}}}

   Kullanıcı adını Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde de bulabilirsiniz.

4. Next'i (Sonraki) tıklayın.

5. Aşağıdaki şifreyi kopyalayıp Welcome (Hoş geldiniz) iletişim kutusuna yapıştırın.

   {{{user_0.password | "Password"}}}

   Şifreyi Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde de bulabilirsiniz.

6. Next'i (Sonraki) tıklayın.

   Önemli: Laboratuvarın sizinle paylaştığı giriş bilgilerini kullanmanız gerekir. Google Cloud hesabınızın kimlik bilgilerini kullanmayın. Not: Bu laboratuvarda kendi Google Cloud hesabınızı kullanabilmek için ek ücret ödemeniz gerekebilir.

7. Sonraki sayfalarda ilgili düğmeleri tıklayarak ilerleyin:

   • Hüküm ve koşulları kabul edin.
   • Geçici bir hesap kullandığınızdan, kurtarma seçenekleri veya iki faktörlü kimlik doğrulama eklemeyin.
   • Ücretsiz denemelere kaydolmayın.

Birkaç saniye sonra Google Cloud konsolu bu sekmede açılır.

Not: Google Cloud ürün ve hizmetlerine erişmek için gezinme menüsünü tıklayın veya Search (Arama) alanına hizmetin veya ürünün adını yazın.

1. görev: Not defterini Agent Platform Workbench'te açın

1. Google Cloud Console'daki Gezinme menüsünde () Agent Platform > Notebooks > Workbench'i (Aracı Platformu > Not Defterleri > Çalışma Alanı) tıklayın.

2. örneğini bulun ve JupyterLab'i aç düğmesini tıklayın.

Workbench örneğinizin JupyterLab arayüzü, yeni bir tarayıcı sekmesinde açılır.

2. görev: Not defterini ayarlayın

1. dosyasını açın.

2. Select Kernel (Çekirdek Seç) iletişim kutusunda, kullanılabilir çekirdekler listesinden Python 3 (Local) (Yerel) öğesini seçin.

3. Not defterinin Getting Started (Başlangıç) bölümündeki kodları çalıştırın. Project ID (Proje kimliği) ve Location (Konum) sizin için önceden yapılandırılır.

Not: Not defteri hücrelerini çalıştırdığınızda 429 yanıtı alırsanız hücreyi tekrar çalıştırmadan önce bir dakika bekleyin.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Kitaplıkları içe aktarın ve not defterini ayarlayın

3. görev: Model ile etkileşim kurun

Agent Platform'daki tüm yapay zeka modelleri ve API'ler hakkında daha fazla bilgi için Google modelleri ve Model Garden'a göz atın.

Model seçme

• Not defterinin Choose a model (Model seçme) bölümündeki kod hücrelerini çalıştırın.

Metin istemleri gönderme

İstemlerinize yanıt oluşturmak için generate_content yöntemini kullanın. generate_content işlevine metin gönderebilir ve yanıtın metin içeriğini almak için .text özelliğini kullanabilirsiniz.

• Not defterinin Send text prompts (Metin istemleri gönderme) bölümündeki kod hücrelerini çalıştırın.

Çok formatlı istemler gönderme

İstem isteklerinize metin, PDF belgesi, resim, ses ve video ekleyip metin veya kod biçiminde yanıtlar alabilirsiniz.

Dosya URL'sini, modele yapılan istekte doğrudan Part.from_uri bölümünde de iletebilirsiniz.

• Not defterinin Send multimodal prompts (Çok formatlı istemler gönderme) bölümündeki kod hücrelerini çalıştırın.

Sistem talimatlarını ayarlama

Sistem talimatları, model davranışını kontrol etmenizi sağlar. Modele görevi anlaması, daha özelleştirilmiş yanıtlar vermesi ve kullanıcı etkileşimiyle ilgili kurallara uyması için ek bağlam sağlamak üzere sistem talimatı ayarlayın.

• Not defterinin Set system instruction (Sistem talimatlarını ayarlama) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Model ile etkileşim kurun

4. görev: Modeli yapılandırın ve kontrol edin

Model parametrelerini yapılandırma

Modelin yanıt oluşturma şeklini kontrol etmek için modele gönderdiğiniz her çağrıya parametre değerleri ekleyebilirsiniz. Daha fazla bilgi edinmek için Parametre değerleriyle deneme yapma başlıklı makaleye bakın.

• Not defterinin Configure model parameters (Model parametrelerini yapılandırma) bölümündeki kod hücrelerini çalıştırın.

Güvenlik filtrelerini yapılandırma

Gemini API, belirli içerik türlerini kısıtlamak veya bunlara izin vermek için birden fazla filtre kategorisi genelinde ayarlayabileceğiniz güvenlik filtreleri sağlar. Kullanım alanınıza göre ayarlamalar yapmak için bu filtreleri kullanabilirsiniz. Ayrıntılı bilgi için Güvenlik filtrelerini yapılandırma başlıklı makaleye bakın.

Modellere istek gönderdiğinizde içerik analiz edilir ve içeriğe güvenlik derecesi atanır. Bu örnekte olduğu gibi, model yanıtlarını yazdırarak oluşturulan içeriğin güvenlik derecelerini inceleyebilirsiniz:

• Not defterinin Configure safety filters (Güvenlik filtrelerini yapılandırma) bölümündeki kod hücrelerini çalıştırın.

Çok adımlı sohbet başlatma

Gemini API, serbest ve çok adımlı sohbetler yapmanıza olanak tanır.

• Not defterinin Start a multi-turn chat (Çok adımlı sohbet başlatma) bölümündeki kod hücrelerini çalıştırın.

Oluşturulan çıkışı kontrol etme

Gemini API'deki kontrollü oluşturma özelliği, model çıkışını yapılandırılmış bir biçimle sınırlamanıza olanak tanır. Şemaları Pydantic modelleri veya JSON dizesi olarak girebilirsiniz.

Yanıt şemasını Python sözlüğünde de tanımlayabilirsiniz. Yalnızca aşağıdaki alanları kullanabilirsiniz. Diğer tüm alanlar yoksayılır.

• enum
• items
• maxItems
• nullable
• properties
• required

Bu örnekte, modele ürün yorum verilerini analiz etme, temel varlıkları ayıklama, duygu sınıflandırması yapma (çoktan seçmeli), ek açıklama sağlama ve sonuçları JSON biçiminde çıkış olarak verme talimatı vereceksiniz.

• Not defterinin Control generated output (Oluşturulan çıkışı kontrol etme) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Modeli yapılandırın ve kontrol edin

5. görev: Model etkileşimini yönetin

İçerik akışı oluşturma

Varsayılan olarak, model tüm oluşturma işlemini tamamladıktan sonra yanıt verir. Yanıt oluşturulurken generate_content_stream yöntemini kullanarak yanıtı akış halinde görüntüleyebilirsiniz. Model, yanıtının tamamının oluşturulmasını beklemeden yanıtı parça parça döndürür.

• Not defterinin Generate content stream (İçerik akışı oluşturma) bölümündeki kod hücrelerini çalıştırın.

Eşzamansız istekler gönderme

client.aio modülünü kullanarak eşzamansız istekler gönderebilirsiniz. Bu modül, client modülünde bulunan tüm benzer eşzamansız yöntemleri gösterir.

Örneğin, client.aio.models.generate_content, client.models.generate_content'in eşzamansız versiyonudur.

• Not defterinin Send asynchronous requests (Eşzamansız istekler gönderme) bölümündeki kod hücrelerini çalıştırın.

Parça sayma ve hesaplama

Gemini API'ye istek göndermeden önce giriş parçalarının sayısını hesaplamak için count_tokens yöntemini kullanabilirsiniz. Ayrıntılı bilgi için Parçaları listeleme ve sayma sayfasına bakın.

Parça sayma

• Not defterinin Count tokens (Parça sayma) bölümündeki kod hücrelerini çalıştırın.

Parça hesaplama

• Not defterinin Compute tokens (Parça hesaplama) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Model etkileşimini yönetin

6. görev: İleri seviye özellikler

İşlev çağırma

İşlev çağırma sayesinde, kullanıcının istemlerine yanıt vermek için kullanılabilecek bir dizi araç sağlayabilirsiniz. Kodunuzda bir işlevin açıklamasını oluşturup bu açıklamayı bir istekteki dil modeline geçirirsiniz. Modelin verdiği yanıt, açıklamaya uyan bir işlevin adını ve işlevi çağırmak için gereken bağımsız değişkenleri içerir.

İşlev çağırmayla ilgili daha fazla örnek için bu laboratuvara bakın.

• Not defterinin Function calling (İşlev çağırma) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. İşlev çağırma

Bağlamı önbelleğe alma özelliğini kullanma

Bağlamı önbelleğe alma özelliği, sık kullanılan giriş parçalarını özel bir önbellekte depolamanıza ve sonraki isteklerde bunlara başvurmanıza olanak tanır. Bu sayede, modele aynı parça grubunu tekrar tekrar iletme ihtiyacı ortadan kalkar.

Önbellek oluşturma

• Not defterinin Create a cache (Önbellek oluşturma) bölümündeki kod hücrelerini çalıştırın.

Önbelleği kullanma

• Not defterinin Use a cache (Önbelleği kullanma) bölümündeki kod hücrelerini çalıştırın.

Önbelleği silme

• Not defterinin Delete a cache (Önbelleği silme) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Bağlamı önbelleğe alma özelliğini kullanma

Metin yerleştirmeleri alma

embed_content yöntemini kullanarak bir metin snippet'ini metin yerleştirme olarak alabilirsiniz. Tüm modeller varsayılan olarak 768 boyutlu bir çıkış üretir. Ancak bazı modeller, kullanıcılara 1 ile 768 arasında bir çıkış boyutu seçme seçeneği sunar. Ayrıntılar için Agent Platform metin yerleştirmeleri API'si sayfasını inceleyin.

• Not defterinin Get text embeddings (Metin yerleştirmeleri alma) bölümündeki kod hücrelerini çalıştırın.

Hedefi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Metin yerleştirmeleri alma

Tebrikler!

Tebrikler! Google Gen AI SDK'yı başarıyla incelediniz. Yapay zeka hizmetlerine bağlanmayı, çeşitli istemler göndermeyi ve Gemini modelinden gelen yanıtları kişiselleştirmeyi öğrendiniz. Ayrıca etkileşimleri yönetme, bağlamı önbelleğe alma ve hatta yerleştirmelerle çalışma gibi daha ileri tekniklerle ilgili uygulamalı deneyim kazandınız. Artık kendi projeleriniz için üretken yapay zekanın gücünden yararlanmaya hazırsınız.

Sonraki adımlar / Daha fazla bilgi

Üretken yapay zeka ve Gemini Enterprise Agent Platform hakkında daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin:

• Temel model özellikleri hakkında bilgi edinmek için Google DeepMind Gemini Modellerine Genel Bakış başlıklı makaleyi okuyun.
• Tasarım, ölçeklendirme ve dağıtım yönergeleri için resmi Agent Platform Documentation'ı (Aracı Platformu Belgeleri) inceleyin.
• Özel ajanları nasıl oluşturacağınızı ve yöneteceğinizi anlamak için Agent Platform Ajanlara Genel Bakış başlıklı makaleyi inceleyin.
• Video eğitimleri ve ürün demoları için YouTube'da Üretken Yapay Zeka oynatma listesini izleyin.
• Google Cloud Üretken Yapay Zeka deposundaki diğer not defterlerine ve örneklere göz atın.
• Özel ajan şablonları için Google Agent Development Kit (ADK) Örnekleri deposunu inceleyin.

Google Cloud eğitimi ve sertifikası

...Google Cloud teknolojilerinden en iyi şekilde yararlanmanıza yardımcı olur. Derslerimizde teknik becerilere odaklanırken en iyi uygulamalara da yer veriyoruz. Gerekli yetkinlik seviyesine hızlıca ulaşmanız ve öğrenim maceranızı sürdürebilmeniz için sizlere yardımcı olmayı amaçlıyoruz. Temel kavramlardan ileri seviyeye kadar farklı eğitim programlarımız mevcut. Ayrıca, yoğun gündeminize uyması için talep üzerine sağlanan, canlı ve sanal eğitim alternatiflerimiz de var. Sertifikasyonlar ise Google Cloud teknolojilerindeki becerilerinizi ve uzmanlığınızı doğrulamanıza ve kanıtlamanıza yardımcı oluyor.

Kılavuzun Son Güncellenme Tarihi: 24 Mart 2026

Laboratuvarın Son Test Edilme Tarihi: 24 Mart 2026

Telif Hakkı 2026 Google LLC. Tüm hakları saklıdır. Google ve Google logosu, Google LLC şirketinin ticari markalarıdır. Diğer tüm şirket ve ürün adları ilişkili oldukları şirketlerin ticari markaları olabilir.