Bumble Gemini Enterprise 1. Gün Değer Atölyesi

1. Giriş

Bu codelab'de, Bumble'daki Scrum Master'lar ve proje yöneticileri için günlük iş akışlarını otomatikleştirmek ve geliştirmek amacıyla Gemini Enterprise'dan nasıl yararlanacağınızı öğreneceksiniz. Jira, Confluence, GitHub ve Google Drive için veri bağlayıcılarını yapılandırma, Gemini Notebook kullanarak sprint yedeklerini analiz etme, Gemini Assistant Canvas ile mimari dokümanları ortak yazma ve Agent Designer ile Agent Development Kit (ADK) kullanarak özel ajanlar oluşturma konularını öğreneceksiniz.

Yapacaklarınız

  • Kurulum ve Kişiselleştirme: Yardımcı ayarlarınızı teslimat hedefleri için yapılandırın.
  • Veri bağlayıcılarını yapılandırma: Gemini Enterprise'ı Jira Cloud, Confluence, GitHub ve Google Drive'a bağlayın.
  • Çapraz Referans Dokümanları: Koşulları etkin destek kaydı günlükleriyle karşılaştırın.
  • Sprint iş listelerini analiz etme: Retrospektif notlardan analizler oluşturmak için Gemini Notebook'u kullanın.
  • Google'a ait temsilcileri keşfedin: Pazar araştırması yapmak ve yeni özellikler için beyin fırtınası yapmak üzere Deep Research ve Idea Generation temsilcilerini kullanın.
  • Çok adımlı temsilciler oluşturma: Özel alt temsilciler kullanarak bir Lead Scrum Master Assistant oluşturun.
  • Hazır becerileri çağırma: Proje durumu özeti oluşturmak için kullanıma hazır Proje Güncellemeleri beceri şablonunu çağırın.
  • ADR dokümanlarına ortak yazma: ADR taslakları oluşturmak ve Canvas taslağından yeni Confluence sayfaları oluşturmak için Gemini Asistanı Canvas ile ortak çalışın.
  • İş Akışı Ajanları Oluşturma: Doğal dil kullanarak deterministik bir yayın denetçisi oluşturun.
  • Zorluk Laboratuvarı: ADK ile geliştirme (İsteğe bağlı): Antigravity CLI (agy) ile bir aracı iskeletini oluşturmak, geliştirmek ve dağıtmak için ADK Python SDK'sını kullanın.
  • Challenge Lab: Gemini'da yayınlama (İsteğe bağlı): Özel ADK aracınızı kaydederek diğer Bumble araçlarınızla birlikte görünmesini sağlayın.

İhtiyacınız olanlar

  • Chrome gibi bir web tarayıcısı
  • Faturalandırmanın etkin olduğu bir Google Cloud projesi (yönetici tarafından yapılandırılır)
  • Gerekli lisanslarla Gemini Enterprise'a erişim
  • Jira Cloud, Confluence, GitHub ve Google Drive'da uygun izinlere sahip hesaplar.
  • Kimlik Bilgisi Hazırlığı: Veri Bağlayıcı adımına başlamadan önce Atlassian API jetonları (Jira/Confluence için), GitHub uygulaması kimlik bilgileri oluşturduğunuzdan ve Google Drive klasörüne erişimi doğruladığınızdan emin olun.

Tahmini Süre: 201 dakika

Maliyet tahmini: Bu codelab'de kullanılan kaynaklar öncelikle hizmet olarak yazılım özellikleridir ve önemli altyapı maliyetlerine neden olmamalıdır. Ancak Gemini Enterprise lisanslarının ve veri bağlayıcı kullanımının faturalandırma üzerindeki etkilerini anladığınızdan emin olun.

2. Asistanınızı kurma ve kişiselleştirme

