Gemini 3 ve ADK ile kendi "Pazarlıkçı Dükkan Sahibi" Temsilcinizi oluşturun

1. Genel Bakış

Bu codelab'de eğlenceli bir şey oluşturacağız. Yapay zeka temsilcinizin en akıllı ve en esprili dükkan sahibi olduğu dijital bir pazar hayal edin.

Yeni yapay zeka dükkan sahibiniz Raju ile tanışın. Muhteşem dijital eserler satıyor ancak bunları almak için pazarlık yapmanız gerekiyor.

Raju'yu hayata geçirmek için Gemini 3 (beyin), ADK (Agent Development Kit - vücut) ve Google Cloud Run'ı (dükkan konumu) kullanacağız.

Öğrenecekleriniz

Modern bir Agentic Application için tüm yığını oluşturacağız:

• The Shop (Cloud Run): Uygulamanızın internetteki yeri.
• Beyin (Gemini 3): Raju'nun gücünü sağlayan zeka.
• The Body (ADK): Beyni araçlara bağlayan çerçeve.
• Envanter (Araçlar): Raju'nun stok kontrolü için kullandığı Python kodu.
• Vitrin (kullanıcı arayüzü): Müşterilerinizin gördüğü arayüz.

Bu eğitimde şunları öğreneceksiniz:

