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 işlem verileri, Cloud SQL'deki müşteri ve ürün kayıtları ve Cloud Storage'daki pazarlama dosyaları. Normalde, bu tür hizmetler arası bir soruşturma yürütmek için konsollar arasında geçiş yapmak, bağlantı için standart metinler yazmak ve sonuçları manuel olarak birleştirmek 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. Bu durumu çözdüğünüzde, temsilciden bulgularınızı operasyonel hale getiren bir dbt ardışık düzen 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ı
- Faturalandırmanın etkin olduğu bir Google Cloud projesi
- 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.
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.
Cloud Shell'i Başlatma
Kurulum komut dosyasını çalıştırmak için Google Cloud Shell'i kullanacaksınız.
- Google Cloud Console'un üst kısmında Activate Cloud Shell'i (Cloud Shell'i Etkinleştir) 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ı, laboratuvar ortamınızın tamamını birkaç dakika içinde hazırlar. API'leri etkinleştirme, BigQuery verilerini yükleme ve artırma, promosyon öğelerini GCS'ye yükleme işlemlerini gerçekleştirir. Ardından, codelab'i başlatırken arka planda Cloud SQL Postgres'i sağlama ve yapılandırma için otomatik olarak bir arka plan çalışanı oluşturur.
Komut dosyası, güvenli bir şekilde otomatik olarak Cloud SQL şifresi oluşturur ve bu şifreyi sizin için otomatik olarak .env dosyanıza kaydeder.
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: İşlemsel veriler (siparişler ve sipariş öğeleri) BigQuery'de, operasyonel veriler (müşteriler, evcil hayvan profilleri ve ürünler) ise Cloud SQL'de bulunur. Bu ayrım, verilerin gerçek kuruluşlardaki hizmetlere genellikle nasıl dağıtıldığını yansıtır ve hizmetler arası incelemeyi ilginç kılan da budur.
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'yi ve Veri Ajanı Kitini Kurma
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-labsolarak adlandırın) ve Open Folder'ı (Klasör Aç) seçerek 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ı, doğrudan düzenleyicinizde Google Cloud veri hizmetleriyle derin entegrasyon sağlayarak bağlam değiştirmeden BigQuery, Cloud SQL, Cloud Storage ve daha fazlasıyla etkileşim kurmanıza olanak tanır.
- 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. googlecloudtoolstarafından yayınlanan Google Cloud Data Agent Kit adlı uzantıyı 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ı 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: Ajanlara 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, Data Agent Kit uzak MCP sunucularını yapılandırdınız ve BigQuery'ye karşı bir sorgu çalıştırarak bağlantıyı doğruladınız.
4. Verilerinizi Keşfedin
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 CATALOG 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 fark edeceksiniz. 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 Lines içeriğini doğrudan IDE'de görüntüleyebilirsiniz.