Bu adımda, Gemini Enterprise'a erişecek ve asistan ayarlarınızı özelleştirerek Scrum Master veya Delivery Lead olarak teslimat hedeflerinizi anlayacaksınız.

  1. Web tarayıcınızı açın ve Gemini Enterprise uygulamasına gidin (eğitmeniniz, ortamınızın URL'sini paylaşacaktır).
  2. Google Hesabınızla giriş yaptığınızdan emin olun.

Kişiselleştirmeyi yapılandırma

Asistana rolünüz ve sektörünüz hakkında açıkça bağlam bilgisi vermek için:

  1. Arayüzün sol alt köşesindeki Ayarlar (dişli) simgesini tıklayın.
  2. Ayarlar pop-up menüsünde Kişiselleştirme'yi seçin.
  3. Profil bölümüne aşağıdaki ayrıntıları girin:
    • Rol veya iş unvanı: Açılır listeden Özel'i seçin, ardından alana Scrum Master / Delivery Lead yazın.
    • Sektör: Açılır listeden Özel'i seçin, ardından alana Consumer Software & Mobile App Development yazın.
  4. Asistanın geçmiş etkileşimlerden öğrenmesine yardımcı olmak için aşağıdaki açma/kapatma düğmelerinin açık olduğundan emin olun:
    • Sohbet geçmişi
    • Kayıtlı bellekleri referans olarak kullanma
  5. Kaydet'i tıklayın ve ayarlar pop-up'ını kapatın.

Gemini Enterprise Kişiselleştirme ayarları

3. Laboratuvar Ortamında İlk Veri Girişi Ön Koşulu

Bu atölye çalışması sırasında% 100 yürütme doğruluğu sağlamak ve ortam kaymasını önlemek için veri bağlayıcılarını yapılandırmadan önce yerel laboratuvar ortamlarınıza belirli sahte veri paketleri eklemeniz gerekir. Bu işlem, Jira, Confluence ve GitHub için temel bir veri kümesi oluşturur. Böylece yapay zeka asistanı, kesin olarak belirlenmiş doğrulukla temellendirilmiş analitik görevler yürütebilir.

1. Jira Projesi Veri Sıralaması

Özel bir sandbox Jira projesi oluşturacak ve bu projeye üç temel sorun ekleyeceksiniz.

  1. Atlassian Jira Cloud örneğinizi bir web tarayıcısında açın.
  2. Projelere erişme: Soldaki yan menü bölmesinde Projeler'i tıklayın ve Proje oluştur'u seçin. Jira projelerinde gezinme
  3. Scrum şablonunu seçin: Proje şablonları panelinde Scrum'u (Yazılım Geliştirme şablon kategorisinde bulunur) arayıp seçin. Şablonu kullan'ı tıklayın ve Şirket tarafından yönetilen proje'yi seçin. Jira Scrum şablonu, ücretsiz geliştirici sürümünde doğrudan kullanılamaz. Ücretsiz bir geliştirici sürümü kullanıyorsanız ve şablonu doğrudan bulamıyorsanız şablonları bulmak için Alanlar'ı tıklayın ve buradan Scrum şablonunu seçin. Alanlar bölümünde kullanılabilen Scrum şablonu Alan şablonları galerisinden Scrum şablonunu seçme
  4. Proje Ayrıntılarını Girin: Proje özelliklerini ayarlayın:
    • Ad: Bumble Lab Project
    • Anahtar: Otomatik olarak doldurulmuş anahtarı kullanın (genellikle BLP olsa da ortamınızda farklı olabilir). Bu laboratuvarın geri kalan bölümünde BLP olduğunu varsayalım. BMB_LAB gibi özel bir anahtarı sabit kodlamaktan kaçının. Bu işlem, doğrulama hatası oluşturur. Otomatik olarak doldurulan anahtarı kabul etmek, çok kiracılı geliştirici ortamlarında ad alanı ve doğrulama çakışmalarını önler. Jira proje anahtarı yapılandırması
  5. Sandbox'ı başlatın: Bu noktada Proje oluştur düğmesi yoktur. Sonraki'yi tıklayın. Ardından, Confluence alanını hemen bağlamanız önerilirse Devam / Atla'yı tıklayın ve alan oluşturma işlemini bir sonraki aşamada bağımsız olarak gerçekleştirin. Alan bağlantısını atlama Proje Kontrol Paneli
  6. Başlangıç Temel Sorunları:
    • Yeni BLP panonuzun sol tarafındaki gezinme panelinde Ürün biriktirme listesi'ni seçin. BLP panosunda, Backlog (Ürün Biriktirme Listesi) seçeneğinin bulunduğu sol gezinme alanı BLP panosunun Backlog (Ürün Biriktirme Listesi) görünümü
    • Aşağıdaki tablodan Görev ve Hata'yı eklemek için Backlog (Ürün Biriktirme Listesi) panelinin altındaki + Oluştur düğmesini tıklayın. Her birini oluşturduktan sonra, bileti tıklayarak açın ve tam açıklamayı, önceliği ve durumu ayarlayın. İş listesi panelindeki + Oluştur denetimi

Sorun Türü

Özet

Öncelik

İlk Durum

Açıklama

Görev

Implement real-time geolocation profile matching routines.

Orta

To Do

Konum metrikleri için temel rutinler

Hata

Memory leak detected in profiles rendering loop during intensive matching sweeps.

Yüksek (P1)

In Progress

Oluşturma sırasında kritik iş parçacığı sızıntıları

Epic

Bumble Hobbies Community Feature Release Pipeline.

Orta

To Do

Hobiler grubu topluluk lansmanı yol haritası

İş listesinden coğrafi konum eşleştirme görevi oluşturma İş listesinden bellek sızıntısı hatası oluşturma

  • Destansı, ayrı bir akış üzerinden oluşturulur. Sorun türü seçiciyi kullanarak Destansı'yı seçin, ardından ayrıntılarını, önceliğini ve durumunu tabloda listelendiği şekilde ayarlamak için açın. Epic sorun türünü seçme Hobiler Topluluk Özelliği Epic'ini Oluşturma

2. Confluence Workspace Seeding

Mühendislik alanı oluşturun ve dinamik dokümanlar için ayrılmış boş bir sayfa oluşturun.

  1. Atlassian Confluence Cloud arayüzünüze gidin.
  2. Üst gezinme menüsünde Alanlar'ı tıklayın ve Alan oluştur'u seçin. Confluence alanları menüsünde Alan oluştur seçeneği belirlenmiş Boş alan seçeneğini belirleme
  3. Boş Alan'ı seçin ve yapılandırın:
    • Alan adı: Bumble Engineering Space
    • Boşluk tuşu: Otomatik olarak doldurulan tuşu kullanın (genellikle BMBENG, ancak ortamınızda farklı olabilir). Bu laboratuvarın geri kalan bölümünde BMBENG olduğunu varsayalım. Confluence alanı adı ve otomatik olarak doldurulan alan anahtarı
  4. Boş Confluence ana bölmenizi açmak için Oluştur'u tıklayın. Yeni oluşturulan boş Confluence alanı
  5. Üstteki genel gezinme menüsünde Sayfa oluştur düğmesini (kalem/artı simgesi) tıklayın. Genel gezinmedeki Sayfa oluşturma denetimi
  6. Sayfa düzenleyicide başlığı ADR for background framework olarak ayarlayın ve gövdeyi tamamen boş bırakın. ADR başlığı ve boş gövde içeren sayfa düzenleyici
  7. Sağ üst köşedeki Yayınla'yı tıklayın.

3. GitHub deposu başlatma

Üretim kod tabanının sahtesini temsil eden bir test deposu oluşturun.

  1. GitHub hesabınızın sayfasına gidin. Sağ üst köşedeki + simgesini tıklayın ve New repository'yi (Yeni depo) seçin. + menüsünden GitHub'da yeni depo seçeneği
  2. Depo ayarlarını yapılandırın:
    • Depo adı: bumble-workshop-demo
    • Herkese açık/Gizli: Gizli'yi seçin (veya gizli kısıtlanmışsa Herkese açık'ı seçin).
    • README dosyası ekle kutusunu işaretleyin. README dosyası ekle seçeneği işaretlenmiş GitHub deposu ayarları
  3. Yeni dizininizi oluşturmak için Create repository'yi (Depo oluştur) tıklayın. Yeni oluşturulan bumble-workshop-demo deposu
  4. Sahte bir ana kod tabanı dosyası oluşturun:
    • Dosya ekle -> Yeni dosya oluştur'u tıklayın. GitHub'da "Yeni dosya oluştur" seçeneğini içeren Dosya menüsü
    • Dosyayı main.py olarak adlandırın ve şu sahte içeriği yazın: # Bumble Geolocation Base Service Framework. Sahte çerçeve yorumuyla main.py dosyasını oluşturma
    • Sağ üstte Değişiklikleri gönder'i tıklayıp Doğrudan ana dala gönder'i seçin. main.py dosyasını doğrudan ana dala gönderme
  5. Etkin bir çekme isteği önerin:
    • Deponuzun ana sayfasında Dosya ekle -> Yeni dosyayı tekrar oluştur'u tıklayın.
    • Dosyayı cache.py olarak adlandırın ve şu sahte içeriği ekleyin: # Optimize cache invalidation metrics.
    • Commit kutusuna gidin ve Create a new branch for this commit and start a pull request'i (Bu commit için yeni bir dal oluştur ve pull isteği başlat) seçin. Dalı adlandırın optimize-cache ve Değişiklik öner'i tıklayın. Çekme isteği başlatmak için optimize-cache dalını oluşturma
    • Açık Çekme İsteği sayfasında başlığın PR #1: Optimize cache invalidation metrics olarak ayarlandığından emin olun ve Çekme isteği oluştur'u tıklayın. Optimize-cache dalı için 1 numaralı çekme isteğini açma

4. Veri bağlayıcılarını yapılandırma

Gemini Enterprise'ın proje verilerinize erişebilmesi için Jira Cloud, Confluence, GitHub ve Google Drive bağlayıcılarının yapılandırılması gerekir. Bunlar, Google Cloud Console'da veri depoları olarak ayarlanır.

