1. Giriş
Pazartesi sabahı ve CFO size mesaj gönderdi. Ortalama sipariş değeri bu ay% 7 düşerken toplam gelir aynı kaldı. Bir şeyler ters gidiyor ve yönetim kurulu cuma gününe kadar yanıt istiyor.
Şirketiniz Cymbal Pets, ABD'deki en büyük online evcil hayvan malzemeleri perakendecilerinden biri. İhtiyacınız olan veriler üç Google Cloud hizmetine dağılmış durumda: BigQuery'deki satış ve sipariş geçmişi, Cloud SQL'deki müşteri ve ürün kayıtları, Cloud Storage'daki pazarlama dosyaları. Normalde, bu tür bir hizmetler arası inceleme yapmak için konsollar arasında geçiş yapmanız, bağlantı için standart metinler yazmanız ve sonuçları manuel olarak birleştirmeniz gerekir.
Bu codelab'de, doğal dili kullanarak anormalliği araştırmak için Antigravity IDE'de Google Cloud Data Agent Kit'i (DAK) kullanacaksınız. Aradığınızı açıklarsınız ve yapay zeka aracısı BigQuery, Cloud SQL ve Cloud Storage'daki bağlantıları, SQL'i ve hizmetler arası birleştirmeleri yönetir. Sorunu çözdükten sonra, temsilciden bulgularınızı kullanıma sunmak için bir dbt ardışık düzeni oluşturmasını, gerçek bir veri modelleme hatasında hata ayıklamasını ve CFO'ya tahmine dayalı bir öneri sunmasını isteyeceksiniz.
Yapacaklarınız
- Knowledge Catalog'u kullanarak BigQuery, Cloud SQL ve Cloud Storage'daki veri varlıklarını keşfedin.
- MCP Araçları'nı kullanarak tek bir görüşmede birden fazla hizmeti sorgulayarak anormallikleri inceleme
- Hizmetler arası verileri hazırlama modelleri ve otomatik testlerle hazırlamak ve birleştirmek için dbt ardışık düzeni oluşturma
- Aracı, fan-out hatasını kendi kendine teşhis edip yeniden düzenlerken veri modelleme sorununu ayıklama
- BigQuery'nin
AI.FORECASTişlevini kullanarak gelecekteki trendleri tahmin edin ve veriye dayalı bir öneri sunun.
İhtiyacınız olanlar
- Chrome gibi bir web tarayıcısı
- Antigravity IDE
- Faturalandırmanın etkinleştirildiği bir Google Cloud projesi ve Google Cloud Console'a erişim (uygulamalı laboratuvarlar için yeni ve özel bir proje kullanmanızı öneririz)
- SQL ve Google Cloud Console hakkında temel düzeyde bilgi sahibi olma
Bu codelab, orta düzey veri uzmanları (analiz mühendisleri, veri analistleri, veri bilimciler) içindir.
Bu codelab'de oluşturulan kaynakların maliyeti 5 ABD dolarından az olmalıdır. Sağlanan kaynakları silmek için laboratuvarın sonundaki Temizleme talimatlarını uyguladığınızdan emin olun.
2. Başlamadan önce
Bu bölümde, tüm laboratuvar ortamınızı sağlayan bir kurulum komut dosyası çalıştıracaksınız: sipariş verilerini içeren bir BigQuery veri kümesi, müşteri ve ürün verilerini içeren bir Cloud SQL Postgres örneği ve promosyon kampanyası kayıtlarını içeren bir Cloud Storage paketi. Komut dosyasının tamamlanması yaklaşık 8-10 dakika sürer. Bu süre içinde Cloud SQL temel hazırlığı en çok zaman alan kısımdır.
Proje seçin veya oluşturun
Google Cloud Console'da mevcut bir projeyi seçin veya yeni bir proje oluşturun.
Faturalandırmayı doğrulama
Google Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Bu işlemi nasıl yapacağınız hakkında daha fazla bilgi edinmek için bu kılavuzu inceleyebilirsiniz.
Cloud Shell'i Başlatma
Kurulum komut dosyasını çalıştırmak için Google Cloud Shell'i kullanacaksınız.
- Google Cloud Console'u açın ve pencerenin üst kısmındaki Cloud Shell'i etkinleştir'i tıklayın.