Durumu Değerlendirme
Veri ortamı 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, yapay zeka aracısının tüm bunları tek bir görüşme üzerinden yapmasına izin vereceksiniz.
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. İstatistikleri takip etme
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 olmak önemlidir. Veri Aracısı Kiti, verilere erişmeden önce açık izin isteyerek kontrolü size bırakır. İstendiğinde şunları seçebilirsiniz:
- Bu defalık izin ver: Tek bir kullanım için onay verir (yüksek riskli sorguları denetlemek için idealdir).
- Her zaman izin ver: Oturum için bu aracın sürekli kullanımını onaylar.
- Hayır: İşlemi tamamen engeller.
list_table_idsveyaexecute_sql_readonlygibi yeni araçları kullandıkça 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 işlemlerini gerçek zamanlı olarak gösterir.
- Aracı tamamlandığında, isteminizin altındaki 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: 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örmek için bu öğeleri genişletin. 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: 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. Bu, CFO'nun işaretlediği anormalliktir.
Kanala Göre Ayrıntılı İnceleme
Genel OSB düştü ancak bu düşüşün kaynağı ne? 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_typegöre gruplandırarak başka bir BigQuery sorgusu çalıştırır. Sonuçları dikkatlice inceleyin.Şaşırtıcı bir şey göreceksiniz: 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 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 kez farklı bir MCP aracı görmeniz gerekir. Aracı artık BigQuery yerine Cloud SQL'e sorgu gönderiyor.Aracı,
cymbal-pets-opsCloud SQL Postgres örneğine bağlanıyor vecustomerstablosuna karşı bir sorgu çalıştırıyor. 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
- 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. Araştırma doğal olarak ilerliyor.Temsilci 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 promosyon kampanyasına bağlıdır.Temsilci, bu promosyon kodunun nereden geldiğini merak etmelidir. Ortamda başka bir yerde promosyon verisi olup olmadığını sorabilir. (Cloud Storage'da vardır.)
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 çıkardı. 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 etme
- 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:
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ış adlı bir kampanyayla eşleniyor: B2B müşterileri için minimum sipariş miktarı 50 birim olan ürünlerde% 25 indirim. Bu, suçüstü yakalanma anıdır.
Her Şeyi Bir Araya Getirme
- Ajandan 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 sunuyor. Şuna benzer bir açıklama yapılmalı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 TL'de sabit kalmaya devam ediyor.
- Ocak 2025'te yeni bir B2B-Toptan Satış kanalı kullanıma sunuldu. Bu kanalda, ortalama sipariş değeri çok daha düşük (~75-100 ABD doları) olan yaklaşık 25.000 sipariş yer alıyordu.
- 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ış indirimiyle büyük ölçüde düşer (yaklaşık% 65 oranında azalır). Kargo ve operasyonel genel giderler de hesaba katıldığında bu durum, genel karlılığı ciddi şekilde tehdit eder.
Bölüm Özeti: Cloud Storage'da, toplu siparişlerde% 25 indirim sunan bir B2B promosyon kampanyası buldunuz. 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 noktada, temsilci araştırmacıdan mühendise dönüşür. Bu araç, tek bir istemle tüm dbt projesini oluşturup tüm ardışık düzeni çalıştırır.
dbt projesini oluşturma
- Sohbet bölmesinde aşağıdaki istemi yazın. Bu kılavuz, adım adım ilerlemek yerine doğrudan hedefe ulaşmaya odaklanır. Temsilciye ne istediğinizi söylüyorsunuz, nasıl oluşturacağını değil:
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 - Otomatik düzeltmeyi gözlemleyin: "Ns için çalıştı" günlüğünü genişletirseniz aracının
dbtöğesini kontrol ettiğini ve eksik olduğunu tespit ettikten sonra Python sanal ortamı (.venv) oluşturmak için komutları otomatik olarak çalıştırdığını görebilirsiniz. Ortam kurulumunu sizin için gerçekleştirir.

- 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'i tıklayın.

- Yeni oluşturulan dbt projesini soldaki Gezgin'de keşfedin. Şuna 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

- Aracı tarafından oluşturulan 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ı
- Tüm modellerin gerçekleştiği ve tüm testlerin geçtiğiyle ilgili aracının onayını almak için Sohbet bölmesini kontrol edin. 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, tek bir amaca yönelik istemden bir dbt projesi oluşturdu: hazırlama ve mart modellerini yapılandırdı, 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 İşlemi 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, aracı bu isteği iki şekilde ele alır: Hatayı proaktif olarak önleme (A seçeneği) veya Test hatasından sonra kendi 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 (Hata Önleme)
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ği için doğrudan birleştirmenin siparişleri kopyalayacağını ve order_id üzerinde istediğiniz benzersizlik testinin hemen başarısız olacağını fark eder.
- Proaktif Toplama İşlemini Gözlemleyin: Temsilci, sohbet bölmesi açıklamasında veya adım adım açıklama yapısında, "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.

Temsilciniz bunu yaptıysa tebrikler. Proaktif yapay zeka mühendisliğine tanık oldunuz. Toplama işleminin nasıl yapılandırıldığını görmek için fct_order_analysis.sql bölümünde oluşturulan SQL'i inceleyin, ardından bir sonraki bölüm olan Yanıtı Sunma'ya geçin.
B seçeneği: Kendi Kendini Onaran Aracı (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ı değişikliğini yakalar.
- Testin Başarısız Olmasını İzleme: Başarısızlık, sohbet bölmesi yürütme ilerleme günlüklerinde bildirilir:
Completed with 1 error Failure in test unique_fct_order_analysis_order_id Got 287 results, configured to fail if != 0
order_idüzerinde yapılan benzersizlik testinde, birden fazla evcil hayvanı olan müşteriler siparişleri farklı zamanlarda verdiğinden yinelenen girişler bulundu. - Ajana Teşhis ve Kendi Kendini Onarma İzni Verme: 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 İzleyin: Ajan, 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, 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 bir şekilde önlediğini veya test 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 mükemmel olgu tablosu ayrıntı düzeyini koruduğunu da gördünüz. İşlem hattı artık sağlam, eksiksiz ve tamamen test edildi.
10. Yanıtı sunma
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ındaki ortalama sipariş değeri yalnızca yeni B2B-Toptan Satış kanalı nedeniyle düştü. Online ve çevrimdışı satışlar yaklaşık 110 ABD doları seviyesinde sabit kalıyor.
- 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, TimesFM temel modeli kullanılarak geçmiş trendlere göre 90 gün boyunca ortalama sipariş değeri tahmin edilir. 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ı tutarında toparlanma).
- Ajanın stratejik önerilerini inceleyin. Güçlü bir öneri grubu şunları içerebilir:
- İ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.
The Full Story
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 veriye 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.
- Antigravity IDE'nin alt kısmındaki Terminal panelinde (veya Cloud Shell'de) codelab dizinine gidin ve şu komutu ç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:
- Cloud SQL örneği (
cymbal-pets-ops): En pahalı kaynaktır. - BigQuery veri kümesi (
cymbal_pets): Tüm tablolar ve modeller - Cloud Storage paketi (
gs://YOUR_PROJECT_ID-cymbal-pets-raw) - BigQuery bağlantısı (
cymbal-pets-cloudsql)
- Cloud SQL örneği (
- Onaylamak için
yyazın. Sökme işlemi yaklaşık 2-3 dakika sürer.
[INFO] Deleting Cloud SQL instance cymbal-pets-ops... [ OK ] Cloud SQL instance deleted. [INFO] Deleting BigQuery dataset cymbal_pets... [ OK ] BigQuery dataset deleted. [INFO] Deleting GCS bucket gs://YOUR_PROJECT_ID-cymbal-pets-raw... [ OK ] GCS bucket 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: Veri Aracısı Kiti'nin 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: İşlem ve müşteri verilerini temizlemek, birleştirmek ve test etmek için eksiksiz bir dbt projesi oluşturuldu.
- 🐛 Bir dağıtım hatası ayıklandı: Ajanın, ayrıntı düzeyi sorununu otomatik olarak teşhis ettiği ve müşteri evcil hayvan profillerini önceden toplamak için dbt SQL modelini yeniden düzenlediği gözlemlendi.
- 📈 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 |
MCP Araçları | 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. |
Aracı 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 veya 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. |
Veri Ajanı Kiti | MCP Tools, Agent Skills ve veri keşfi gibi her şeyi bir araya getiren uzantı. Bu uzantı sayesinde, tercih ettiğiniz IDE'den Google Cloud'daki tüm veri varlıklarınıza erişebilirsiniz. |
Sonraki adımlar
- Özellikleri hakkında daha fazla bilgi edinmek için Veri Aracısı Kiti belgelerini okuyun.
AI.FORECAST,AI.GENERATEveAI.EMBEDdahil olmak üzere BigQuery ML ve yapay zeka işlevleri hakkında bilgi edinin.- Antigravity IDE'yi kullanarak kendi verilerinizle hizmetler arası kendi soruşturmanızı oluşturmayı deneyin.