[Yöneticiler İçin] Jira Cloud Veri Deposu Oluşturma

  1. Google Cloud Console'da Gemini Enterprise sayfasına gidin (veya sayfayı arayın).
  2. Google Cloud projenizi seçin.
  3. Gezinme menüsünde Veri depoları'nı tıklayın.
  4. + Veri deposu oluştur'u tıklayın.
  5. Kaynak bölümünde Jira Cloud'u arayın ve Seç'i tıklayın.
  6. Veriler bölümünde:
    • Birleşik arama'yı seçin (gerçek zamanlı sorgular için en iyi seçenektir).
    • Kimlik doğrulama ayrıntılarını girin: İstemci kimliği, istemci gizli anahtarı, örnek URI (ör. https://your-domain.atlassian.net) ve örnek kimliği.
    • Not: Atlassian hesabınızdan oluşturulan bir Jira API jetonuna ihtiyacınız vardır.
    • Giriş'i tıklayın ve Atlassian oturum açma işlemini tamamlayın.
  7. Aranacak öğeleri (ör. sorunlar, projeler) seçin.
  8. Devam'ı tıklayın ve oluşturma işlemini tamamlamak için istemleri uygulayın.

[Yöneticiler İçin] Confluence Veri Deposu Oluşturma

  1. Veri depoları sayfasında tekrar + Veri deposu oluştur'u tıklayın.
  2. Kaynak bölümünde Confluence'i arayın ve Seç'i tıklayın.
  3. Veriler bölümünde:
    • Birleşik arama'yı seçin (gerçek zamanlı sorgular için en iyi seçenektir).
    • Kimlik doğrulama ayrıntılarını girin: İstemci kimliği, istemci gizli anahtarı, örnek URI (ör. https://your-domain.atlassian.net) ve örnek kimliği.
    • Giriş'i tıklayın ve Atlassian oturum açma işlemini tamamlayın.
  4. Aranacak öğeleri (ör. sayfalar, alanlar, blog yayınları) seçin.
  5. Devam'ı tıklayın ve oluşturma işlemini tamamlamak için istemleri uygulayın.

[Yöneticiler için] GitHub veri deposu oluşturma

  1. Veri depoları sayfasında tekrar + Veri deposu oluştur'u tıklayın.
  2. Kaynak bölümünde GitHub'u arayın ve Seç'i tıklayın.
  3. Veriler bölümünde:
    • GitHub uygulamanızdan Client ID (İstemci Kimliği) ve Client Secret (İstemci Gizli Anahtarı) değerlerini girin.
    • Oturum aç'ı tıklayın ve GitHub oturum açma ve yetkilendirme işlemlerini tamamlayın.
    • Gelişmiş seçenekler'de, Sahip girişi alanına kuruluşunuzun adını girin.
  4. Aranacak öğeleri (ör. depolar, sorunlar, çekme istekleri) seçin.
  5. Etkinleştirilecek GitHub işlemlerini seçin (ör. Yorum ekle, PR'yi birleştir).
  6. Bağlayıcı için konumu ve adı yapılandırın.
  7. Oluştur'u tıklayın.

[Yöneticiler için] Google Drive veri deposu oluşturma

  1. Veri depoları sayfasında tekrar + Veri deposu oluştur'u tıklayın.
  2. Kaynak bölümünde Google Drive'ı arayın ve Seç'i tıklayın.
  3. Veriler bölümünde:
    • Atlassian/Google Workspace OAuth veya Workspace yöneticiniz tarafından yapılandırılan bir hizmet hesabı kullanarak bağlanın.
    • Dizin oluşturmayı ilgili Bumble proje klasörleriyle sınırlamak için klasör kapsamı kuralları tanımlayın.
  4. Dizin oluşturulacak ve aranacak öğeleri (ör. dokümanlar, dosyalar) seçin.
  5. Oluştur'u tıklayın.

5. Veri Bağlayıcıları Yetkilendirme ve Kullanma

Gemini Enterprise'ı kullanarak Workspace araçlarınıza sorgu gönderebilmeniz için her atölye katılımcısının kullanıcı hesabı bağlantılarını açıkça yetkilendirmesi gerekir.

1. adım: Bağlayıcılar menüsüne erişin

  1. Ana Gemini Enterprise sohbet arayüzünde, sohbet giriş kutusundaki Veritabanı (Bağlayıcılar) simgesini tıklayın.
  2. Yöneticiniz tarafından yapılandırılan kullanılabilir veri depolarının listesini (Jira, Confluence, GitHub, Google Drive ve Google Arama) görürsünüz.

2. adım: Jira bağlayıcısını yetkilendirin

  1. Jira bağlayıcısını bulun. Yanındaki Yetkilendir'i tıklayın. Jira bağlayıcısının yanındaki Yetkilendir düğmesi
  2. Atlassian'a giriş yapmanızı isteyen yeni bir tarayıcı sekmesi açılır. Giriş işlemini tamamlayın ve entegrasyonu yetkilendirmek için Kabul et'i tıklayın. Jira bağlayıcısı için Atlassian yetkilendirme sayfası
  3. Yetkilendirildikten sonra durum açma/kapatma düğmesi maviye döner ve bağlayıcının etkin olduğu onaylanır. Mavi durum anahtarıyla etkin Jira bağlayıcısı

3. adım: Confluence bağlayıcısına yetki verin

  1. Confluence bağlayıcısını bulun. Yanındaki Yetkilendir'i tıklayın. Confluence bağlayıcısının yanındaki Yetkilendir düğmesi
  2. Atlassian girişini tamamlayın ve Confluence entegrasyonunu yetkilendirmek için Kabul et'i tıklayın. Confluence bağlayıcısı için Atlassian yetkilendirme sayfası
  3. Açma/kapatma düğmesinin mavi renge dönerek Confluence'in etkin olduğunu gösterdiğinden emin olun. Mavi durum açma/kapatma düğmesi olan etkin Confluence bağlayıcısı

4. adım: GitHub bağlayıcısını yetkilendirin

  1. GitHub bağlayıcısı için de aynı akışı uygulayın.
  2. Authorize'ı (Yetkilendir) tıklayın, pop-up sekmesinde GitHub hesabınıza giriş yapın ve istenen izinleri verin.

5. adım: Google Drive Bağlayıcısı'nı yetkilendirin

  1. Google Drive bağlayıcısı için de aynı akışı izleyin.
  2. Yetkilendir'i tıklayın, Workspace Google Hesabınızı seçin ve asistanın Drive'ınızın kök dizininde dosya oluşturmasına izin vermek için okuma/yazma izinleri verin.

Kod tabanınızdan ve destek kaydı izleyicinizden en doğru sonuçları almak için geniş arama özelliğini devre dışı bırakmanız önerilir. Gemini Enterprise ortamınızda etkinleştirilenlere bağlı olarak Google Arama, Enterprise Search veya her ikisini de görebilirsiniz. Etkin olanları devre dışı bırakın. Laboratuvarlar yalnızca daha önce eklediğiniz Jira, GitHub ve Confluence verilerine dayanır. Bu nedenle, geniş kapsamlı bir arama bırakmak yanlış sonuçlar verir.

  1. Giriş kutusunda Veritabanı menüsünü tekrar açın.
  2. Yalnızca Jira, Confluence, GitHub ve Google Drive'ı etkin tutarak Google Arama ve Enterprise Search'ü (hangisi görünüyorsa) devre dışı bırakın. Geniş eşlemeli aramayı devre dışı bırakarak yalnızca başlangıç bağlayıcılarının etkin kalmasını sağlama

6. Jira Bağlayıcısı ile Temel Etkileşimler

Bu adımda, doğal dili kullanarak temel destek kaydı yönetimi görevlerini gerçekleştirme alıştırması yapacaksınız.

1. Jira proje anahtarınızı bulma

Bilet oluşturmadan veya güncellemeden önce hangi projeye erişiminiz olduğunu doğrulayın. Gemini:

list the available Jira projects and their keys.

Gemini, veri deponuza bağlı projeleri tam olarak döndürmelidir: Gemini, kullanılabilir Jira projelerini ve BLP anahtarını listeliyor.

Aşağıdaki örneklerde BLP proje anahtarı kullanılmaktadır. Projeniz daha önce farklı bir anahtarla otomatik olarak doldurulduysa BLP yerine kendi anahtarınızı kullanın (ve Gemini'ın size döndürdüğü bilet anahtarını kullanın).

2. Görev Oluşturma

Gemini'dan yeni bir görev oluşturmasını isteyin:

Create a new task in project BLP with summary 'Analyze user feedback for community feature' and description 'We need to summarize the feedback collected in Sprint 24'.

Gemini, isteği işler, Atlassian ile iletişim kurar ve bir onay çıktısı verir: Gemini'ın görev oluşturma onayı. Proje: BLP ve Sorun Türü: Görev Gemini tarafından döndürülen görev oluşturma onay ayrıntıları Yeni oluşturulan BLP-4 görevini gösteren Jira backlog'u

3. Yorum ekleme

Destek kaydı oluşturulduktan ve Gemini size anahtarı verdikten sonra (ör. BLP-4) yorum ekleyin. BLP-4 yerine Gemini'ın döndürdüğü bilet anahtarını girin:

Add a comment to ticket BLP-4 saying 'I have uploaded the retro notes to Gemini Notebook for analysis and will post findings here'.

Gemini, yorumu ekleyip onaylar: BLP-4 numaralı destek kaydına Gemini'ın yorum ekleme onayı ve retro notlar gövdesi Gemini'ın döndürdüğü yorum ekleme onay ayrıntıları BLP-4'e gönderilen yorumu gösteren Jira bileti etkinlik paneli

4. Güncelleme Durumu

Kaydı yeni bir duruma taşıyın (Gemini'ın döndürdüğü kayıt anahtarını tekrar kullanarak):

Change the status of ticket BLP-4 to 'In Progress'.

Gemini, durumu güncelleyip onaylar: Gemini, kayıttaki durum güncellemesini işliyor Durumun "Devam Ediyor" olarak güncellendiğini gösteren Jira kaydı Gemini, durumu Devam Ediyor olarak değiştirme işlemini onaylıyor

7. GitHub Bağlayıcısı ile Temel Etkileşimler

Bu adımda, geliştiricilerin ilerleme durumundan haberdar olmak için depo etkinliğini nasıl sorgulayacağınızı öğreneceksiniz.

1. Kullanılabilir Kod Depolarını Listeleme

Commit günlüklerini sorgulamak için tam depo adını bilmeniz gerekir. Gemini:

list all GitHub repositories that I have access to.

Gemini, bağlayıcıya sorgu gönderir ve erişebileceğiniz depoları gösterir: Gemini, kullanıcının erişebileceği GitHub depolarını listeliyor

Aşağıdaki örneklerde bumble-workshop-demo deposu kullanılmaktadır. öğesini kendi GitHub kullanıcı adınızla (örneğin, mumanoha/bumble-workshop-demo) değiştirin.

2. Son Commit'leri Listeleme

Gemini'dan son etkinlikleri kontrol etmesini isteyin:

List the last 5 commits in repository <owner>/bumble-workshop-demo.

Gemini, son commit'leri getirip listeleyecek: Gemini, depodaki en son kayıtları listeliyor

3. Açık çekme isteklerini kontrol etme

İncelenmeyi bekleyen kodu görme:

Show me all open pull requests for repository <owner>/bumble-workshop-demo.

Gemini, açık PR'leri döndürür: Gemini, depodaki açık çekme isteklerini döndürüyor

4. Çekme isteğini özetleme

Gemini'dan PR'deki değişiklikleri özetlemesini isteyin (bu atölye çalışmasında PR oluşturuldu #1):

Summarize the changes in pull request #1 in repository <owner>/bumble-workshop-demo.

Gemini, farkı okuyup net bir açıklama döndürür: Gemini, pull isteğindeki değişiklikleri özetliyor

8. Confluence Bağlayıcısı ile Temel Etkileşimler

Bu adımda, Confluence bağlayıcısını kullanarak temel belge arama ve yönetim görevlerini gerçekleştirme alıştırması yapacaksınız.

1. Alan sayfalarında arama yapma

Gemini'ın yeni Confluence alanınızı BMBENG tarayabildiğini ve boş ADR belgenizi bulabildiğini doğrulayın. Gemini:

Search space BMBENG for the 'ADR for background framework' page and tell me if it has any content.

Gemini, Confluence ile iletişim kurar, alanı tarar, sayfayı bulur ve sayfanın boş olduğunu onaylar:

  • Durum: BMBENG içinde ADR for background framework sayfası bulundu.
  • İçerik: Sayfa gövdesi tamamen boş ve Canvas oluşturma laboratuvarına hazır.

9. Belgeleri yürütmeyle çapraz referanslama

Bu adımda, Gemini'ı kullanarak yapılandırılmış kod ilerlemesini derecelendirmek için yapılandırılmamış belgeleri kullanacaksınız.

1. adım: Şartlar dokümanınızı oluşturun

Yükleme yapmadan önce hedef spesifikasyonlarınızı içeren yerel bir metin dosyasına ihtiyacınız vardır.

  1. Yerel makinenizde bir düz metin düzenleyici açın:
    • macOS'te: TextEdit'i açın. Üst menüye gidip Biçim > Düz Metin Yap'ı seçin (biçimlendirme meta verileri olmadan kaydedildiğinden emin olmak için bu adım çok önemlidir).
    • Windows'da: Not Defteri'ni açın.
  2. Aşağıdaki metni kopyalayıp düzenleyiciye yapıştırın:
Project: Bumble Hobbies Community Feature

Requirements:
1. User Interface:
   - [ ] Create a "Communities" tab in the main navigation.
   - [ ] Display a list of available hobby groups.
   - [ ] Allow users to search for groups by keyword.

2. Group Functionality:
   - [ ] Users can join and leave groups.
   - [ ] Members can create new text posts.
  1. Dosyayı bilgisayarınıza requirements.txt olarak kaydedin.

2. adım: Yeni bir sohbet yükleyip başlatın

  1. Gemini Enterprise'da Yeni Sohbet penceresini açın.
  2. Sohbet giriş kutusunda Veritabanı (Bağlayıcılar) simgesini tıklayın.
  3. Arama bağlamını, başlangıç Jira verilerinize odaklamak için yalnızca Jira'yı etkinleştirin (Google Arama, Enterprise Search, GitHub ve Confluence'ı devre dışı bırakın).
  4. Metin kutusunun yanındaki + (artı) simgesini tıklayın (veya sürükleyip bırakın) ve requirements.txt dosyanızı yükleyin. Yükleme Koşulları Metni

3. adım: Gemini'ı kullanarak örnek veriler oluşturun

Şimdi Gemini'ı kullanarak Jira'da bu şartlara göre bazı test kayıtları oluşturalım:

Create Jira tickets in project BLP for the following requirements from the uploaded requirements.txt file: 'Create a Communities tab' and 'Display a list of available hobby groups'. Mark the first one as 'Done' and the second one as 'In Progress'.

Gemini, kayıtları oluşturmak ve belirtilen durumları ayarlamak için Jira ile iletişim kurar: Destek kaydı istemi oluşturma Jira kaydı oluşturma onayı Jira Bitti Durumu Onayı Jira kaydı oluşturma onayı Jira In Progress Status Confirmation Jira Portal Doğrulaması

4. adım: Analizi çalıştırın

Şimdi Gemini'dan, gereksinimler dosyası ile etkin Jira yürütmesi arasında bir boşluk analizi yapmasını isteyin:

Using the connected Jira data store, compare the requirements in the uploaded requirements.txt file with active tickets in project BLP. Point out any requirements that do not have a corresponding active ticket or are not completed.

Gemini, yüklenen metni canlı Jira proje verilerinizle birlikte analiz ederek net bir karşılaştırma tablosu döndürür: Analiz istemini çalıştırma Analiz Çıkış Tablosu

10. Gemini Notebook ile sprint yedeklerini analiz etme

Bu adımda, yapılandırılmamış sprint retrospektif notlarını analiz etmek ve yinelenen darboğazları ayıklamak için Gemini Notebook'u kullanacaksınız.

1. adım: Retrospektif dokümanınızı oluşturun

  1. Düz metin düzenleyicinizi açın (Mac'te düz metin modunda TextEdit veya Windows'ta Not Defteri).
  2. Aşağıdaki sahte notları kopyalayıp düzenleyiciye yapıştırın:
Bumble Sprint 24 Retrospective Notes
What went well:
- UI redesign of the matching screen was completed on time.
- New ice-breaker prompts received positive feedback in user testing.
- Backend API latency reduced by 20%.

What didn't go well:
- Blocked on Figma designs for the community feature for 3 days.
- Test coverage for the new chat feature is below target (60% instead of 80%).
- Communication gap between frontend and backend teams on the new API contract.

Action items:
- Schedule a daily sync between frontend and backend leads.
- Increase unit test coverage for chat feature to 80%.
- Follow up with design team on community feature Figma files.
  1. Dosyayı retro.txt olarak kaydedin.

2. adım: Gemini Notebook'a erişin ve not defteri oluşturun

  1. Sol Gemini Enterprise gezinme panelinde Aracı sekmesini genişletin.
  2. Gemini Notebook'u seçin.
  3. Yeni not defteri oluştur'u tıklayın.

3. adım: Kaynakları içe aktarın

  1. Kaynak seçimi pop-up'ında Kopyalanan metin veya Dosya yükle'yi seçin.
  2. retro.txt dosyanızı yapıştırın veya yükleyin.

4. adım: Analiz üretme

  1. En alttaki sohbet arayüzünde şu istemi çalıştırın:
What are the recurring bottlenecks mentioned in these retrospective notes?

Gemini, geriye dönük toplantı notlarını analiz ederek engellerin ve önerilen işlem öğelerinin ayrıntılı bir özetini oluşturur: Gemini Notebook Çıkışı

  1. Sağ taraftaki Studio sekmesini bulun ve çıkarılan retro temaların görsel temsilini oluşturmak için Zihin Haritası'nı tıklayın. Gemini Notebook Zihin Haritası

11. Pazar trendleri hakkında ayrıntılı araştırma yapma

Bu adımda, Bumble ile ilgili pazar trendleri (ör. Z kuşağının flört uygulamalarındaki tercihleri) hakkında kapsamlı araştırma yapmak için Deep Research aracısını kullanacaksınız.

Deep Research Temsilcisine erişme

  1. Gemini Enterprise'ın sol gezinme menüsünde Ajanlar sekmesini seçin. Deep Research Temsilcisine erişme
  2. Deep Research aracını seçin.

Araştırma Oturumunu Başlatma

  1. Giriş alanına şu gibi bir istem yapıştırın: "Mobil flört ve ağ oluşturma uygulamaları bağlamında Z kuşağı tüketicilere ulaşmak için farklı pazarlama stratejilerinin etkinliğini karşılaştır."
  2. Araştırma Planını İncele: Temsilci bir plan oluşturur. İnceleyin ve Araştırmayı Başlat'ı tıklayın. Deep Research istem girişi

Beklenen Sonuç

Ajanın kaynakları arayıp alıntılar içeren çok sayfalı bir rapor oluşturması birkaç dakika sürer. Bu işlem çalışırken sonraki adıma geçebilirsiniz.

12. Fikir üretme özelliğiyle beyin fırtınası yapma

Bu adımda, topluluk oluşturmaya odaklanarak Bumble için yeni özellikler veya kampanyalar hakkında beyin fırtınası yapmak üzere Fikir Üretme aracısını kullanacaksınız.

Idea Generation Agent'a erişme

  1. Gemini Enterprise'ın sol gezinme menüsünde Ajanlar sekmesini seçin.
  2. Fikir Üretme aracını seçin.

Fikir üretme oturumu başlatma

  1. Aşağıdakiler gibi bir konu vererek fikir üretmesini isteyin: "Bir ağ oluşturma uygulamasında kullanıcılar arasında buzları kırmak ve topluluk oluşturmak için oyunlaştırılmış özelliklerin listesini oluştur."
  2. Oturumu başlatma: Planı inceleyin ve Oturumu Başlat'ı tıklayın. Oturumu başlatma

Beklenen Sonuç

Temsilci fikir üretir, bunları değerlendirir ve sıralar. Bu işlem uzun sürer. Tamamlanmasını beklemeyin. Arka planda çalışmasına izin verebilir ve daha sonra sonuçları kontrol etmek için geri dönebilirsiniz. Lütfen bir sonraki laboratuvara geçin.

13. Çok adımlı Scrum Yöneticisi Asistanı'nı oluşturma

Profesyonel temsilciler, karmaşık görevleri bölmek için genellikle alt temsilcileri kullanır. Bu adımda, Agent Designer'ı kullanarak çok adımlı bir aracı oluşturacak ve işi özel Jira ve GitHub alt aracılarına devredeceksiniz.

1. adım: Orchestrator aracısını yapılandırın

  1. Gemini Enterprise gezinme bölmesinde + Yeni aracı'yı tıklayın.
  2. Önemli kullanıcı arayüzü adımı: Bir istem seçimi pop-up'ı görürsünüz. Ajan Tasarımcısı arayüzüne girmek için Chat Agent'ı seçin (burada sohbet akışlarına odaklandığımız için "Workflow Agent"ı seçmeyin). Sohbet temsilcisini seçin.
  3. Sağ taraftaki yapılandırma panelini açmak için ana tuvalde ortadaki aracı düğümünü tıklayın. Temsilci Tuvalini Yeniden Adlandırma
  4. Ajan ayrıntılarını ayarlayın:
    • Aracı adı: Bu kök aracının adını doğrudan yapılandırma panelinde Lead Scrum Master olarak ayarlayın.
    • Talimat: 
      You are the Lead Scrum Master. Your goal is to provide a unified daily report. Coordinate with your Jira-Analyst sub-agent to find blockers and your GitHub-Analyst sub-agent to check code progress. Synthesize their findings into a single, Slack-ready unified daily report. Ensure you only query project metrics from the connected Jira and GitHub data stores. Do not perform external Google search queries.
    • Araçlar: Google Arama'nın işaretini kaldırın. Yapılandırmayı yalnızca alt aracı temsilcilerine odaklanacak şekilde tutun. Kök Aracıyı Yapılandırma

2. adım: Uzman alt acenteler ekleyin

İş bölümü yapmak için iki uzmanlaşmış alt aracı oluşturacağız.

  1. Kanvastaki Lead Scrum Master düğmenizin üzerine gelin ve + (artı) simgesini veya Alt aracı ekle seçeneğini tıklayın. Alt temsilci ekleme
  2. Yeni oluşturulan alt aracı düğmesini tıklayın ve ilk alt öğeyi yapılandırın:
    • Ad: Jira-Analyst
    • Talimat: 
      Query the connected Jira project data store. Extract all P0/P1 issues and any tickets marked 'Blocked' under project Bumble Lab Project (Project Key: BLP). Summarize their current impact on the release readiness of project BLP. Do not run public web searches.
    • Araçlar: Jira veri deponuzu arayın ve kontrol edin. Google Arama'nın işaretini kaldırın. Jira alt aracısını yapılandırma
  3. Fareyle tekrar Lead Scrum Master düğümünün üzerine gelin, + Alt aracı ekle'yi tıklayın ve ikinci alt öğeyi yapılandırın:
    • Ad: GitHub-Analyst
    • Talimat: 
      Query the connected GitHub data store. List all open Pull Requests in repository bumble-workshop-demo and check if any have a status of 'Changes Requested' or 'Commented'. Summarize the review feedback. Do not run public web searches.
    • Araçlar: GitHub veri deponuzu arayın ve kontrol edin. Google Arama'nın işaretini kaldırın. GitHub alt aracısını yapılandırma

3. adım: Çok adımlı akışı kaydedin ve test edin

  1. Aracı yayınlamak için oluşturucu ekranının sağ üst köşesindeki Oluştur'u (veya Kaydet'i) tıklayın.
  2. Önizleme bölmesini açmak için Temsilciyle Sohbet Et'i tıklayın.
  3. Sohbet veritabanı seçeneklerinde Google Arama'yı devre dışı bırakın ve aşağıdaki istemi çalıştırın:
Generate the high-priority update for my projects for the past 24 hours.

Düzenleyici, Jira-Analyst ve GitHub-Analyst alt aracılarıyla koordineli çalışır, girişlerini derler ve hem canlı Jira engelleyicilerini hem de açık GitHub çekme isteklerini gösteren güzel bir sentezlenmiş günlük durum raporu döndürür. Scrum Master Çıkış Raporu

14. @-bahisleriyle önceden oluşturulmuş becerileri çağırma

Gemini Enterprise, Scrum yöneticilerinin ve ürün yöneticilerinin belirli otomatik iş akışlarını gerçekleştirmek için doğrudan sohbet oturumlarında kullanabileceği, önceden oluşturulmuş ve kullanıma hazır beceri şablonları sunar. Bu adımda, önceden oluşturulmuş Proje Güncellemeleri becerisini etkinleştirecek ve proje durumu özeti oluşturmak için kullanacaksınız.

1. adım: Web kullanıcı arayüzünde Proje Güncellemeleri becerisini etkinleştirin

Hazır becerileri kullanmak için önce etkinleştirmeniz gerekir:

  1. Gemini Enterprise sol taraftaki gezinme panelinde Beceriler'i tıklayın (yan gezinmede Önizleme rozetiyle işaretlenmiş ayrı bir öğe olarak görünür).
  2. Proje Güncellemeleri becerisini (Google tarafından kullanıma hazır olarak sunulan önceden oluşturulmuş bir beceri şablonu) bulun.
  3. Anahtarı Etkinleştir konumuna getirin. Yan gezinme panelinden kullanıma hazır Proje Güncellemeleri becerisini etkinleştirme

2. adım: Chat'te beceriyi çağırın

Etkinleştirildikten sonra, sohbet görüşmesinde proje durumu güncellemesi istediğinizde beceri otomatik olarak çalışır. @-mention ile başlamanıza gerek yoktur:

  1. Yeni Sohbet penceresini açın.
  2. Sohbet giriş kutusunda Veritabanı (Bağlayıcılar) simgesini tıklayın.
  3. Kapsam belirleme kurulumu: Yapay zekanın temelini korumak ve sorgu gürültüsünü önlemek için yalnızca gerekli bağlayıcıları (Jira ve GitHub) seçtiğinizden ve diğer bağlayıcıları (ör. herkese açık Google Arama veya genel Enterprise Search) açıkça devre dışı bıraktığınızdan emin olun.
  4. Beceriyi çağırmak için aşağıdaki istemi yazın: 
    Summarize the status of project 'Bumble Hobbies Community Feature' (BLP). Surface the high-priority blockers from the past week and compile a clean, bulleted summary of action items.
  5. Enter tuşuna basın veya Gönder'i tıklayın. Yeni bir sohbette Proje Güncellemeleri durum istemini gönderme

3. adım: Temellendirilmiş rapor alımı ve çıkışı

Önceden oluşturulmuş beceri, optimize edilmiş analiz dizisini çalıştırır. Sprint sorunlarını almak için Jira'ya bağlanır, etkin çekme isteğini izlemek için GitHub'ı sorgular ve sonuçları son derece profesyonel bir durum raporunda birleştirir: Proje Güncellemeleri becerisi, sentezlenmiş bir durum raporu döndürüyor

15. Gemini Asistan Tuval ile etkileşimli yapay doküman üzerinde ortak çalışma

Bu adımda, Gemini Enterprise'ın temel bir farklılaştırıcı özelliği olan Gemini Asistan Canvas'ı keşfedeceksiniz. Bu özellik, çalışma alanınızı standart bir sohbet ekranından yüksek verimlilik sağlayan, yan yana, çift panelli bir düzene dönüştürür. Bu düzende, uygulama değiştirmeden solda yapay zekaya istem girebilir, sağda ise kalıcı ve düzenlenebilir yapay içerikler üzerinde ortak çalışabilirsiniz.

Kullanıcı Arayüzü Düzeni Açıklaması

Kanvas modu etkinleştirildiğinde kullanıcı arayüzünde belirgin bir geçiş gerçekleşir:

  • Sol Panel (Etkileşimli Sohbet): Standart bir yapay zeka sohbet bölmesini korur. Alt kısımda istem giriş satırınız ve veritabanı bağlayıcı düğmeleri bulunur.
  • Sağ Panel (Doküman Düzenleyici Tuvali): Ekranın sağ yarısında geniş ve temiz bir beyaz doküman çalışma alanı bulunur. Biçimlendirilmiş başlıklar, madde işaretleri ve metinler gösterilir. Bu özellik, doğrudan Gemini oturumunuza entegre edilmiş kalıcı bir Google Dokümanı gibi çalışır.

1. adım: Canvas arayüzünü etkinleştirin

  1. Gemini Enterprise web uygulamanızda oturum açın.
  2. Temiz bir geçmişle başlamak için sol üstteki Yeni Sohbet düğmesini tıklayın.
  3. En alttaki istem giriş alanında Araçlar düğmesini (etkin bir kaydırma çubuğu veya liste simgesiyle gösterilir) tıklayın ya da / yazarak kısayol kataloğunu açın.
  4. Listeden Tuval (Önizleme)'i seçin. Bu, Gemini'a bir sonraki isteminizin yapılandırılmış bir metin belgesi derlemeyi amaçladığını bildirir. Kanvas arayüzünü seçin

2. adım: Temellendirilmiş mimari karar kaydı (ADR) oluşturma

Motor, canlı proje ölçütlerine dayalı resmi bir mimari karar kaydı (ADR) oluşturmak için başlangıç olarak belirlediğiniz BLP Jira projenizi ve Confluence çalışma alanlarınızı taramaya yönlendirilir.

  1. Etkin Canvas istem alanınıza aşağıdaki istemi girin: 
    Scan the connected BLP Jira project and compile a detailed Architecture Decision Record (ADR) for our new real-time geolocation profile matching engine. Ground the context in our active tickets, specifically referencing BLP-1 and the performance issues in BLP-2.
  2. Gönder'i tıklayın.
  3. Çalışma alanının iki panelli görünüme bölündüğünü izleyin. Sağ taraftaki Doküman Düzenleyici Canvas, profesyonel ve iyi biçimlendirilmiş bir Markdown biçimli dokümanı dinamik olarak oluşturur. Canvas, ADR belgesi oluşturur ADR Belgesi Oluşturuldu

Oluşturulan ADR (ADR-002: Anlık Coğrafi Konum Profili Eşleştirme Motoru için Mimari Plan başlıklı) genellikle şunları içerir:

  • Durum: Önerildi
  • Bağlam ve Sorun Açıklaması: Özellikle gerçek zamanlı yakınlık özelliği eşleşmesi (BLP-1) ve döngü iş parçacığı/bellek sızıntıları (BLP-2) belirtiliyor.
  • Karar (Uzamsal Dizine Eklenmiş, Tepkisel Olay Döngüsü): Hesaplama karmaşıklığını azaltmak için Uber'in H3 Uzamsal Dizine Ekleme Sistemi (8-10 altıgen aralık çözünürlüğü) ve eşzamanlılığı sınırlamak ve BLP-2'deki iş parçacığı sızıntılarını tamamen çözmek için geri basınçlı (sınırlı engelleme kuyrukları) sınırlı yürütücü iş parçacığı havuzu öneriliyor. Ayrıca, hücrelerde yerelleştirilmiş küresel geometri mesafesi filtreleme için Haversine Formülü'nü oluşturur.
  • Değerlendirilen Alternatif Çözümler: Geleneksel R-Tree/PostGIS ST_DWithin sorguları (A seçeneği, veritabanı sorgu gecikmesi nedeniyle reddedildi) ve sınırsız kullanıcı başına iş parçacığı (B seçeneği, doğrudan BLP-2 iş parçacığı sızıntılarına neden olduğundan reddedildi).
  • Sonuçlar: Belirleyici kaynak kullanımı, öngörülebilir gecikme, uç koordinat arama değiş tokuşları.
  • Etkin Biletler İçin Eşleme ve Sonraki Adımlar: Yapılandırılmış iş parçacığı havuzları ve nesne havuzları kullanarak BLP-1 ve BLP-2 sorunlarını çözmek için belirli kod yolları.

3. adım: Tuvalde hedeflenen satır içi iyileştirme

Canvas'ın en önemli özelliklerinden biri, hedefli ve yerel yapay zeka düzenleme işlevidir. Sohbet penceresinde dokümanın tamamı için yeniden istem girmeniz gerekmez. Bunun yerine satır içi düzenleme yaparsınız.

  1. Sağ taraftaki Belge Düzenleyici Tuvali bölmesine gidin.
  2. Karar bölümüne gidin ve imlecinizle vurgulayarak önbellek geçersiz kılma stratejisinin ele alındığı paragrafı seçin. Canvas'ta metin vurgulama
  3. Metin vurgulanır vurgulanmaz, seçimin hemen üzerinde kayan bir mikro araç çubuğu açılır. Araç çubuğundaki kalem simgesini (satır içi Gemini'a Sor istemi seçeneği) tıklayın. Bir metin girişi balonu açılır. Satır içi kayan kalem araç çubuğu
  4. Giriş balonuna, kesin düzeltme talimatlarınızı girin:
    Specify that we must implement a Redis-based in-memory cache running on Memorystore, with a default TTL of 10 minutes and absolute cache invalidation metrics synced via GitHub branch optimize-cache.
  5. Gönder'i tıklayın (veya Enter tuşuna basın).
  6. Sağ paneli inceleyin: Yapay zeka, yalnızca seçilen belirli bloğu yerinde günceller ve Redis Memorystore parametrelerini kalıcı taslağa sorunsuz bir şekilde entegre eder.

4. adım: Workspace'ten doğrudan Confluence'e dışa aktarma

Belgeniz düzenlendiğine göre, şimdi onu mühendislik Confluence alanınıza aktarabilirsiniz. Doğrudan kullanıcı arayüzü dışa aktarma işlemi, mevcut boş sayfaların güncellenmesini desteklemediğinden asistanı dinamik olarak yeni bir sayfa oluşturmaya yönlendirmek için soldaki sohbet arayüzünü kullanacaksınız.

  1. İlginizi tekrar soldaki Etkileşimli Sohbet bölmesine yönlendirin. Canvas'ta düzeltilmiş ADR ile sol taraftaki Sohbet Paneli'ne geri dönme
  2. İstem giriş kutusuna yayınlama talimatınızı yazın:
    can you create a new Confluence page in space "Bumble Engineering Space" with this ADR?
  3. Gönder'i tıklayın. Gemini'dan Confluence'e aktarmasını isteme
  4. Gemini, Atlassian bağlayıcı API'si ile iletişim kurar, Canvas ADR dokümanını paketler ve Confluence çalışma alanınızda yeni bir resmi sayfa olarak yayınlar. Confluence sayfası başarıyla oluşturuldu
  5. Web tarayıcınızda Atlassian Confluence portalınızı açın. Bumble Engineering Space (BMBENG) bölümünde, yeni sayfanın yapılandırılmış ADR planıyla tamamen doldurulduğunu doğrulayın. Confluence portalı doğrulandı

16. Deterministik Yayın Yönetimi İş Akışı Ajanları

Bu adımda, doğal dil sohbetinden katı ve deterministik bir yayın otomasyonu akışı oluşturmaya geçiş yapacaksınız. Doğal dil istemlerini kullanarak İş Akışı Temsilcisi oluşturmak için Agent Designer (EAP) görsel akış oluşturucusunu kullanacaksınız. Tasarımcı, yapılandırılmış veritabanı kontrollerini bağımsız olarak oluşturur, etkin sorunlara göre mantıksal yolları bir If/Else koşuluyla yönlendirir ve Google Drive yazma işlemlerini yapılandırır.

Kullanıcı Arayüzü Düzeni Açıklaması

İş Akışı Aracısı Oluşturucu'yu açtığınızda ekran, az kodlu bir ızgara çizgili çalışma alanına dönüşür:

  • Düzenleyici tuvali: Ekranın ortasında yer alan, ızgara çizgili geniş bir panel. Görsel mantık akışınızı temsil eder. Dikdörtgen bloklar (düğümler), işlemleri ve akış adımlarını temsil eder. Bunlar, yürütmeyi yukarıdan aşağıya yönlendiren görsel, yönlü bağlantı çizgileriyle birbirine bağlanır.
  • Sağ Yapılandırma Tepsisi: Sağ taraftaki dikey inceleme paneli. Tuvalde bir düğümü tıkladığınızda bu tepside bağlama duyarlı yapılandırma alanları, giriş değişkenleri, koşul kutuları ve bağlayıcı ayarları gösterilir.

1. adım: Yeni bir iş akışı aracısı oluşturun

  1. Gemini Enterprise web uygulamanızda sol kenar çubuğuna gidin ve Aracıları tıklayın.
  2. Üst çubukta + Create Agent'ı (Ajan oluştur) tıklayın.
  3. Aracı stili seçim kartı pop-up'ında İş Akışı Aracısı'nı seçin (veya şablonları atlamak için Manuel olarak başlat'ı tıklayın).
  4. Görsel düzenleyici tuvali açılır ve hangi akışı oluşturmak istediğinizi soran bir istem pop-up'ı görünür. İş akışı aracısı oluşturma paneli

2. adım: Doğal dil ile iskele oluşturma

Düğümleri manuel olarak sürükleyip bağlamak yerine, doğal dil iş akışı derleyicisinden tüm mantıksal mimariyi sizin için bağımsız olarak oluşturmasını isteyeceksiniz.

  1. İstem kutusuna aşağıdaki ayrıntılı istemi yapıştırın:
    Create a deterministic workflow agent named 'Bumble Release Gatekeeper' triggered on a daily schedule.

The workflow must execute these sequential steps:
1. First, connect to my Jira app to search for active issues in project 'BLP' that have a priority of 'P0' or 'P1' and are in the 'To Do' or 'In Progress' status.
2. Next, insert a conditional If/Else branching node that branches on the count of issues returned by my Jira Search node:
   - True Branch (count greater than 0): run a 'P0/P1 Blocker Escalation Review' step that emails the active blockers in project BLP to '[YOUR_EMAIL]' so the delivery lead is notified that blockers exist before release.
   - False Branch (count equals 0): upload a text file named 'release_authorization_log.txt' inside my Google Drive root directory. The file content must log that no blockers were detected and that the release check was automatically authorized with the current execution timestamp.
    İstemi göndermeden önce [YOUR_EMAIL] yer tutucusunu tercih ettiğiniz e-posta adresiyle değiştirin.
  2. Gönder'i tıklayın. Doğal Dil İşleme İş Akışı İstemini Gönderme
  3. Derleyici tuvalini inceleyin: Agent Designer, doğal dil adımlarınızı işler ve aşağıdakileri içeren eksiksiz bir görsel akış çizelgesi oluşturur:
    • Başlatma Tetikleyicisi (Program): Günlük olarak ayarlayın.
    • Jira (Sorun Ara) düğümü.
    • P0/P1 sorun sayısına göre dallanan Koşul (Eğer/Aksi takdirde) düğümü.
    • Gerçek Dal: Etkin engelleyicilere [YOUR_EMAIL] adresine e-posta gönderen bir P0/P1 Blocker Escalation Review (P0/P1 Engelleyici Sorun Yükseltme İncelemesi) işlemidir.
    • Yanlış dal: Google Drive (Dosya Yükle) düğümü (release_authorization_log.txt oluşturma).

3. adım: Bağlayıcı yapılandırmalarını doğrulayın ve iyileştirin

Oluşturulan her düğümün, etkin veri bağlayıcı kimlik bilgilerinizle düzgün şekilde bağlı olduğunu doğrulayalım.

  1. Görsel tuvalde Jira (Sorunları Ara) düğümünü tıklayın. Sağ Yapılandırma Tepsisi'nde Atlassian Jira veri deposunun seçili olduğunu ve JSON arama filtresinin BLP projesindeki etkin P0/P1 sorunlarını hedefleyecek şekilde yapılandırıldığını doğrulayın. Jira Search düğümünü doğrulama
  2. Koşul (Eğer/Aksi halde) düğümünü tıklayın. Sağ tepsiden, dallanma ifadesinin Jira sorunlarının uzunluğunun 0'dan büyük olup olmadığını kontrol edecek şekilde ayarlandığını doğrulayın. Koşul düğümünü doğrulama
  3. Görsel tuvalde True-branch node'u (P0/P1 Blocker Escalation Review) tıklayın. Sağ tepsiden, projedeki etkin engelleyicilere BLP istemde ayarladığınız e-posta adresine ([YOUR_EMAIL]) e-posta gönderecek şekilde yapılandırıldığını doğrulayın. Bu, yalnızca If/Else True yolundaki işlemdir. Ayrı bir onay kapısı yoktur. Doğru dalı yönlendirme düğümü yapılandırmasını doğrulama
  4. Google Drive (Dosya Yükle) düğümünü (Yanlış dal) tıklayın. Bu dosyanın Drive bağlayıcınıza bağlı olduğundan ve geçerli zaman damgası değişkeniyle release_authorization_log.txt dosyasını kök dizininize yükleyecek şekilde yapılandırıldığından emin olun. Drive Uploader düğümünü doğrulama

4. adım: İş akışı aracısını test edin ve yayınlayın

Akış iskeleti oluşturulduktan ve düğümler doğrulandıktan sonra önizleme alanında mantığı test edin, ardından ajanı günlük programına göre çalışacak şekilde yayınlayın.

  1. Düzenleyicinin üst orta kısmındaki sekme çubuğunu bulun ve Önizleme sekmesine geçin. Akışı canlı olarak doldurulmuş verilerinizle yürütmek için Simülasyonu Çalıştır'ı / İş Akışını Tetikle'yi tıklayın ve yürütme rotasının tuvalde parlayan yeşil bir izleme yolu olarak aydınlanmasını izleyin.
  2. If/Else mantığını izleyin:
    • Daha önce kritik bir P1 hatası (BLP-2) eklediğiniz için Search BLP Blockers düğümü sonuç döndürür. Bu nedenle, Check Blocker Count koşulu sıfırdan büyük olarak değerlendirilir ve True dalı P0/P1 Blocker Escalation Review işlemini (engelleyicileri [YOUR_EMAIL] adresine e-postayla gönderme) çalıştırır.
    • Bunun yerine Yanlış dalı kullanmak için Jira filtresini eşleşen sorun içermeyen bir anahtara (ör.BLP_NONE) göre ayarlayın, yeniden çalıştırın ve izlemenin Log Release Authorization'a aktığını doğrulayın. Ardından, Google Drive'a release_authorization_log.txt yazın.
  3. Akıştan memnun kaldığınızda düzenleyicinin sağ üst köşesindeki Yayınla'yı tıklayın. Aracı yayınla iletişim kutusunda, aracının yeni bir yayınlanmış sürümünü oluşturmak için Yayınla'yı tıklayın (yalnızca yayınlamadan yapılandırmanın anlık görüntüsünü almak istiyorsanız Yalnızca sürümü kaydet'i seçin). Bumble Release Gatekeeper için temsilci yayınlama onay iletişim kutusu
  4. Soldaki gezinme menüsünden Aracılar galerisini açın. Ajanlarınız bölümünde, Bumble Release Gatekeeper iş akışı aracınızın artık (daha önce oluşturduğunuz Lead Scrum Master aracının yanında) göründüğünü ve günlük programında çalışmaya hazır olduğunu onaylayın. Yayınlanmış ve Ajanlar galerisinde listelenen Bumble Release Gatekeeper aracısı

17. Yarışma Laboratuvarı: ADK ile Oluşturma ve Dağıtma (İsteğe Bağlı)

1. adım: Ortam kurulumu

Bu mücadeleyi, gerekli tüm komut satırı araçlarının önceden yüklü olduğu Google Cloud Shell'de gerçekleştireceğiz.

  1. Google Cloud Console'u açın.
  2. Sağ üst köşedeki Cloud Shell'i etkinleştir simgesini (terminal simgesi) tıklayın.
  3. Ortamın yüklendiğini doğrulayın. Araç kurulumunu inceleyebilirsiniz: Cloud Shell Ortamı

2. adım: Kimlik doğrulama ve kurulum

Derleme işleminden önce hem genel Antigravity istemcisinin hem de özel Agent CLI'nın kimliğini doğrulamanız gerekir.

  1. Proje kimliğinizi ayarlayın ve Antigravity CLI'ya giriş yapın: 
    export GOOGLE_CLOUD_PROJECT=[YOUR_PROJECT_ID]
agy login
  2. Terminalde sağlanan yetkilendirme URL'sini tıklayın, kimlik bilgilerinizle kimliğinizi doğrulayın ve jetonu tekrar CLI'ya yapıştırın.
  3. Etkileşimli modda aracı KSA'ya giriş yapın: 
    agents-cli login --interactive
  4. ADK becerilerini yükleyin: ADK aracı kitaplıklarını yüklemek için kurulum komutunu çalıştırın: 
    uvx google-agents-cli setup

3. adım: Antigravity CLI yöntemi (doğal dil kodlaması)

Python kodunu manuel olarak yazmak yerine Antigravity CLI kodlama aracından bizim için bağımsız olarak iskele oluşturmasını, kodu yazmasını ve birim testini yapmasını isteyeceğiz.

  1. Antigravity CLI oturumunu başlatın: 
    agy
  2. Kodlama Aracına İstem Gönderme: İstem kutusuna aşağıdaki talimatı girin:
Using the Agent Development Kit (ADK) Python SDK, build me an agent named 'Bumble-Ops-Assistant' that has a python tool function to check build health for prod and staging environments. The tool should just return a hardcoded 'GREEN' status for now. Once scaffolded and coded, run a unit test and an evaluation smoke test for me in this folder.
  1. Autonomous Coding'i gözlemleyin: Antigravity CLI aşağıdaki sırayı otomatik olarak yürütürken terminal günlüklerini izleyin:
    • agents-cli scaffold create komutunu arka planda çalıştırır.
    • app/tools.py içine Python aracı işlevlerini yazar (sabit kodlanmış "GREEN" derleme durumunu döndürür).
    • app/agent.py'da aracı talimatlarını yapılandırır.
    • Bağımlılıkları yükler.
    • Çalışma alanında birim testleri oluşturur ve çalıştırır. Bu sayede derlemenin başarılı olduğu gösterilir.

4. adım: Oluşturulan kodu inceleyin ve Playground'u çalıştırın

  1. Cloud Shell Düzenleyici'yi açın (Cloud Shell üst menüsünde Open Editor'ı (Düzenleyiciyi Aç) tıklayın).
  2. bumble-ops-assistant klasörüne gidin. CLI tarafından oluşturulan dosyaları inceleyin:
    • app/tools.py: Özel Python aracı işlevlerinizi barındırır.
    • app/agent.py: Aracınız için sistem istemlerini, sistem talimatlarını ve araç kayıtlarını ayarlar.
  3. Şimdi de yerel terminal deneme alanında etkileşimli olarak aracıyı test edelim.

Oyun alanını çalıştırmak için:

agents-cli playground --app bumble-ops-assistant
  1. Oyun alanı oturumu başladıktan sonra temsilciye şunu sorun:
How is the prod build environment looking?

Gemini, yerel aracıyı yükler, Python aracı işlevini arka planda yürütür ve "GREEN" durumuyla yanıt verir. ADK playground oturumu, YEŞİL derleme durumunu döndürüyor Playground Test Sonuçları

18. Yarışma Laboratuvarı: Gemini Enterprise'da yayınlama (isteğe bağlı)

ADK aracınız yerel olarak derlenip test edildiğinden artık Agent Runtime'a dağıtabilir ve teknik bilgisi olmayan ekip üyelerinin erişebilmesi için şirketinizin Gemini Enterprise galerisinde yayınlayabilirsiniz. Dağıtım/yayınlama deneyiminin ortama göre değişiklik gösterebileceğini unutmayın.

1. adım: Agent Runtime'a dağıtın

Aracı mantığını güvenli bir şekilde barındırmak için yönetilen çalışma zamanına dağıtırız:

agents-cli deploy --deployment-target agent_runtime --no-confirm-project

CLI dağıtım otomasyonu sırasını inceleyelim: Dağıtım başlatma Barındırılan çalışma zamanına dağıtma Hizmet Etkinleştirme Başarılı

Çalışma zamanında barındırılan ajanı, ekibinizin galerisinde yayınlayın:

agents-cli publish gemini-enterprise --interactive
  1. CLI, projenizde yapılandırılan hedef Gemini Enterprise Uygulaması'nı seçmenizi ister. Uygulamanızı seçin.
  2. Görünen adı ayarlayın: Bumble Platform Health yazın.

Etkileşimli yayıncılık sırasını inceleyelim: Yayınlama Komutunun Çalıştırılması Etkileşimli Hedef Yapılandırması Meta Veri Senkronizasyonu Geçişi Portal Paketleme Uygulaması Yayınlama Başarılı Onayı

3. adım: Acente Kayıt Defteri'nde doğrulama

Google Cloud Console'unuzu açın. Gemini Enterprise Agent Platform çalışma alanına gidin ve Agent Registry'yi seçin (Bunun, Corp Yönetici Konsolu'nda değil Gemini Enterprise Agent Platform kayıt defterinde bulunduğunu unutmayın). Özel Bumble Platform Health aracınız, Bumble ürün ve mühendislik yöneticileriyle paylaşılmaya hazır şekilde, önceden oluşturulmuş tüm seçeneklerle birlikte listelenir.

Dağıtılan ajanı gösteren Agent Runtime'daki dağıtımlar Yayınlanan ajan, Gemini Enterprise'da açıldı ve sorgu göndermeye hazır Gemini Enterprise sohbetinde çalışan ve YEŞİL derleme durumu döndüren yayınlanmış ajan

Daha fazla bilgi için resmi geliştirici kılavuzuna bakın: Gemini Enterprise Agent Platform Runtime Docs

19. Temizleme

Bağlayıcı senkronizasyonu ve kaynaklar için sürekli faturalandırmayı önlemek amacıyla lütfen sağlanan öğeleri temizleyin.

  1. Oluşturduğunuz Özel Ajanları Silme: Bu atölye çalışması sırasında oluşturulan tüm ajanları kaldırarak hiçbirinin çalışmaya devam etmemesini sağlayın:
    • Agent Designer'daki Lead Scrum Master sohbet aracısı ve iki alt aracısı (Jira-Analyst ve GitHub-Analyst).
    • Bumble Release Gatekeeper iş akışı ajanı.
    • Bumble Platform Health olarak yayınlanan dağıtılmış ADK ajanı (dahili kimliği Bumble-Ops-Assistant) — Gemini Enterprise Agent Platform > Agent Registry'ye gidin ve dağıtımı silin.
  2. Gemini Enterprise uygulamasını silme: Özel bir Bumble portal uygulaması oluşturduysanız Uygulama yönetimi sayfasına gidin ve Sil'i tıklayın.
  3. Veri depolarını silin: Google Cloud Console Arama'da Vertex AI Agent Builder > Veri Depoları'nı açın ve bağladığınız tüm veri depolarını (Jira, Confluence ve GitHub) ve bağladıysanız Google Drive bağlayıcısını silin. Böylece hiçbir şey senkronize edilmeye veya faturalandırılmaya devam etmez.
  4. GCP projesini silme (isteğe bağlı): Bu atölyeyi özel bir sanal alan projesinde gerçekleştirdiyseniz tüm kaynakları tek seferde temizlemek için projenin tamamını Google Cloud Resource Manager'dan silebilirsiniz.

dikkat Kalıcı Silme: Veri depolarını, uygulamaları ve projeleri silme işlemi tamamen kalıcıdır. Silinen bu yapılandırmalar kurtarılamaz ve etkin atölye yapılandırmaları hemen yok edilir.

20. Tebrikler

Bumble Gemini Enterprise 1. Gün Atölyesi'ni tamamladınız.

Öğrendikleriniz

  • Jira, Confluence, GitHub ve Google Drive için veri bağlayıcılarını yapılandırma.
  • Dokümanlarda, çalışma alanlarında ve canlı yürütme verilerinde temellendirilmiş analiz.
  • Alt temsilcilerle çok adımlı temsilciler oluşturma
  • Proje durumu özeti oluşturmak için hazır Proje Güncellemeleri beceri şablonunu çağırma.
  • Gemini Asistan Canvas'ta ADR'leri birlikte yazma ve bunlardan yeni Confluence sayfaları oluşturma
  • Doğal Dil Akışı Oluşturucu'yu kullanarak deterministik iş akışları oluşturma
  • ADK ve Antigravity CLI (agy) kullanarak profesyonel temsilciler geliştirme, dağıtma ve yayınlama.

Referans belgeleri