- Bağlandıktan sonra proje kimliğinizi ayarlayın ve ortamınızı onaylayın:
gcloud config set project <<YOUR_PROJECT_ID>>
export PROJECT_ID=$(gcloud config get-value project)
Şuna benzer bir mesaj görürsünüz:
Your active configuration is: [cloudshell-####] Updated property [core/project]
Depoyu klonlama
Codelab deposunu Cloud Shell kabuk ortamınıza klonlayın:
cd ~/
git clone --filter=blob:none --no-checkout https://github.com/GoogleCloudPlatform/devrel-demos.git
cd ~/devrel-demos
git sparse-checkout init --cone
git sparse-checkout set codelabs/agentic-data-labs
git checkout main
cd codelabs/agentic-data-labs/
Kurulum komut dosyasını çalıştırma
Kurulum komut dosyası, tüm laboratuvar ortamınızı otomatik olarak hazırlar. Böylece doğrudan incelemeye başlayabilirsiniz:
cd ~/devrel-demos/codelabs/agentic-data-labs/scripts
chmod +x setup.sh setup_sql.sh
./setup.sh
İşlem tamamlandığında ön plan ortamınızın özetini görürsünüz:
╔══════════════════════════════════════════════════════╗
║ Base Setup complete! ║
╚══════════════════════════════════════════════════════╝
Your core BigQuery and GCS assets are ready.
Cloud SQL is currently provisioning in the background and will be fully ready by Step 4.
BigQuery: YOUR_PROJECT_ID.cymbal_pets
├── orders
└── order_items
GCS: gs://YOUR_PROJECT_ID-cymbal-pets-raw
└── promo_events.json
Laboratuvarın sonraki adımlarına devam ederken veritabanı arka planda sağlanır ve doldurulur. İlerlemeyi istediğiniz zaman ayrı bir terminal panelinde aşağıdaki yöntemlerle izleyebilirsiniz:
tail -f /tmp/cloudsql_setup.log
Veri mimarisine dikkat edin: Geçmiş satış kayıtları (siparişler ve sipariş öğeleri) BigQuery'de, operasyonel uygulama verileri (müşteriler, evcil hayvan profilleri ve ürünler) ise Cloud SQL'de bulunur. Bu ayrım, analitik veri ambarlarının ve operasyonel veritabanlarının yapbozun farklı parçalarını tuttuğu gerçek dünya kuruluşlarını yansıtır.
Bölüm Özeti: Laboratuvar ortamınızı başlatmak için kurulum komut dosyasını çalıştırdınız ve arka planda veritabanı sağlama işlemini başlattınız.
3. IDE ve Veri Aracısı Kit'ini ayarlama
Antigravity IDE'yi açın.
Cloud SQL'in işlemi tamamlamasını beklemeniz gerekmez. Antigravity IDE'yi açıp Google Cloud projenize bağlayın.
- Henüz yapmadıysanız Antigravity IDE'yi Google Antigravity indirme sayfasından indirip yükleyin.
- Antigravity IDE masaüstü uygulamasını başlatın.
- Yerel makinenizde yeni ve boş bir klasör oluşturun (ör.
agentic-data-labsadında) ve Open Folder'ı (Klasörü Aç) seçerek bu klasörü IDE'de açın. Bu, codelab için yerel çalışma alanınız olarak işlev görür.

Data Agent Kit uzantısını yükleme
Google Cloud Data Agent Kit uzantısı, BigQuery, Cloud SQL ve Cloud Storage için bir veri kataloğu tarayıcısı, aracı becerileri ve MCP sunucuları ekler. Böylece, bu hizmetleri düzenleyiciden sorgulayabilir ve inceleyebilirsiniz.
- Antigravity IDE'de, ekranın en sol tarafındaki etkinlik çubuğunda Uzantılar simgesini (dört kareye benzer) tıklayın.
- Uzantılar bölmesinin üst kısmındaki arama çubuğuna
Google Cloud Data Agent Kityazın. - Google Cloud Data Agent Kit adlı ilk sonucu (
googlecloudtoolstarafından yayınlanmıştır) bulun. - Yükle düğmesini tıklayın.
- "googlecloudtools" yayıncısına ve uzantılarına güveniyor musunuz?" sorusunu içeren bir istem görünebilir. Devam etmek için Yayıncılara güven ve yükle'yi tıklayın.

Yüklendikten sonra Antigravity IDE'nin en solundaki Etkinlik Çubuğu'nda yeni bir Google Cloud Data Agent Kit simgesi görünür.
Uzantının kimliğini doğrulama ve uzantıyı yapılandırma
Yükleme işleminden sonra uzantıyı Google Cloud projenize bağlayın.
- "Google Cloud Data Agent Kit'e hoş geldiniz" başlıklı bir ilk katılım sayfası otomatik olarak açılır. Cloud hesabınızda oturum açmadıysanız erişime izin vermek için istemleri uygulayın.
- Yapılandırma Özeti bölümünde proje alanını bulun. Açılır listeyi tıklayın ve Google Cloud projenizi seçin. Bölgenizi
us-central1olarak ayarlayın. Ardından MCP Sunucularını Yapılandır'ı seçin.

- MCP Yapılandırması bölmesinde, BigQuery ve Cloud SQL'i etkinleştirmek için tıklayın. Ardından Başlayın'ı tıklayın.

Yapılandırma seçeneklerini keşfetme
Kurulum tamamlandıktan sonra "Google Cloud Veri Aracısı Kiti'ni kullanmaya başlama" sayfasına yönlendirilirsiniz.
- "Kurulum ve Yapılandırma " bölümünde Başlayın'ı tıklayın.
- Bu işlem, Veri Aracısı Kiti Yapılandırması panelini açar. Sekmeleri keşfedin:
- Proje ve Bölge: Seçtiğiniz proje kimliğini doğrulayın ve gerekli API'lerin (Cloud Storage API, BigQuery API, Catalog API ve Cloud SQL Admin API) etkinleştirildiğini kontrol edin.
- BigQuery: BigQuery sorgularınız için varsayılan konumu yapılandırın. Bölgeyi
us-central1kullanın. - MCP sunucularını yapılandırın: Yapay zeka aracılarına verilerinizle güvenli bir şekilde etkileşim kurma olanağı tanıyan etkin MCP sunucularını (BigQuery, not defterleri, Cloud SQL vb.) görüntüleyin.
- Beceriler: Temsilcilere karmaşık veri görevleri için özel yetenekler sağlayan önceden oluşturulmuş becerileri keşfedin.

Bölüm Özeti: Antigravity IDE'yi açtınız, Google Cloud projenize bağladınız ve Data Agent Kit uzak MCP sunucularını yapılandırdınız.
4. Verilerinizi keşfetme
Ortamı hazırlama zamanı. Durum şöyle: CFO, geçen ay ortalama sipariş değerinin% 7 düştüğünü ancak toplam gelirin değişmediğini söylüyor. Ajanın araştırmasına başlamasını istemeden önce hangi verilerle çalıştığınızı anlamanız gerekir.
Bu bölümde, Data Agent Kit panelini manuel olarak keşfederek genel bir fikir edineceksiniz. Verilerinizi sorgulamaya başlamadan önce anlamak, herhangi bir incelemenin önemli ilk adımıdır.
BigQuery tablolarını keşfetme
- Veri Aracısı Kiti panelindeki KATALOG bölümünde projeniz → BigQuery →
cymbal_pets'yi genişletin. orderstablosunu tıklayın. Tablonun ayrıntılarını gösteren yeni bir sekme açılır.- Tablo görüntüleyicinin sol tarafındaki sekmeleri inceleyin:
- Veri: Gerçek satırları önizleyin. Veri kümesini kaydırın ve sütunları inceleyin.
- Şema: Sütun adlarını ve türlerini inceleyin. Daha sonra önemli hale gelecek
order_typevepromo_codegibi alanlara dikkat edin. - Diğer sekmeler (Ayrıntılar, Analizler, Veri Profili vb.): Normalde Google Cloud Console'da bulacağınız meta verilere, veri soyuna ve kalite ayrıntılarına düzenleyicinizden ayrılmadan erişin.

- Şimdi
order_itemstablosunu tıklayın ve şemasını inceleyin.quantityvepricealanlarına dikkat edin.
Cloud SQL tablolarını keşfetme
Kurulum komut dosyası, müşteri, evcil hayvan ve ürün verilerini Cloud SQL'deki bir PostgreSQL veritabanına da yerleştirdi.
- Veri Aracısı Kiti panelinde, CATALOG bölümündeki Universal Search'ü (Evrensel Arama) tıklayın.
- Arama kutusuna
pet_profilesyazıp Enter tuşuna basın. - Arama sonuçlarında,
pet_profilesiçin PostgreSQL Tablosu sonucunu (projenizin Cloud SQL örneği altında) tıklayın. Kenar çubuğu akordeonunun otomatik olarak genişlediğini ve tablonun veritabanı ağacında tam olarak nerede bulunduğunu gösterdiğini unutmayın. Ayrıntılarını açmak için ağaçta hemen üstünde bulunancustomerstablosunu tıklayın ve Şema ile Ayrıntılar sekmelerini inceleyin.

Cloud Storage dosyalarını keşfetme
Son olarak, pazarlama ve tanıtım kampanyası kayıtları Cloud Storage'da ham JSON dosyaları olarak depolanır.
- Soldaki Veri Aracısı Kiti panelinde CLOUD STORAGE (BULUT DEPOLAMA) bölümünü genişletin. Projenizin ham paketini (
YOUR_PROJECT_ID-cymbal-pets-raw) bulun. - Paketin içindeki
promo_events.jsondosyasını tıklayın. Yeni bir düzenleyici sekmesi açılır. Bu sekmede, pazarlama kampanyalarının ham JSON içeriğini doğrudan IDE'de görüntüleyebilirsiniz.

Envanter çıkarma
Veriler hakkında artık bildikleriniz:
Hizmet | Tablolar | Ne var? |
BigQuery |
| ~1,9 milyon sipariş, ~4,3 milyon satır öğesi, tarih aralığı 2023-2025 |
Cloud SQL |
| ~92.000 müşteri, ~7.600 evcil hayvan profili, 206 ürün |
Cloud Storage |
| Promosyon kampanyası kayıtları |
Veriler üç hizmete yayılmıştır. Geleneksel bir iş akışında bağlantıları ayarlamanız, entegrasyon kodu yazmanız ve sonuçları manuel olarak birleştirmeniz gerekir. Bir sonraki adımda, tüm bunları tek bir görüşme üzerinden yapay zeka ajanı tarafından ele alınmasını sağlayacaksınız.
Bölüm Özeti: BigQuery, Cloud SQL ve Cloud Storage'daki veri mimarisini manuel olarak keşfetmek için Veri Aracısı Kiti panelini kullandınız. Verilerin nerede bulunduğunu ve hangi alanların kullanılabildiğini öğrendiğinize göre artık incelemeye başlayabilirsiniz.
5. Sayıları takip edin
Soruşturma şimdi başlıyor. Yapay zeka temsilcisinden BigQuery'den ortalama sipariş değeri (OSD) verilerini çekmesini istemek için Sohbet bölmesini kullanacaksınız. OSD, sipariş başına harcanan ortalama tutarı temsil eden bir işletme metriğidir. Ajan, MCP Araçları'nı kullanarak sizin adınıza sorgu oluşturur ve çalıştırdığı her SQL sorgusunu görebilirsiniz.
Ortalama sipariş değeri trendini çekme
- IDE'nin sağ tarafındaki Sohbet bölmesinde aşağıdaki istemi yazıp Enter tuşuna basın:
Calculate our monthly average order value from August 2024 through January 2025 using the orders and order_items tables in BigQuery. - Veri erişimi izinlerini onaylayın. Veritabanlarınızda sorgu çalıştıran yapay zeka ajanları konusunda dikkatli olmanız gerekir. Veri Aracısı Kiti, verilere erişmeden önce açık izin isteyerek kontrolü size bırakır. İstendiğinde şunları seçebilirsiniz:
- Bu süreye izin verin: Tek kullanımlık bir işlemi onaylar (yüksek riskli sorguların denetimi için idealdir).
- Her zaman izin ver: Oturum için bu aracın kullanımını onaylar.
- Hayır: İşlemi tamamen engeller.
En sorunsuz laboratuvar deneyimi için Evet ve her zaman izin ver'i seçin. Not: İzinler araç bazında verilir. Aracı, list_table_ids veya execute_sql_readonly gibi yeni araçları kullanırken kısa süre içinde birkaç istem daha görebilirsiniz. Bunları da "her zaman izin ver" olarak ayarlayabilirsiniz.

- Aracının çalışmasını izleyin. Sohbet bölmesi, temsilcinin yaptığı her şeyin şeffaflık günlüğü olarak da kullanılır. Ajan, kara kutu yerine muhakemesini ve eylemlerini gerçek zamanlı olarak gösterir.
- Aracı tamamladığında, isteminizin altındaki Worked for Xm (Xm için çalıştı) açılır listesini tıklayarak tam çalışma günlüğünü genişletin. Burada, yanıtınızı nasıl aldığını tam olarak inceleyebilirsiniz:
- İncelendi: Bu öğeleri genişleterek aracının dosyaları okuduğunu, klasörlere göz attığını veya MCP araçlarını (ör.
datacloud_bigquery_remote / list_table_idsveexecute_sql_readonly) çağırdığını görebilirsiniz. Araçlara iletilen tam JSON bağımsız değişkenlerini ve yürütülen SQL'i görüntüleyebilirsiniz. - Çalıştırıldı: Temsilcinin çalıştırdığı terminal komutlarını (ör.
gcloud config list) görmek için bu öğeleri genişletin.
- İncelendi: Bu öğeleri genişleterek aracının dosyaları okuduğunu, klasörlere göz attığını veya MCP araçlarını (ör.

- Sonuçları inceleyin. Temsilci, aylık ortalama sipariş değeri tablosu döndürmelidir. Sayıları kendiniz inceleyin: Önceki aylarda yaklaşık 110 ABD doları olan tutar, Ocak ayında yaklaşık 103 ABD dolarına düşüyor. CFO'nun işaretlediği anormallik budur.
Kanala göre ayrıntılı inceleme
Genel OSB düştü ancak bu düşüş nereden kaynaklanıyor? Haydi öğrenelim.
- Sohbet bölmesinde şunu yazın:
January looks lower than the prior months. Break down January's AOV by order_type to see what's going on? - Aracı, bu kez
order_type'ya göre gruplandırarak başka bir BigQuery sorgusu çalıştırır. Sonuçları dikkatlice inceleyin. Çarpıcı bir sonuç görmelisiniz: Online ve çevrimdışı ortalama sipariş değeri yaklaşık 110 TL'de sabit kalıyor. Ancak çok daha düşük bir ortalama sipariş değerine (yaklaşık 75 ABD doları) sahip yeni bir kanal olan B2B-Toptan Satış var. Bu yeni kanal, birleştirilmiş ortalamayı düşürüyor. - Ajan, B2B müşterilerinin araştırılmasını proaktif olarak önerebilir. Bu durumda sorun yoktur. Bunu bir sonraki adımda yapacaksınız.
Bölüm Özeti: Ocak ayındaki ortalama sipariş değeri düşüşünü tarafsız bir veri çekme işleminden kendiniz tespit ettiniz, ardından harmanlanmış ortalamayı düşüren yeni kanal olarak B2B-Wholesale'ı belirlemek için order_type'a göre ayrıntılı analiz yaptınız. Şimdi bu B2B müşterilerinin kimler olduğunu bulmanız gerekiyor.
6. Hizmet sınırını aşma
BigQuery'de B2B-Wholesale kanalını anormal olarak tanımladınız ancak müşteri verileri Cloud SQL'de bulunuyor. Veri Temsilcisi Kiti ile aynı sohbete devam edebilirsiniz. Bu kit, hizmet sınırını yönetir.
B2B müşterilerini araştırma
- Sohbet bölmesinde şunu yazın:
Who are these B2B customers? Their profiles should be in our Cloud SQL database. Check for: - Who they are - When they signed up - Whether they're new or existing customers - Sohbet bölmesini dikkatlice izleyin. Bu sefer farklı bir MCP aracı görmeniz gerekir. Ajan artık BigQuery yerine Cloud SQL'i sorguluyor. Aracı,
cymbal-pets-opsCloud SQL Postgres örneğine bağlanır vecustomerstablosuna karşı bir sorgu çalıştırır. SQL'i görmek için Ayrıntıları Göster'i tıklayın. - Sonuçları inceleyin. Temsilci, birkaç önemli bulguyu ortaya çıkarmalıdır:
- Tüm B2B müşterileri
customer_type = 'Business' - Bu kullanıcıların tümü son 30 gün içinde (Ocak 2025) kaydoldu.
last_namedeğerleri "Pet Supply Co", "Animal Care LLC" ve "Happy Paws Inc" gibi işletme adlarıdır.- Bu ay öncesinde var olmayan yaklaşık 100 kişilik bir grup var.
- Tüm B2B müşterileri
Promosyon kodunu bağlama
- Aracı, BigQuery'deki birçok B2B siparişinin
promo_codedeğerininBIGORDER25olduğunu kendi başına fark edebilir. Bu gözlemi kendisi yaparsa harika olur. İnceleme doğal olarak ilerliyor.Ajan promosyon kodundan bahsetmezse hatırlatın:I noticed a promo_code field on the orders table in BigQuery. Check what promo codes appear on the B2B-Wholesale orders? - Aracı, BigQuery'ye tekrar sorgu gönderir ve B2B-Toptan satış siparişlerinin yaklaşık% 92'sinde
promo_code = 'BIGORDER25'olduğunu tespit eder. Neredeyse tüm B2B etkinliği tek bir tanıtım kampanyasına bağlıdır.Temsilci, daha sonra ortamdaki başka bir yerde tanıtım verileri arayabilir. (Cloud Storage'da bulunur.)
Bölüm Özeti: Temsilci, Cloud SQL'e sorgu göndererek B2B müşterilerinin tamamının Ocak 2025'te kaydolan yeni işletmeler olduğunu ortaya çıkarıyor. BigQuery'nin siparişlerinin yaklaşık% 92'sinin promo_code = 'BIGORDER25' içerdiğini belirlemesiyle birlikte, iz artık bir promosyon kampanyasına işaret ediyor. Kaynağı bulma zamanı.
7. Eksik parçayı bulma
İki hizmet kapatıldı, bir hizmet daha kapatılacak. Ne olduğunu (B2B siparişleri ortalama sipariş değerini düşürüyor) ve kimin yaptığını (son 30 gündeki yeni işletme müşterileri) biliyorsunuz. Şimdi nedenini bulmanız gerekiyor ve yanıt Cloud Storage'da.
GCS paketini kontrol edin
- Sohbet bölmesinde şunu yazın:
Good catch on the promo code. We might have promotional campaign data in our GCS bucket. Can you check what's there? - Aracıda Cloud Storage için önceden yapılandırılmış bir MCP aracı olmadığından,
gcloud storagekomutlarını çalıştırmak için otomatik olarak terminal aracını kullanır.gcloud storage lsgibi komutları çalıştırmak için izin ister. Bu komutlara izin verin, ardındanpromo_events.jsondosyasını okumak ve ayrıştırmak için kullanılan tam CLI komutlarını görmek üzere Sohbet bölmesindeki Çalıştırıldı günlüğünü genişletin. - Aracı, dosyada üç tanıtım kampanyası tanımlamalıdır:
Bunun nedeni budur.Kampanya
Promosyon kodu
İndirim
Hedef
Tarihler
Yaz Evcil Hayvan Bakımı İndirimi
PETSUMMER15%15 indirim
Tümü
Haziran 2024
B2B Toptan Satış İtme
BIGORDER25% 25 indirim
B2B
Ocak 2025
Bağlılık programı üyelerine özel yıl sonu bonusu
LOYAL10%10 indirim
Bağlılık programı üyeleri
Aralık 2024
BIGORDER25promosyon kodu, B2B Toptan Satış Promosyonu adlı bir kampanyayla eşleniyor: Minimum sipariş miktarı 50 birim olan B2B müşterileri için% 25 indirim.
Her şeyi bir araya getirin
- Ajanın bulduğu her şeyi sentezlemesini isteyin:
Put it all together. What happened to our average order value? - Ajan, üç veri kaynağını birbirine bağlayan net ve yapılandırılmış bir sentez sunar. Şuna benzer bir açıklama yapmalıdır:
- Ortalama sipariş değerindeki düşüş gerçektir ancak mevcut işlerde bir düşüş söz konusu değildir. Online ve çevrimdışı OSB, yaklaşık 110 ABD doları seviyesinde sabit kalmaya devam ediyor.
- Ocak 2025'te yeni bir B2B-Toptan Satış kanalı kullanıma sunuldu. Bu kanalda, çok daha düşük bir ortalama sipariş değeriyle (~75-100 ABD doları) yaklaşık 25.000 sipariş verildi.
- B2B müşterileri, son 30 gün içinde kaydolan 100 yeni işletme hesabıdır (Cloud SQL).
- Etkinlik, 50 birim minimum koşuluyla toplu siparişlerde% 25 indirim sunan bir promosyon kampanyası ("B2B Toptan Satış Promosyonu") tarafından yönlendiriliyor (Cloud Storage).
- B2B siparişlerinin yüksek hacmi, düşük fiyatları telafi ettiğinden gelir sabit kalıyor. Ancak, birim marjları %25 toptan satış indirimi altında büyük ölçüde sıkıştırılır (~% 65 oranında azalır). Kargo ve operasyonel genel giderler hesaba katıldığında genel karlılık ciddi şekilde tehlikeye girer.
Bölüm Özeti: Cloud Storage'da nedeni buldunuz: Toplu siparişlerde% 25 indirim sunan bir B2B promosyon kampanyası. Ajan, üç hizmetteki bulguları sentezleyerek net bir anlatı oluşturdu. İnceleme aşaması tamamlandı. Ardından, bu bulguları işleme koyacaksınız.
8. Ardışık düzeni oluşturma
Sorunu çözdünüz. Şimdi de CFO, bu analizin otomatik olarak güncellenmesini istiyor. Bu bölümde, aracıdan BigQuery verilerini hazırlayan ve devam eden AOV analizi için bir olgu tablosu oluşturan bir dbt projesi oluşturmasını isteyeceksiniz.
Bu aşamada, temsilci araştırmacıdan mühendise dönüşür. Tüm dbt projesini iskeletini oluşturup tüm ardışık düzeni tek bir istemden çalıştırdığını göreceksiniz.
dbt projesini iskeleleme
- Sohbet bölmesinde aşağıdaki istemi yazın. Bu kılavuz, adım adım ilerlemek yerine hedefe yönelik olarak hazırlanmıştır. Ajana nasıl oluşturacağını değil, ne istediğinizi söylüyorsunuz:
I want to productionize our AOV analysis so it updates automatically. Build a dbt project that: 1. Creates staging models for the BigQuery tables (orders and order_items) and a mart called fct_order_analysis that calculates AOV by channel and month 2. Add a uniqueness test on order_id and run dbt build - Kendi Kendini Düzeltmeyi Gözlemleyin: Eğer "Ns için Çalıştı" günlüğünü genişletirseniz, aracının
dbtöğesini kontrol ettiğini ve eksik olduğunu tespit ettiğinde otomatik olarak bir Python sanal ortamı oluşturmak için komutlar çalıştırdığını görebilirsiniz (.venv). Ortam kurulumunu sizin için hallediyor!

- Uygulama planını inceleyin: Ajan, resmi bir uygulama planı oluşturur. Önerilen dosyaları ve mimariyi inceleyebilir, gerekirse yorum ekleyebilir ve Devam'ı tıklayarak aracının planı yürütmesine izin verebilirsiniz.

- Aracı, planını uygularken Chat bölmesini izleyin. Aracı, gerekli
.sqldosyalarını ve YAML yapılandırmalarını yazar. İşlem tamamlandığında ve proje başarıyla derlendiğinde değişikliklerin bir özetini gösterir. Bu dosyaları çalışma alanınıza eklemek için Tümünü kabul et seçeneğine tıklayın.

- Yeni oluşturulan dbt projesini soldaki Gezgin'de keşfedin. Aşağıdakine benzer bir yapı görürsünüz:
dbt/ ├── models/ │ ├── marts/ │ │ └── fct_order_analysis.sql │ └── staging/ │ ├── schema.yml │ ├── sources.yml │ ├── stg_order_items.sql │ └── stg_orders.sql ├── dbt_project.yml └── profiles.yml

- Temsilcinin oluşturduğu SQL'i incelemek için
.sqlmodel dosyalarını tıklayın. Şu konulara dikkat edin:- Hazırlama modelleri: Kaynak referansları içeren temizlenmiş ve yeniden adlandırılmış sütunlar
- Mart modeli: Birleştirme mantığı ve kanala göre ortalama sipariş değeri hesaplaması
- Misafir ödemelerini işleme:
COALESCE(customer_type, 'Guest')veya gevşetilmiş boş kısıtlama görebilirsiniz. Bu model, hesap oluşturmadan yapılan perakende müşteri alışverişlerini kaydeder ve eksik kayıtları silmek yerine geçerli sipariş gelirlerini korur.
- Tüm modellerin oluşturulduğuna ve tüm testlerin başarıyla tamamlandığına dair aracının onayını almak için Sohbet bölmesini kontrol edin (veya oluşturulan Walkthrough yapay öğesini tıklayın). Pazardaki ortalama sipariş değeri sonuçları, inceleme sırasında bulduklarınızı doğrulamalıdır:
- Online: ~$110 - Offline: ~$110 - B2B-Wholesale: ~$75 to $77
Bölüm Özeti: Ajan, amaca yönelik tek bir istemden dbt projesi oluşturdu: hazırlama ve mart modellerini iskeleledi, başarılı bir dbt build çalıştırdı ve AOV anomalisini doğruladı. Ardından, temsilcinin karmaşıklığı nasıl ele aldığını görmek için beklenmedik bir soru soracaksınız.
9. Testler başarısız olduğunda aracı hata ayıklama yapar.
Ardışık düzen çalışıyor ancak yalnızca BigQuery verilerini kullanıyor. Ürün ekibi, beslenme ihtiyaçlarına göre ürün önerebilmek için Cloud SQL'deki müşteri ve evcil hayvan profili verileriyle analizi zenginleştirmek istiyor. Bu nedenle, aracının Cloud SQL sınırını aşması ve klasik bir boyut modelleme "fan-out" birleştirme olan ince bir veri modelleme hatasını işlemesi gerekir.
Kullandığınız modele ve akıl yürütme özelliklerine bağlı olarak, ajan bu isteği iki şekilde ele alır: Hatayı proaktif olarak önleme (A seçeneği) veya Test hatası başarısızlığından sonra kendini düzeltme (B seçeneği). Ajanınızın hangi yolu izlediğini görelim.
İsteği tetikleme
- Sohbet bölmesinde şunu yazın:
Enrich fct_order_analysis with customer data and pet profile data from our Cloud SQL database. Include customer type and each customer's pets and dietary needs so we can recommend products. Keep the uniqueness test on order_id and run dbt build. - Aracının çalışmasını izleyin. Cloud SQL tablolarını keşfeder, verileri BigQuery'ye nasıl aktaracağını (birleştirilmiş sorgu veya somutlaştırılmış kopya aracılığıyla) belirler, yeni hazırlama modelleri oluşturur ve
fct_order_analysis.sqlöğesini değiştirir.
A seçeneği: Proaktif temsilci (hatalardan kaçınma)
Gelişmiş bir muhakeme modeli kullanıyorsanız aracı, herhangi bir kod yazmadan önce ayrıntı kaymasını algılayabilir. Bir müşterinin birden fazla evcil hayvanı olabileceğinden doğrudan birleştirme, siparişleri kopyalar ve order_id üzerinde istediğiniz benzersizlik testini geçemez.
- Proaktif Toplama İşlemini Gözlemleyin: Temsilci, sohbet bölmesi açıklamasında veya adım adım kılavuzda, "klasik dağıtım"ı önlemek için birleştirmeden önce evcil hayvan verilerini önceden topladığını belirtebilir. Bu işlem genellikle bir toplama işlevi (ör.
ARRAY_AGG()veyaSTRING_AGG()) kullanılarak müşteri başına birden fazla evcil hayvanın daraltılmasıyla yapılır. - Sonuçları Kontrol Edin: Ajan, olgular tablosunun ayrıntı düzeyini proaktif bir şekilde koruduğu için
dbt buildilk denemede başarıyla çalışır ve geçer. Bu durumu, genellikle sorgu sonuçlarının yanında başarılı test çıktısını gösteren, oluşturulan Walkthrough yapay nesnesini kontrol ederek doğrulayabilirsiniz.

Ajan, hatadan kaçındı. fct_order_analysis.sql içindeki oluşturulan SQL'i inceleyerek toplama işleminin nasıl yapılandırıldığını görün, ardından bir sonraki bölüme geçin, Yanıtı iletin.
Seçenek B: Kendi kendini onaran ajan (hata ayıklama ve teşhis)
Model önce basit bir doğrudan sol birleştirme yazarsa SQL sorgusu başarılı bir şekilde çalışır ancak otomatik dbt test paketi, ayrıntı düzeyindeki değişikliği yakalar.
- Test hatasını gözlemleyin: Hatanın, Chat bölmesi yürütme ilerleme durumu günlüklerinde bildirildiğini görürsünüz:
Completed with 1 error Failure in test unique_fct_order_analysis_order_id Got 287 results, configured to fail if != 0
order_idüzerindeki benzersizlik testinde, birden fazla evcil hayvanı olan müşteriler siparişleri farklı zamanlarda verdiğinden yinelenen girişler bulundu. - Ajanın teşhis koymasına ve kendi kendini onarmasına izin verin: Test başarısız olduğundan ajandan hata ayıklamasını isteyin. Sohbet bölmesinde şunu yazın:
The uniqueness test failed. Can you figure out why and fix it? - Teşhisi izleyin: Aracı, verileri sorgular,
pet_profilesiçinde bire çok ilişkisini keşfeder, doğrudan birleştirmenin ayrıntı düzeyini one-row-per-order'dan one-row-per-order-per-pet'e değiştirdiğini açıklar ve modeli, evcil hayvan profillerini önceden toplamak için yeniden yazar:-- Pre-aggregating pets per customer to resolve fan-out LEFT JOIN ( SELECT customer_id, COUNT(*) AS num_pets, STRING_AGG(DISTINCT pet_type, ', ') AS pet_types, STRING_AGG(DISTINCT dietary_needs, ', ') AS dietary_needs FROM pet_profiles GROUP BY customer_id ) pet_agg ON c.customer_id = pet_agg.customer_id - Düzeltmeyi doğrulama: Aracı
dbt buildtekrar çalıştırılır ve bu kez tüm modeller gerçekleşir ve tüm testler başarıyla geçer.
Bölüm Özeti: Aracınızın hatayı proaktif olarak önlediğini veya test hatası başarısızlığından sonra kendini başarıyla onardığını gördünüz. Ayrıca Cloud SQL sınırını aştığını, müşteri ve evcil hayvan profili verilerini entegre ettiğini ve olgu tablosunda sipariş başına bir satır tuttuğunu da gördünüz. Ardışık düzen tamamlandı ve test edildi.
10. Yanıtı ilet
Bugün Perşembe. Haftaya endişeli bir CFO ve üç bulut hizmetine dağılmış verilerle başladınız. Artık temel neden ve bir üretim ardışık düzeniniz var. Yanıtı, nicel bir tahmine dayalı, geleceğe yönelik bir öneriyle birlikte sunma zamanı.
Yönetici özetini yazma
- Sohbet bölmesinde şunu yazın:
Write an executive summary covering: - Main findings and the quantitative margin impact - Project AOV for the subsequent quarter if the B2B program continues at its current trajectory - A data-driven recommendation - Aracının çalışmasını izleyin.
- Ajanın yönetici özetini inceleyin. Tipik ve iyi yapılandırılmış bir yanıt şunları ele almalıdır:
- Temel bulgu: Ocak ayı ortalama sipariş değeri yalnızca yeni B2B-Toptan Satış kanalı nedeniyle düştü. Online ve çevrimdışı gelir yaklaşık 110 ABD doları seviyesinde sabit kalmaya devam ediyor.
- Temel Neden: "B2B Toptan Satış Push" (toplu siparişlerde% 25 indirim) 100 yeni hesap kazandı ve yaklaşık 25.000 sipariş alınmasını sağladı.
- Marj etkisi: Toptan satış siparişleri, ortalama birim kârını yaklaşık %65 oranında düşürdü (yaklaşık 7,50 ABD dolarından yaklaşık 2,60 ABD dolarına).
- Gelir: Yüksek B2B hacmi, düşük fiyatları telafi ettiğinden genel gelir sabit kalır.
AI.FORECAST ile ortalama sipariş değerini tahmin etme
- Ajan, geleceğe yönelik bir tahmin de oluşturmalıdır. Ajanın BigQuery'ye karşı bir
AI.FORECASTsorgusu çalıştırdığı bir MCP Tool çağrısı bulun. Bu işlemde, geçmiş trendlere göre 90 gün boyunca ortalama sipariş değerini tahmin etmek için yerleşik TimesFM temel modeli kullanılır. Sorgu, iki senaryoda 90 gün boyunca ortalama sipariş değerini tahmin etmelidir: kampanyanın devam etmesi (yapısal olarak düşük ortalama sipariş değeri) ve kampanyanın sonlandırılması (yaklaşık 110 ABD dolarına yükselme).
- Ajanın stratejik önerilerini inceleyin. Öneriler şunları kapsamalıdır:
- İndirimleri yeniden yapılandırın: Birim düzeyindeki kârları korumak için kâr tabanları uygulayın veya toplu indirimleri sınırlayın.
- Daha katı minimum sipariş miktarları uygulayın: Perakende alıcıların toptan satış fiyatlandırmasını kötüye kullanmasını önleyin.
- Ayrı raporlama: Perakende performansının gizlenmesini önlemek için perakende ve B2B bölümlerini ayrı ayrı izleyin.
Hikayenin tamamı
Pazartesi günü ortalama sipariş değerindeki% 7'lik düşüş nedeniyle başlayan tatbikatın CFO için net bir çözümü var:
- Perakende Sağlığı: Temel perakende kanalları, temel düzeyde sağlıklı ve dengeli kalmaya devam ediyor.
- Toptan Satışlardaki Artış: AOV'deki düşüş tamamen yeni B2B toptan satış kanalı ve
BIGORDER25kampanyasından kaynaklanmaktadır. - Marj Etkisi: %25'lik toplu indirim, birim marjlarını ciddi şekilde düşürdü ve gelir sabit kalmasına rağmen kârlılığı tehdit etti.
- Stratejik Tahmin: Bir
AI.FORECASTtahmini, toptan satış katmanlarının yeniden yapılandırılmasının karma ortalama sipariş değerini geri getireceğini gösteriyor.
Toptan satış marjı tabanları oluşturmak ve perakende/B2B raporlamasını ayırmak için verilere dayalı bir öneri sunarsınız.
Bölüm Özeti: Temsilciden marj analizi içeren bir yönetici özeti yazmasını, AI.FORECAST tahmini oluşturmasını ve veriye dayalı bir öneri sunmasını istediniz. İnceleme tamamlandı.
11. Temizleme
Google Cloud hesabınızın sürekli olarak ücretlendirilmesini önlemek için bu codelab'de oluşturulan kaynakları yıkım komut dosyasını çalıştırarak silin.
- Google Cloud Shell'e (kurulum komut dosyasını çalıştırdığınız yer) dönün ve kaldırma komut dosyasını çalıştırın:
cd ~/devrel-demos/codelabs/agentic-data-labs/scripts
chmod +x teardown.sh
./teardown.sh
- Komut dosyası, silmeyi planladığı tüm kaynakları gösterir ve devam etmeden önce onay ister:
- Bulut SQL örneği (
cymbal-pets-ops): Tüm tablolar - BigQuery veri kümeleri (
cymbal_pets,dbt_marts): Tüm tablolar ve modeller - Cloud Storage paketi (
gs://YOUR_PROJECT_ID-cymbal-pets-raw) - BigQuery bağlantısı (
cymbal-pets-cloudsql)
- Bulut SQL örneği (
- Onaylamak için
yyazın. Sökme işlemi yaklaşık 2-3 dakika sürer.
[INFO] Deleting BigQuery dataset cymbal_pets... [ OK ] BigQuery dataset cymbal_pets deleted. [INFO] Deleting BigQuery dataset dbt_marts... [ OK ] BigQuery dataset dbt_marts deleted. [INFO] Deleting GCS bucket gs://YOUR_PROJECT_ID-cymbal-pets-raw... [ OK ] GCS bucket deleted. [INFO] Deleting BigQuery connection cymbal-pets-cloudsql... [ OK ] BQ connection deleted. [INFO] Deleting Cloud SQL instance cymbal-pets-ops... [ OK ] Cloud SQL instance deleted.
12. Tebrikler!
The Cymbal Pets Investigation adlı kursu başarıyla tamamladınız. Tüm Google Cloud veri varlıklarınızda çalışan bir yapay zeka aracısı kullanarak belirsiz bir CFO sorusundan tamamen operasyonel hale getirilmiş, tahmin destekli bir öneriye geçtiniz.
Başarılarınız
- 🔍 Hizmetler genelinde keşfedildi: Data Agent Kit'in Knowledge Catalog'unu kullanarak BigQuery, Cloud SQL ve Cloud Storage'daki öğeler keşfedildi ve önizlendi.
- 🕵️♂️ Yapay zekayla araştırıldı: MCP Araçları kullanılarak tek bir sohbet bölmesi görüşmesinde birden fazla hizmet sorgulanarak AOV anormalliğinin toplu bir B2B tanıtım kampanyasına kadar izi sürüldü.
- 🔧 Üretim ardışık düzeni oluşturma: Sipariş ve müşteri verilerini temizlemek, birleştirmek ve test etmek için eksiksiz bir dbt projesi oluşturdu.
- 🐛 Bir dağıtım hatası ayıklandı: Aracı, ayrıntı düzeyi sorununu otomatik olarak teşhis etti ve müşteri evcil hayvan profillerini önceden toplamak için dbt SQL modelini yeniden düzenledi.
- 📈 Tahmin edildi ve önerildi: BigQuery'nin yerleşik
AI.FORECASTişlevini kullanarak ortalama sipariş değeri trendlerini modelledi ve CFO'ya veriye dayalı bir öneri sundu.
Temel kavramlar
Kavram | Öğrendikleriniz |
Yapay zeka aracısının, BigQuery, Cloud SQL, Spanner gibi hizmetleri ve diğer veritabanlarını sizin adınıza sorgulamasına olanak tanıyan güvenli ve denetlenebilir bağlantılar. Her çağrı, Sohbet bölmesinde görünür. | |
Temsilci becerileri | Ajanın, alanla ilgili en iyi uygulamaları öğrenmesini sağlayan ve istem girmenizi gerektirmeyen önceden oluşturulmuş talimat kümeleri (ör. |
Hizmetler arası inceleme | Aracı, tek bir görüşmede birden fazla Google Cloud hizmetini sorgular. Bağlantı kurulumu ve konsollar arasında bağlam değiştirme gerekmez. |
Hedef odaklı istem yazma | Aracıya nasıl istediğinizi söylemek yerine ne istediğinizi söyleyin ("kanala göre ortalama sipariş değerini hesaplayan bir dbt projesi oluştur") ve uygulama yaklaşımını seçmesine izin verin. |
MCP Araçları ve Agent Skills'ten veri keşfine kadar her şeyi bir araya getiren bu uzantı, tercih ettiğiniz IDE'den tüm Google Cloud veri varlıklarınıza erişmenizi sağlar. |
Sonraki adımlar
- Veri Aracısı Kitinin yetenekleri hakkında daha fazla bilgi edinmek için Veri Aracısı Kiti dokümanlarını okuyun.
AI.FORECAST,AI.GENERATEveAI.EMBEDdahil olmak üzere BigQuery ML ve yapay zeka işlevleri hakkında bilgi edinin.- Antigravity IDE ile kendi verilerinizde hizmetler arası soruşturma oluşturmayı deneyin.