• "Digital Dukaan"ınızı (Google Cloud Ortamı) kurun.
• Raju'yu "işe alın" (3 Gemini API anahtarı edinin).
• Raju'ya pazarlık yapmayı öğret (Sistem Talimatları ve Karakterler).
• Raju'ya envanter verin (ADK Araçları).
• Vitrin (ön uç kullanıcı arayüzü) oluşturun.
• Faaliyet gösteriyor (Cloud Run'a dağıt).

İhtiyacınız olanlar

• Google Cloud projesi.
• Mizah anlayışı (pazarlık için).
• Temel Python bilgisi

2. Dukaan'ı (Cloud projesi) ayarlama

Raju'yu oluşturmadan önce bir mağaza konumuna ihtiyacımız var. Bulutta bu, faturalandırma hesabı olan bir proje anlamına gelir.

Deneme Faturalandırma Hesabı

Eğitmen eşliğinde atölye çalışması: Atölye çalışmasına katılıyorsanız eğitmeninizin sağladığı kullanım bağlantısını kullanabilirsiniz.

Kendi Kendine Çalışma: Kendi kendine çalışma kullanıcısıysanız bu laboratuvarı çalıştırmak için deneme faturalandırma hesabı kullanabilirsiniz.

Ayrıntılı talimatlara mı ihtiyacınız var? Cloud Codelab Kredileri kılavuzunu inceleyin.

1. adım: Faturalandırmayı etkinleştirin

1. Kullanım bağlantısını gizli pencerede açın.
2. Kişisel Gmail hesabınızla oturum açın.
3. Kredilere eriş düğmesini tıklayın.
4. Deneme sürenizi etkinleştirmek için e-postanızı onaylayın ve şartları kabul edin.

2. adım: Proje oluşturun

1. Proje oluşturma sayfasına gidin.
2. Benzersiz bir proje adı girin (ör. raju-shop-agent).
3. "Faturalandırma Hesabı" açılır listesinde deneme faturalandırma hesabınızı seçin.
4. OLUŞTUR'u tıklayın ve projenin hazır olmasını bekleyin.

3. adım: Faturalandırma bağlantısını doğrulayın

1. Bağlı Faturalandırma Hesabı Sayfası'na gidin.
2. "Faturalandırma hesabı bağla" seçeneğini görüyorsanız bu seçeneği tıklayın.
3. Deneme Faturalandırma Hesabı'nın seçildiğinden emin olun.
4. Artık oluşturmaya hazırsınız.

Özet

Bu adımda, uygulamanızın temelini oluşturarak Google Cloud projenizi ve faturalandırma hesabınızı ayarlarsınız.

Ardından, Ortamınızı Hazırlama bölümünde kodu oluşturacağınız çalışma alanını ayarlayacağız.

3. Stant Oluşturma (Ortam Kurulumu)

Kodunuzu çalıştırmak için bir yere ihtiyacınız vardır. İki seçeneğiniz vardır:

1. seçenek: Google Cloud Shell (önerilir)

Cloud Shell, ihtiyacınız olan her şeyin (Python, gcloud CLI, git) önceden yüklendiği tarayıcı tabanlı bir terminaldir. Kalıcı depolama alanına sahiptir ve her yerden çalışır.

1. Cloud Shell'i etkinleştirme

Google Cloud Console üstbilgisinin sağ üst kısmındaki "Cloud Shell'i etkinleştir" simgesini (terminal simgesi) tıklayın.

Cloud Shell başlatılır. Bu kapsamda yapabileceğiniz işlemler:

• Yetkilendirme: İstenirse Cloud Shell'in sizin adınıza Google Cloud API'lerine çağrı yapmasına izin vermek için Yetkilendir'i tıklayın.
• Temel hazırlık: Cloud Shell, oturumunuz için geçici bir sanal makine sağlar.
• Bağlanma: Ardından bu sanal makineye bağlanır. Bu işlemin tamamlanması bir veya iki dakika sürebilir.

Komut istemini (user@cloudshell:~ $) görene kadar bekleyin.

2. Proje kurulumunu doğrulama

Cloud Shell genellikle mevcut projenizi otomatik olarak seçer. Tedbiri elden bırakmamak için doğrulayın:

gcloud config get-value project

Proje kimliğinizi (raju-shop-agent) döndürmüyorsa manuel olarak ayarlayın:

gcloud config set project raju-shop-agent

2. seçenek: Yerel terminal

Kendi dizüstü bilgisayarınızın terminalini (iTerm, PowerShell vb.) kullanmayı tercih ediyorsanız biraz daha fazla kurulum yapmanız gerekir.

1. Ön koşulları yükleme

Aşağıdakilerin yüklü olduğundan emin olun:

• Python 3.10 veya sonraki sürümler
• Google Cloud SDK (gcloud KSA)

2. Giriş yapma ve gcloud'u yapılandırma

Google Cloud CLI'yı başlatın ve hesabınızda oturum açın:

gcloud auth login

Projenizi ayarlayın (raju-shop-agent yerine gerçek proje kimliğinizi yazın):

gcloud config set project raju-shop-agent

Uygulama varsayılan kimlik bilgilerini ayarlayın (bu, yerel araçların Google Cloud ile iletişim kurmasına yardımcı olur):

gcloud auth application-default login

Özet

Bu adımda, geliştirme ortamınızı (Cloud Shell veya Yerel) seçip yapılandırdınız.

Ardından, Meeting Gemini CLI'da daha hızlı geliştirmeler yapmamıza yardımcı olacak araçla tanışacağız.

4. Asistanınızla (Gemini CLI) tanışın

Artık yapay zeka geliştirme alanındaki yeni en iyi arkadaşınızla tanışın: Gemini CLI!

Gemini CLI, şu konularda size yardımcı olan güçlü bir komut satırı arayüzüdür:

• İş Akışlarını Otomatikleştirme: Yapay zeka projelerinizi verimli bir şekilde yönetin.
• Kod oluşturma: Kod, kullanıcı arayüzü ve hatta tüm dosyaları oluşturun.
• Uzantı Ekosistemi: Çeşitli uzantılarla (ör. daha sonra kullanacağımız Cloud Run uzantısı) özelliklerini genişletin.

Profesyonel olmak ister misiniz? Gemini CLI'nin yapabilecekleri hakkında kapsamlı bir inceleme için Gemini CLI Hands-On Codelab'e göz atın. Ayrıca Gemini CLI Dokümanları'nın tamamını inceleyebilirsiniz.

1. Gemini CLI'yı yükleme (yalnızca yerel terminal)

Yerel dizüstü bilgisayar terminalinizi kullanıyorsanız:

Not: Gemini CLI'nin kullanılabilmesi için sisteminizde Node.js (v20 veya sonraki bir sürüm) ve npm'nin yüklü olması gerekir.

npm install -g @google/gemini-cli

Google Cloud Shell kullanıyorsanız:

Gemini CLI, Cloud Shell'de önceden yüklü olarak sunulur. Bu nedenle, herhangi bir yükleme yapmanız gerekmez.

2. Başlatma ve Kimlik Doğrulama

Cloud Shell'inizde (veya yerel terminalinizde) yeni bir terminal penceresi (veya sekme) açın ve Gemini CLI'yı başlatın:

gemini

İlk çalıştırma kurulumu: CLI'yi ilk kez çalıştırıyorsanız hızlı bir kurulum sürecinde size yol gösterir.

• Kimlik doğrulama: Oturum açmanız istenir. Gemini modelleri için sunulan cömert ücretsiz kotalardan yararlanmak üzere kişisel Gmail hesabınızı kullanmanızı öneririz.
• Proje bağlamı: Kod bağlamınızı anlaması için gemini komutunu proje klasörünüzden çalıştırmanız en iyi uygulamadır. (Klasörü henüz oluşturmadığımız için şu anlık ana dizininizden çalıştırmanızda sorun yoktur.)

3. Merhaba deyin.

gemini> istemini gördüğünüzde beyninizin bağlı olduğundan emin olmak için bir test yapmayı deneyin:

Hi

Modelden samimi bir yanıt alırsınız.

4. Temel Komutlar

• /quit: Gemini CLI'dan çıkıp standart terminalinize dönmek için bunu yazın.
• /help: Kullanılabilir tüm komutların listesini görün.

Uzman İpucu: Bu "Gemini Terminali"ni ayrı bir sekmede açık tutun. Bu terminali kod oluşturmak ve uygulamanızı dağıtmak için kullanırken diğer terminaliniz uygulama sunucusunu çalıştırır.

Özet

Bu adımda Gemini CLI'yı yüklediniz, kimliğinizi doğruladınız ve doğrulama işlemini gerçekleştirdiniz.

Ardından, Opening Shop (The Code)'da mağazamızın iskeletini oluşturmak için Agent Development Kit'i (ADK) kullanacağız.

5. Rafları Doldurma (Proje Kurulumu)

Sıfırdan başlamayız (akıllı dükkan sahipleri zamandan tasarruf eder). Agent Development Kit (ADK)'yi kullanacağız.

ADK nedir?

ADK, "mağaza yönetim sisteminizdir". Bu esnek çerçeve şunları ele alır:

• Orkestrasyon: Karmaşık görevleri yönetme (ör. Raju'nun bir müşteriyle konuşurken envanteri kontrol etmesi).
• Durum Yönetimi: Müşterinin adını ve 5 dakika önce ne istediğini hatırlama.
• Araçlar: Harici sistemlere (ör. envanter veritabanınız) bağlanma.

Üretime hazır bir "Dukaan"ı anında oluşturmak için Agent Starter Pack'i kullanacağız. Satışa odaklanabilmemiz için bize güvenli ve ölçeklenebilir bir temel sunuyor.

Aracınızı oluşturmak için Cloud Shell terminalinizde (veya yerel terminalinizde) şu komutu çalıştırın:

uvx agent-starter-pack create raju-shop

CLI, mağazanızı yapılandırmak için size birkaç soru sorar. Aşağıdaki seçenekleri belirleyin (numarayı yazıp Enter tuşuna basın):

1. Temsilci Türü: 1'ı (adk_base - Temel bir ReAct temsilcisi) seçin.
2. Deployment Target: (Dağıtım Hedefi) 2'ı (Cloud Run - Sunucusuz kapsayıcı yürütme) seçin.
3. Oturum Türü: 1'ı (In-memory session - Basit ve hızlı) seçin.
4. CI/CD Runner: 3'ı (Skip - Şimdilik manuel olarak dağıtacağız) seçin.

İşlemin tamamlanmasını bekleyin. İşlem tamamlandıktan sonra mağaza dizininizi girin ve bağımlılıkları yükleyin:

cd raju-shop
make install
source .venv/bin/activate

Aracıyı Keşfetme ve Yapılandırma

Başlangıç paketi ayarlandıktan sonra yapıyı inceleyin.

1. Klasör Yapısını Kontrol Etme

Mağazanızın nasıl düzenlendiğini görmek için aşağıdaki komutu çalıştırın:

tree .

Şuna benzer bir yapı görmeniz gerekir:

.
├── app
│   ├── __init__.py
│   ├── agent.py
│   ├── app_utils
│   │   ├── telemetry.py
│   │   └── typing.py
│   └── fast_api_app.py
├── Dockerfile
├── GEMINI.md
├── Makefile
├── pyproject.toml
├── README.md
├── tests
│   ├── integration
│   │   ├── test_agent.py
│   │   └── test_server_e2e.py
│   └── unit
│       └── test_dummy.py
└── uv.lock

En önemli dosya app/agent.py. Raju'nun beyni burada yaşıyor!

2. Kodu İnceleme

Cloud Shell Düzenleyicinizde (veya yerel IDE) app/agent.py dosyasını açıp hızlıca inceleyin:

• root_agent = Agent(...): Bu, yapay zekanızı tanımlar. model (beyin) ve tools (eller) vardır.
• Araçlar: get_weather gibi Python işlevlerini görürsünüz. Bunlar, temsilcinin kullanabileceği araçlardır.
• app = App(...): Bu, temsilcinizi bir web sunucusuna sarmalayarak onunla iletişim kurmamızı sağlar.

Daha ayrıntılı bilgi edinmek mi istiyorsunuz? ADK Python Kılavuzu ve LLM Aracıları dokümanlarına göz atın.

Yerel olarak test etme

Cloud Shell terminalinizde (veya yerel terminalinizde) aracıyı çalıştırın:

adk web

Bu komut, 8000 bağlantı noktasında yerel bir web sunucusu başlatır.

Cloud Shell kullanıyorsanız:

1. Web Önizlemesi düğmesini (sağ üstte, göz simgesi) tıklayın.
2. Bağlantı noktasını değiştir'i seçin.
3. 8000 girin ve Change and Preview'u (Değiştir ve Önizle) tıklayın.

Yerel Terminal'i kullanıyorsanız:

1. Tarayıcınızı açıp http://localhost:8000 adresine gidin.

Kullanıcı arayüzü açıldıktan sonra:

1. "app"i seçin: Sol üstteki açılır listede app adlı aracıyı seçtiğinizden emin olun (root_agent veya test_agent görünürse bunları yoksayın).
2. Merhaba deyin: "Merhaba!" yazıp yanıt verip vermediğini kontrol edin.

İşiniz bittiğinde adk web sunucusunu durdurmak için terminalinizde Ctrl+C tuşuna basın.

Özet

Bu adımda projenizi iskeletlendirdiniz, Gemini API için yapılandırdınız ve ilk aracınızı yerel olarak başarıyla çalıştırdınız.

Ardından, Training Raju (The Persona) bölümünde aracımıza bir kişilik ve ad vereceğiz.

6. Eğitim Raju'su (Karakter)

Şu anda temsilci sıkıcı. Ona bir kişilik vereceğiz.

Kod yazmak yerine Gemini'a ne istediğimizi söyleyeceğiz.

1. Persona'yı tanımlama

Terminalinizde şu komutu çalıştırarak Raju'ya kim olduğunu "öğretin":

gemini "In agent.py, update the root_agent instruction. You are Raju, a bargaining shopkeeper in a digital bazaar. You sell: Brass Lamp (50 coins), Silk Scarf (500 coins). Your goal is to sell high and be funny. Speak with an Indian-English flair."

2. Kodu doğrulama

app/agent.py adlı kişiyi aç. Gemini'ın sizin için sistem talimatını yazdığını görürsünüz.

3. Yerel olarak test etme

Şimdi Raju ile sohbet edin. Cloud Shell terminalinizde (veya yerel terminalinizde):

adk web

Web kullanıcı arayüzünü (Web Önizlemesi bağlantı noktası 8000 veya localhost:8000) açın, app aracısını seçin ve şu istemleri deneyin:

• "Pirinç lambayı istiyorum ama 50 jeton çok fazla!"
• "Ne satıyorsun arkadaşım?"

Tepkisini görün. Komik ve dramatik olmalı ancak çok ucuza satmayı reddetmelidir.

Özet

Bu adımda, benzersiz bir kişiliğe sahip, pazarlıkçı bir dükkan sahibi olan "Raju"yu oluşturmak için temsilcinin sistem talimatlarını özelleştirdiniz.

Ardından, Raju'ya Envanter (Araç Ekleme) bölümünde gerçek stokunu kontrol etme olanağı sunacağız.

7. Envanter (Araç Ekleme)

Raju'nun stok durumu hakkında bilgi sahibi olması gerekiyor. Ona bir "veritabanı" ve bunu kontrol etmesi için bir araç vereceğiz.

1. Aracı oluşturma

Envanteri ve aracı oluşturup Raju'ya bağlamak için şu tek komutu çalıştırın:

gemini "In agent.py, create a dictionary INVENTORY with items: Brass Lamp (price 50, stock 5), Silk Scarf (price 500, stock 2), Taj Mahal (price 2000, stock 0). Then create a tool function check_inventory(item_name) that checks this dict. Finally, update the root_agent to use this tool and remove the default weather tools."

2. Magic'i doğrulama

app/agent.py uygulamasını tekrar açın. Gemini'ın şu özelliklere sahip olduğunu göreceksiniz:

1. INVENTORY sözlüğünü oluşturdu.
2. check_inventory Python işlevini yazmış olmanız gerekir.
3. Aracı tanımındaki tools=[...] listesi güncellendi.

3. Envanteri test etme

1. Sunucuyu yeniden başlatın (Ctrl+C, ardından adk web).
2. Raju'ya Sor:
   • "Tac Mahal'in fotoğrafı var mı?" (HAYIR demeli, stok 0 olmalı.)
   • "İpek eşarbın fiyatı ne kadar?" (Gerçek fiyatı kontrol etmelidir.)

Profesyonel İpucu: Sohbet ederken terminal günlüklerinize bakın. Raju aracı her kullandığında DEBUG: Checking inventory... simgesini görmelisiniz.

Özet

Bu adımda bir check_inventory aracı uyguladınız, varsayılan dağınıklığı kaldırdınız ve aracı, temsilcinize bağladınız.

Ardından, Raju's Shop Goes Live (Deploying the Backend) başlıklı bölümde Raju'yu buluta taşıyacağız.

8. Raju's Shop Goes Live (Arka Uç Dağıtımı)

Dünyaya açılma zamanı! Vitrin oluşturmadan önce Raju'nun beynini ve envanterini (temsilciniz) buluta dağıtırız.

Önemli: Terminal Yönetimi

Önceki adımdan geçerli terminalinizde adk web çalışıyor olabilir.

• Yerel olarak test etmeye devam etmek istiyorsanız Çalışmaya devam et'i seçin.
• Aşağıdaki dağıtım adımları için YENİ bir Terminal penceresi/sekmesi açın.
• Not: agent.py değerini her değiştirdiğinizde değişikliklerin geçerlilik kazanması için Durdur (Ctrl+C) ve Yeniden Başlat'ı adk web çalıştırmanız gerekir.

1. Gemini CLI'yı hazırlama

YENİ terminal pencerenizde:

1. Gemini CLI'da olup olmadığınızı kontrol edin (gemini> istemini bulun).
2. Bu durumda, standart kabuğa çıkmak için /quit yazın.
3. Proje klasöründe olduğunuzdan emin olun:

   cd raju-shop
   

2. Cloud Run uzantısını yükleme

Cloud Shell terminalinizde (veya yerel terminalinizde) Gemini CLI için Cloud Run uzantısını yükleyin:

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

3. Gemini CLI'yı yeniden başlatma

Yeni uzantıyı kullanmak için Gemini CLI'yı tekrar başlatın:

gemini

Gemini CLI istemini görürsünüz.

4. Temsilciyi dağıtma

Gemini CLI uzantılarını kullanmanın iki yolu vardır:

1. seçenek: Eğik çizgi komutu (manuel) Komutu ve işaretleri açıkça yazabilirsiniz:

/deploy --source . --name raju-agent --region us-central1 --allow-unauthenticated

2. Seçenek: Doğal Dil (Önerilir) Bu, daha kolay ve daha güçlü bir yöntemdir. Gemini'dan bunu sizin için yapmasını isteyebilirsiniz. Gemini, doğru araçları çağırmak için MCP sunucusunu kullanır.

Bu istemi Gemini CLI'ya yapıştırmayı deneyin:

Proje kimliğinizi kontrol edin: Aşağıdaki istemde raju-shop-agent yerine Google Cloud proje kimliğinizi girin. Bu bilgiyi Google Cloud Console'un sol üst kısmındaki açılır listede veya standart terminalinizde gcloud config get-value project komutunu çalıştırarak bulabilirsiniz.

Deploy this agent app to cloud run on google cloud using the cloud-run MCP server.
Use project raju-shop-agent in us-central1 region.
Name the service raju-agent.
IMPORTANT: Make sure to allow unauthenticated invocations so my frontend can talk to it.

KSA, cloud-run aracını kullanmak için onay isteyebilir. Onaylamak için Enter tuşuna basın (veya y yazın).

Sihri Bekleyin: Bu işlem 2-3 dakika sürer. İşlem tamamlandığında aşağıdaki gibi bir başarı mesajı görürsünüz:

✦ I've successfully deployed your agent app to Cloud Run.

  Service Details:
   * Service Name: raju-agent
   * Project: raju-shop-agent
   * Region: us-central1
   * URL: https://raju-agent-xyz123-uc.a.run.app
   * Console: View in Google Cloud Console (...)

Sorun giderme: Bir sorunla karşılaşırsanız Gemini CLI'a hatayla ilgili sorunuzu İngilizce olarak sorabilirsiniz. Örneğin: "İzin hatası nedeniyle başarısız oldu. Bu sorunu nasıl düzeltebilirim?"

5. Dağıtımı doğrulama

Dağıtım tamamlandığında Gemini CLI, Hizmet URL'si sağlar. Bu URL'yi kopyalayın.

Tarayıcı Kontrolü (Çalışıyor mu?) URL'yi tarayıcınıza yapıştırın.

• Başarılı: FastAPI Documentation (Swagger UI) veya genel bir ADK açılış sayfası görmeniz gerekir. Bu, Cloud Run hizmetinizin çalıştığını ve erişilebilir olduğunu onaylar.
• Başarısız: 403 Forbidden hatası alırsanız dağıtım isteminizde "kimliği doğrulanmamış çağırmalara" izin vermeyi unutmuş olabilirsiniz.

Bir sonraki adımda uygun bir ön uç oluşturarak gerçek pazarlık mantığını test edeceğiz.

Özet

Bu adımda, Gemini CLI uzantısını kullanarak aracı arka ucunuzu Google Cloud Run'a dağıttınız ve herkese açık bir URL kullanarak erişilebilir hale getirdiniz.

Ardından, Building the Shopfront (Frontend UI) başlıklı bölümde müşterilerin Raju ile konuşabileceği güzel bir vitrin oluşturacağız.

9. Mağazayı dekore etme (ön uç kullanıcı arayüzü)

Metin terminali sıkıcıdır. Canlı bir vitrin istiyoruz.

ADK API'nin İşleyiş Şekli

Özel bir kullanıcı arayüzü oluşturmak için temsilci arka ucunuzla nasıl iletişim kuracağınızı anlamanız gerekir. 2 adımlı bir akış izler:

1. Oturumu Başlatma: Sohbet etmeden önce bir oturum kimliği (ör. alışveriş sepeti) oluşturmanız gerekir.
   • POST /apps/app/users/{user_id}/sessions/{session_id}
2. Mesaj Gönderme: Konuşmak için metninizi çalıştırma uç noktasına gönderirsiniz.
   • POST /run (Yük; appName, userId, sessionId ve text öğelerini içerir.)
3. Daha fazla bilgi: ADK Runtime API ve Python API Referansı belgelerini inceleyin.

Bu mantığı, ön ucumuzu oluşturmak için kullanacağız.

Bu arayüzü oluşturmanın iki yolu vardır:

1. seçenek: Google Antigravity (Önerilir - Yalnızca yerel)

Yerel makinenizde çalışıyorsanız en iyi deneyim için Google Antigravity'yi kullanın. Bu, tüm kullanıcı arayüzünü "vibe code " yapmanıza olanak tanıyan, yapay zeka destekli bir IDE'dir.

Not: Antigravity, masaüstü uygulamasıdır. Cloud Shell kullanıyorsanız 2. Seçenek'e geçin.

1. İndirme ve yükleme

Google Antigravity indirme sayfasından işletim sisteminize yönelik yükleyiciyi indirip yükleyin.

2. Çalışma alanınızı açma

Antigravity'yi başlatın. raju-shop klasörünüzü Workspace olarak açın. Bu sayede yapay zeka, projenizin tamamı hakkında bağlam bilgisi edinir.

3. Temsilci Yöneticisi ile kullanıcı arayüzü oluşturma

Kodu satır satır yazmak yerine, Agent Manager'ı kullanarak yapay zeka aracısından bunu bizim için yapmasını isteyeceğiz.

1. Temsilci Yöneticisi sohbet arayüzünü bulun (genellikle sağ taraftadır).
2. Aşağıdaki istemi sohbete yapıştırın:

Create a single file HTML chat interface named `index.html`. It should have a colorful header that says 'Raju's Royal Artifacts'. It should look like an Indian market stall with orange and pink colors.

**Backend Integration:**
The chat should send messages to my deployed agent at: <YOUR_DEPLOYED_AGENT_URL>

**API Logic:**
1. **On Load:** Generate a random userId and sessionId. Call `POST /apps/app/users/{userId}/sessions/{sessionId}` to initialize.
2. **On Send:** Call `POST /run` with a JSON payload containing `appName: "app"`, `userId`, `sessionId`, and `newMessage: { role: "user", parts: [{ text: userInput }] }`.
3. **Display:** Show the user's message and the agent's response (from `content.parts[0].text`).

(Yer tutucu URL'yi, dağıtım adımındaki gerçek hizmet URL'nizle değiştirdiğinizden emin olun.)

1. Temsilcinin sizin için kodu yazmasını izleyin. Oluşturulan dosyayı anında görmek için Düzenleyici Görünümü'ne geçebilirsiniz.

4. Test Your Shop Front

Google Antigravity'de yerleşik önizleme özellikleri bulunur. Mağaza vitrininizin canlı halini görmek için "Önizleme" düğmesini (genellikle göz simgesi) tıklayın. Alternatif olarak, python3 -m http.server 8000 ile yerel olarak yayınlayın.

Bu güçlü IDE'de gerçekten uzmanlaşmak için Google Antigravity ile Başlarken Codelab'ini tamamlamanızı öneririz.

2. seçenek: Gemini CLI (Cloud Shell ile uyumlu)

Cloud Shell'deyseniz ön ucu saniyeler içinde oluşturmak için güvenilir Gemini CLI'nizi kullanabilirsiniz.

Terminalinizde şu komutu çalıştırın:

gemini "Create a single file HTML chat interface named index.html. Header: 'Raju\'s Royal Artifacts', Indian market theme (orange/pink). Backend: <YOUR_DEPLOYED_AGENT_URL>. Logic: On load, generate random user/session IDs and POST to /apps/app/users/{uid}/sessions/{sid}. On chat, POST to /run with appName='app', userId, sessionId, and newMessage structure. Parse the JSON response to show the agent text." > index.html

(

ile değiştirin.)

Özet

Bu adımda, canlı temsilci arka ucunuza bağlanan özel bir HTML ön ucu için "vibe code" oluşturmak üzere Google Antigravity'yi kullandınız.

Ardından, Vitrini İnternette Yayınlama bölümünde bu vitrini web'de barındırarak resmi tamamlayacağız.

10. Büyük Açılış (Ön Ucu Dağıtma)

Raju internette (arka uç) ancak dükkanının herkese açık bir adresi (ön uç) olması gerekiyor. Google Antigravity'den kullanıcı arayüzümüzü buluta dağıtmasını isteyin.

1. Aracı Yöneticisi'nden Dağıtmasını İste

IDE'den ayrılmamıza gerek yoktur. Agent Manager'dan dağıtımı sizin için yapmasını isteyin.

Bu istemi sohbete yapıştırın:

"index.html adlı öğemi Google Cloud Run'da statik web sitesi olarak dağıt. Hizmeti adlandırın raju-shop-frontend. Herkese açık olduğundan emin olun."

2. Watch the Magic

Temsilci büyük olasılıkla:

1. Statik dosyaları sunmak için Dockerfile veya yapılandırma oluşturun (ör. nginx veya Python kullanma).
2. Container görüntüsünü oluşturun.
3. gcloud run deploy komutunu sizin için çalıştırır.

3. Mağazanızı ziyaret edin.

Temsilci işlemi tamamladığında size bir URL verir (ör. https://raju-shop-frontend-xyz.run.app) seçeneğini tıklayın.

Tebrikler! Artık tamamen kullanıma hazır, yapay zeka destekli bir pazarlıkçı dükkan sahibi uygulamanız var. Bağlantıyı arkadaşlarınıza gönderin ve indirim alıp alamadıklarını görün.

Özet

Bu adımda, ön uç uygulamanızı container'a dönüştürmek ve Cloud Run'a dağıtmak için Antigravity Agent Manager'ı kullandınız.

Artık tam yığını oluşturdunuz. Kapanış Saati (Sonuç) bölümünde özetleyeceğiz.

11. Kapanış Saati (Sonuç)

Tebrikler! "Pazarlıkçı Dükkan Sahibi" Agent Challenge'ı başarıyla tamamladınız. Raju'yu sadece bir fikirden dijital pazarda tamamen dağıtılmış, etkileşimli bir yapay zeka dükkan sahibine dönüştürdünüz. Agentic geliştirmenin gücünü ilk elden deneyimlediniz.

Yolculuğunuzun Özeti:

• Google Cloud: Projenizi ve faturalandırma hesabınızı ayarlayın ve aracınızı Cloud Run'a dağıtın.
• Gemini 3: Raju'nun karakterine ve pazarlık becerilerine güç veren akıllı beyin.
• Temsilci Geliştirme Kiti (ADK): Yerleşik Gözlemlenebilirlik (Telemetri) ile üretim için hazır bir temel sağlayan ve temsilcinizi ilk günden itibaren sağlam hale getiren çerçeve.
• Gemini CLI: Hızlı görevler, testler ve uzantılar için komut satırı asistanınız.
• Google Antigravity: Kullanıcı arayüzünüzü "kodladığınız" ve dağıtımı düzenlediğiniz yeni nesil IDE.

Dijital Dukaan'ınız için Sonraki Adımlar:

• Bozuk Testleri Düzeltme: Kodu değiştirdiniz ancak testler ne durumda? Varsayılan testler (tests/unit/test_agent.py) hava durumunu aramaya devam eder. Gemini CLI'yı kullanarak bunları otomatik olarak güncelleyin. Şunu deneyin: gemini "Update the tests in tests/unit/test_agent.py to test the new check_inventory tool instead of weather."
• Dinamik Envanter: Bir öğe "satıldığında " Raju'nun envanter miktarlarının güncellenmesini sağlayın. Başarılı bir "satın alma" işleminden sonra INVENTORY sözlüğünüzdeki stock değerini azaltacak bir mantık ekleyebilir misiniz?
• Ödeme Ağ Geçidi Aracı: process_payment aracının sahtesini uygulayın. Raju, anlaşma yapıldığında bu aracı arayabilir.
• Antigravity'yi keşfedin: Antigravity'nin Agent Manager ve Workspaces özelliklerini daha ayrıntılı inceleyin. Temsilciden index.html ile ilgili sorgunuzu, canlı makbuz gösterecek şekilde iyileştirmesini isteyebilir misiniz?
• Mağazanızı Paylaşma: Raju'nun mağazası internette yayında. Ön uç URL'sini arkadaşlarınızla paylaşın ve onların sizden daha iyi bir fırsat yakalayıp yakalayamayacağını görün.

Kaynaklar

• Google Antigravity
• Google Cloud Run
• ADK belgeleri
• Gemini CLI

12. Temizleme

Bu codelab'de kullanılan kaynaklar için Google Cloud hesabınızın gereksiz yere ücretlendirilmesini önlemek istiyorsanız aşağıdaki adımları uygulayın.

Google Cloud ücretsiz katmanı ile öğrenmeye devam edin!

Cloud Run dahil olmak üzere birçok Google Cloud ürünü, kaynakları belirli bir sınıra kadar ücretsiz olarak kullanmanıza olanak tanıyan bir ücretsiz katman sunar.

Hâlâ Google Cloud ücretsiz deneme süreniz devam ediyorsa daha da fazla esnekliğe sahip olursunuz.

Kullanımınız Ücretsiz Katman sınırları içinde kaldığı sürece mevcut Google Cloud projenizi (raju-shop-agent) kullanmaya ve ilerleme kaybetmeden aracınızı geliştirmeye devam edebilirsiniz.

1. Cloud Run hizmetlerinin dağıtımını kaldırma (isteğe bağlı maliyet tasarrufu)

Projenizi ve diğer yapılandırmaları olduğu gibi bırakırken dağıtılan hizmetlerinizle ilgili olası ücretleri durdurmak istiyorsanız Cloud Run hizmetlerinizin dağıtımını kaldırabilirsiniz.

Cloud Shell terminalinizi (veya yerel terminalinizi) açıp aşağıdaki gcloud komutlarını çalıştırın:

# Undeploy the backend agent

gcloud run services delete raju-agent --region us-central1

# Undeploy the frontend shop (if you deployed it)

gcloud run services delete raju-shop-frontend --region us-central1

Bu komutları yerel makinenizden çalıştırıyorsanız Google Cloud KSA'nın (gcloud) yüklü ve yapılandırılmış olduğundan emin olun.

2. Google Cloud projesini silme (maliyet tamamen durdurulur)

Başka harcama yapılmadığından kesin olarak emin olmak ve bu codelab sırasında oluşturulan tüm kaynakları tamamen kaldırmak istiyorsanız en kesin adım, Google Cloud projesinin tamamını silmektir.

1. Google Cloud Console'da Projeler sayfasına gidin.
2. Projenizi (raju-shop-agent) seçin ve Sil'i tıklayın.
3. Proje silme işlemini onaylamak için yönergeleri uygulayın.