Bölüm 8: Google Workspace + Gemini entegrasyon senaryoları

Senaryo 78: Apps Script ve Gemini ile özel rapor otomasyonu

Seviye: İleri · Araçlar: Google Apps Script, Vertex AI service, Agent Platform API, Gemini modeli, Google Cloud

Kim ve hangi durumda

Okan, bir lojistik şirketinde operasyon analistidir. Şirketin kullandığı Sheets ve Docs akışına uyan, standart Workspace düğmelerinin karşılamadığı haftalık gecikme açıklaması üretmek ister.

Bugün nasıl yapılıyor

Okan tabloyu indirir, veriyi ayrı bir yapay zekâ aracına kopyalar ve çıkan metni rapor dosyasına yapıştırır.

Yapay zekâ ile nasıl yapılır

  1. Bir Google Cloud projesi oluşturun veya seçin ve projenin faturalandırmasını etkinleştirin. Apps Script Vertex AI service için bu ön koşuldur. [140]
  2. Cloud Console’da Agent Platform API’yi etkinleştirin. Belge, bu API’nin önceki Vertex AI API adlandırmasıyla da anıldığını açıklar. [140]
  3. Apps Script projesinde Vertex AI service’i açın. Google’ın örneğindeki callVertexAI işlevini temel alıp prompt, bölge, proje kimliği ve model adını kurum standardına göre değiştirin. [140]
  4. Çıktıyı yalnızca seçilmiş veri aralığıyla üretin. Örneğin her gecikme satırını neden, kanıt ve takip önerisi başlıklarıyla özetletin.
  5. İlk çalıştırmada log çıktısını ve model yanıtını gözden geçirin.

Örnek komut

{sheet_aralığı} içindeki gecikme kayıtlarını incele. Her kayıt için yalnızca mevcut veriye dayalı olarak neden, kanıtlanan bilgi ve insanın doğrulaması gereken nokta başlıklarını üret. Boş alanları tahmin etme.

Kanıt ve gerçek örnek

Google Developers belgesi Apps Script içindeki Vertex AI service ile Gemini’ye generateContent çağrısı yapılabildiğini ve örnek kodu yayımlar; bu senaryonun temeli bu teknik belgedir. [140]

Dikkat edilecekler

Faturalandırması kapalı Cloud projesi, etkinleştirilmemiş API veya Apps Script’te açılmamış servis akışı çalıştırmaz. [140] Vertex AI API çağrısını Workspace içindeki Gemini taahhütleriyle aynı varsaymayın; veri sınıfları ve erişim izinleri için kurum onayı alın. Workspace içi Gemini’nin veri koşullarını ayrıca okuyun. [40] API anahtarlarını veya servis hesabı sırlarını kod içine yazmayın.

Bu senaryonun kaynakları

  1. Google Workspace Gemini veri koruması (support.google.com)
  2. Vertex AI Service in Apps Script (developers.google.com)