Projeleri Google Chat, Vertex AI ve Firestore ile yönetin

Bu eğitimde, bir ekibin projeleri gerçek zamanlı olarak yönetmek için kullanabileceği bir Google Chat uygulamasının nasıl oluşturulacağı gösterilmektedir. Chat uygulaması, ekiplerin kullanıcı hikayeleri (bir yazılım sisteminin, geliştirilmesi için ekibin kullanıcı bakış açısından özelliklerini temsil eden) yazmasına yardımcı olmak için Vertex AI'ı kullanır ve hikayeleri Firestore veritabanında saklar.

• 

  Şekil 1. Charlie, ekibiyle birlikte bir Chat alanında özellik geliştirme konusunu tartışıyor. Proje yönetimi Chat uygulamasından bahsettiğinizde Chat uygulaması yardım sunar.

• 

  Şekil 2. /createUserStoryEğik çizgi komutunu kullanarak bir hikaye oluşturur.

• 

  Şekil 3. Proje yönetimi Chat uygulaması, hikaye açıklamasını yazmak için Vertex AI'ı kullanır ve ardından hikayeyi alanda paylaşır.

• 

  Şekil 4. Charlie, hikaye ayrıntılarını tamamlamak için Düzenle'yi tıklar. Yapay zeka açıklaması doğru olsa da Charlie daha fazla ayrıntı istiyor. Bu nedenle, Vertex AI'ın hikaye açıklamasına şartlar eklemesi için Genişlet'i tıklıyor. Charlie, hikayeyi kendisine atar, durumu "başlatıldı" olarak ayarlar, uygun bir öncelik ve boyut seçer, ardından Kaydet'i tıklar.

• 

  Şekil 5. Charlie, /manageUserStories eğik çizgi komutunu kullanarak ekibin tüm kullanıcı hikayelerini istediği zaman görebilir ve yönetebilir.

Ön koşullar

• Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.

• Aşağıdakileri yapmak için Google Cloud hizmetlerine erişim:

  • Google Cloud projesi oluşturun.
  • Cloud Faturalandırma Hesabı'nı Cloud projesine bağlayın. Erişiminiz olup olmadığını öğrenmek için Faturalandırmayı etkinleştirmek için gereken izinler başlıklı makaleyi inceleyin.

  • Kimliği doğrulanmamış Google Cloud Function çağrıları kullanın. Google Cloud kuruluşunuzun alanla kısıtlı paylaşım kullanıp kullanmadığını belirleyerek bunu doğrulayabilirsiniz.

  Gerekirse Google Cloud yöneticinizden erişim veya izin isteyin.

• Google Cloud CLI kullanılıyorsa gcloud CLI ile çalışacak şekilde yapılandırılmış bir Node.js geliştirme ortamı. Node.js geliştirme ortamı ayarlama başlıklı makaleye bakın.

Hedefler

• Çevik yazılım projelerini yöneten bir Chat uygulaması oluşturun.
• Kullanıcıların, Vertex AI tarafından desteklenen üretken yapay zeka destekli hikaye yazma araçlarıyla kullanıcı hikayeleri yazmasına yardımcı olun:
  • Hikaye açıklamaları oluşturma ve yeniden oluşturma
  • Notlardan hikaye açıklamalarını genişleterek koşulları tamamlama
  • Yazım hatalarını düzeltmek için dil bilgisini düzeltin.
• Firestore veritabanına yazıp okuyarak çalışmalarınızı güncel tutun.
• Kullanıcıların doğrudan görüşmeden hikaye oluşturmasına, düzenlemesine, atamasına ve başlatmasına izin vererek Chat alanında ortak çalışmayı kolaylaştırın.

Kullanılan ürünler

Proje yönetimi uygulaması aşağıdaki Google Workspace ve Google Cloud ürünlerini kullanır:

• Chat API: Mesajlar gibi Chat etkileşim etkinliklerini alan ve bunlara yanıt veren Google Chat uygulamaları geliştirmeye yönelik bir API. Proje yönetimi Google Chat uygulaması, Chat'ten gönderilen etkileşim etkinliklerini almak ve yanıtlamak için Chat API'yi kullanır. Ayrıca, Chat'te nasıl görüneceğini belirleyen ad ve avatar resmi gibi özellikleri yapılandırır.
• Vertex AI API: Üretken yapay zeka platformu. Proje yönetimi Google Chat uygulaması, kullanıcı hikayesi başlıklarını ve açıklamalarını yazmak için Vertex AI API'yi kullanır.
• Firestore: Sunucusuz bir belge veritabanı. Proje yönetimi Google Chat uygulaması, kullanıcı hikayeleriyle ilgili verileri depolamak için Firebase'i kullanır.

• Cloud Functions: Sunucu veya çalışma zamanı ortamını yönetme gereği duymadan Chat etkileşim etkinliklerine yanıt verebilen tek amaçlı, bağımsız işlevler oluşturmanıza olanak tanıyan hafif bir sunucusuz bilgi işlem hizmeti. Proje yönetimi Google Chat uygulaması, Chat'in etkileşim etkinliklerini gönderdiği HTTP uç noktasını barındırmak için Cloud Functions'ı ve bu etkinlikleri işleyip yanıtlayan mantığı çalıştırmak için bir bilgi işlem platformu olarak kullanır.

  Cloud Functions, oluşturmak, etkileşim etkinliklerini işlemek ve bilgi işlem kaynaklarını barındırmak için aşağıdaki Google Cloud ürünlerini kullanır:

  • Cloud Build: Otomatik derlemeler çalıştıran, tümüyle yönetilen bir sürekli entegrasyon, teslimat ve dağıtım platformu.
  • Pub/Sub: Mesaj üreten hizmetleri bu mesajları işleyen hizmetlerden ayıran, eşzamansız ve ölçeklenebilir bir mesajlaşma hizmeti.
  • Cloud Run Admin API: Container mimarisine alınmış uygulamaları çalıştırmak için kullanılan, tümüyle yönetilen bir ortam.

Mimari

Proje yönetimi Google Chat uygulaması mimarisi, Chat etkileşimi etkinliklerini bir HTTP uç noktasında alır ve işler, kullanıcı hikayeleri yazmaya yardımcı olmak için Vertex AI'ı kullanır ve kullanıcı hikayesi ayrıntılarını bir Firestore veritabanında saklar. Aşağıdaki şemada, kullanılan Google Workspace ve Google Cloud kaynaklarının mimarisi gösterilmektedir.

Proje Yönetimi Google Chat uygulaması şu şekilde çalışır:

1. Bir kullanıcı Chat'te mesaj gönderir ve doğrudan mesaj göndererek, bir alanda bahsederek veya eğik çizgi komutu girerek proje yönetimi Google Chat uygulamasını çağırır.

2. Chat, Cloud Function'ın HTTP uç noktasına senkron bir HTTP isteği gönderir.

3. Proje yönetimi Google Chat uygulaması, HTTP isteğini işler:

   1. Vertex AI, kullanıcı hikayesi yazmaya veya güncellemeye yardımcı olur.

   2. Firestore veritabanı, kullanıcı hikayesi verilerini depolar, alır, günceller veya siler.

4. Cloud Functions, Chat'e bir HTTP yanıtı döndürür. Bu yanıt, kullanıcıya mesaj veya iletişim kutusu olarak gösterilir.

Ortamı hazırlama

Bu bölümde, sohbet uygulaması için Google Cloud projesinin nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.

Google Cloud projesi oluşturma

Google API Konsolu

1. Google API Console'da Menü > IAM & Admin > Proje Oluştur'a gidin.

   Proje oluşturma bölümüne gitme

2. Proje Adı alanına projeniz için açıklayıcı bir ad girin.

   İsteğe bağlı: Proje kimliğini düzenlemek için Düzenle'yi tıklayın. Proje kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, projenin kullanım ömrü boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.

3. Konum alanında, projeniz için olası konumları görüntülemek üzere Göz at'ı tıklayın. Ardından Seç'i tıklayın.
   Dikkat: Google Workspace kuruluşunuzu bulamıyor musunuz?
   Bu, bir Google Workspace hesabında oturum açmadığınız anlamına gelir. Google Workspace geliştirici belgelerinde açıklanan özelliklerden bazıları yalnızca bir kuruluşla ilişkili projelerde kullanılabilir.
4. Oluştur'u tıklayın. Google API Konsolu, Kontrol Paneli sayfasına gider ve projeniz birkaç dakika içinde oluşturulur.

gcloud CLI

Aşağıdaki geliştirme ortamlarından birinde Google Cloud KSA'ya (gcloud) erişin:

• Cloud Shell: gcloud CLI'nın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin.
  Cloud Shell'i etkinleştirme
• Yerel kabuk: Yerel geliştirme ortamı kullanmak için gcloud CLI'yı yükleyin ve ilk kullanıma hazırlayın.
  Cloud projesi oluşturmak için gcloud projects create komutunu kullanın:

  gcloud projects create PROJECT_ID

  Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID yerine yazın.

Cloud projesi için faturalandırmayı etkinleştirme

Bir faturalandırma hesabını bağlayamıyorsanız bu değişikliği yapmak için gereken izinlere sahip değilsiniz. Daha fazla bilgi için Faturalandırmayı etkinleştirmek için gereken izinler başlıklı makaleyi inceleyin.

Google API Konsolu

1. Google API Konsolu'nda Faturalandırma'ya gidin. Şunu tıklayın: Menü > Faturalandırma > Projelerim.

   Projelerim için Faturalandırma'ya git

2. Bir kuruluş seçin bölümünde, Google Cloud projenizle ilişkili kuruluşu seçin.
3. Proje satırında İşlemler menüsünü () açın, Faturalandırmayı değiştir'i tıklayın ve Cloud Faturalandırma hesabını seçin.
4. Hesap belirle'yi tıklayın.

gcloud CLI

1. Kullanılabilir faturalandırma hesaplarını listelemek için şu komutu çalıştırın:

   gcloud billing accounts list

2. Faturalandırma hesabını Google Cloud projesiyle bağlama:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   Aşağıdakini değiştirin:

   • PROJECT_ID, faturalandırmayı etkinleştirmek istediğiniz Cloud projesinin proje kimliğidir.
   • BILLING_ACCOUNT_ID, Google Cloud projesiyle ilişkilendirilecek faturalandırma hesabı kimliğidir.

API'leri etkinleştirme

Google API Konsolu

1. Google API Konsolu'nda Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API ve Cloud Run Admin API'yi etkinleştirin.

   API'leri etkinleştirme

2. API'leri doğru Cloud projesinde etkinleştirdiğinizi onaylayın ve İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizi onaylayın ve Etkinleştir'i tıklayın.

gcloud CLI

1. Gerekirse mevcut Cloud projesini gcloud config set project komutuyla oluşturduğunuz projeye ayarlayın:

   gcloud config set project PROJECT_ID

   PROJECT_ID yerine oluşturduğunuz Cloud projesinin proje kimliğini girin.

2. gcloud services enable komutuyla Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API ve Cloud Run Admin API'yi etkinleştirin:

   gcloud services enable chat.googleapis.com \
   aiplatform.googleapis.com \
   cloudfunctions.googleapis.com \
   firestore.googleapis.com \
   cloudbuild.googleapis.com \
   pubsub.googleapis.com \
   run.googleapis.com

   Cloud Build, Pub/Sub ve Cloud Run Admin API'leri Cloud Functions'ın ön koşullarıdır.

Kimlik doğrulama ve yetkilendirme

Bu eğitimi takip etmek için kimlik doğrulama ve yetkilendirme yapılandırması gerekmez.

Bu eğitimde, Firestore ve Vertex AI API'lerini çağırmak için Cloud Function'a eklenmiş varsayılan hizmet hesabıyla Uygulama Varsayılan Kimlik Bilgileri kullanılır. Bu kimlik bilgilerini ayarlamanız gerekmez. Üretim ortamında genellikle Cloud Function'a hizmet hesabı oluşturup eklersiniz.

Google Chat uygulamasını oluşturma ve dağıtma

Google Cloud projeniz oluşturulup yapılandırıldığına göre artık Google Chat uygulamasını oluşturup dağıtmaya hazırsınız. Bu bölümde şunları yapacaksınız:

1. Kullanıcı hikayelerini kalıcı hale getirmek ve almak için bir Firestore veritabanı oluşturun.
2. İsteğe bağlı olarak örnek kodu inceleyin.
3. Chat uygulamasının kodunu, Chat'ten HTTP istekleri olarak alınan etkinliklere yanıt verecek şekilde barındırmak ve çalıştırmak için bir Cloud Function oluşturun.
4. Google Chat API yapılandırma sayfasında Google Chat uygulaması oluşturup dağıtın.

Firestore veritabanını oluşturma

Bu bölümde, kullanıcı hikayelerini kalıcı hale getirmek ve almak için bir Firestore veritabanı oluşturacaksınız ancak veri modelini tanımlamayacaksınız. Veri modeli, örnek koddaki model/user-story.js ve model/user.js dosyalarıyla örtülü olarak ayarlanır.

Proje yönetimi sohbet uygulaması veritabanı, NoSQL veri modeli kullanır. Bu model, belgelere dayanır ve koleksiyonlar halinde düzenlenir. Daha fazla bilgi için Firestore veri modeli başlıklı makaleyi inceleyin.

Aşağıdaki şema, proje yönetimi Google Chat uygulamasının veri modeline genel bir bakış sunmaktadır:

Kök koleksiyon spaces'dır. Buradaki her doküman, Chat uygulamasının hikaye oluşturduğu bir alanı temsil eder. Her kullanıcı hikayesi userStories alt koleksiyonundaki bir belgeyle, her kullanıcı ise users alt koleksiyonundaki bir belgeyle temsil edilir.

Koleksiyon, doküman ve alan tanımlarını görüntüleme

spaces

Chat uygulamasının hikaye oluşturduğu alanlar.

Alanlar
Document ID	String Hikayelerin oluşturulduğu belirli bir alanın benzersiz kimliği. Chat API'deki alanın kaynak adıyla eşleşir.
userStories	Subcollection of Documents (userStories) Chat uygulaması ve kullanıcıları tarafından oluşturulan hikayeler. Firebase'deki userStories öğesinin Document ID ile eşleşir.
users	Subcollection of Documents (user) Hikaye oluşturan veya hikaye atanan kullanıcılar.
displayName	String Chat API'deki alanın görünen adı. Kullanıcılarla doğrudan mesajlaşma için ayarlanmaz.

userStories

Chat uygulaması ve kullanıcıları tarafından oluşturulan hikayeler.

Alanlar
Document ID	String Chat uygulaması ve kullanıcıları tarafından oluşturulan belirli bir kullanıcı hikayesinin benzersiz kimliği.
assignee	Document (user) Hikayeyi tamamlamakla görevlendirilen kullanıcının kaynak adı. Document ID belgesinin users ile ve Chat API'deki kullanıcının kaynak adıyla eşleşir.
description	String Yazılım özelliğinin kullanıcı açısından açıklaması.
priority	Enum Çalışmanın tamamlanması için gereken aciliyet. Olası değerler Low, Medium veya High'dir.
size	Enum İş miktarı. Olası değerler Small, Medium veya Large'dir.
status	Enum Çalışmanın aşaması. Olası değerler OPEN, STARTED veya COMPLETED'dir.
title	String Hikayenin başlığı; kısa bir özet.

users

Hikaye oluşturan veya hikaye atanan kullanıcılar

Alanlar
Document ID	String Belirli bir kullanıcının benzersiz kimliği. Firebase'deki userStories öğesinin assignee ile ve Chat API'deki kullanıcının kaynak adıyla eşleşir.
avatarUrl	String Kullanıcının Chat avatarı resmini barındıran URL.
displayName	String Kullanıcının Chat'teki görünen adı.

Firestore veritabanını oluşturmak için:

Google API Konsolu

1. Google API Konsolu'nda Firestore'a gidin. Menü > Firestore'u tıklayın.

   Firestore'a gidin

2. Create database'i (Veritabanı oluştur) tıklayın.

3. Select your Firestore mode (Firestore modunuzu seçin) bölümünde Native mode'u (Yerel mod) tıklayın.

4. Devam'ı tıklayın.

5. Veritabanını yapılandırın:

   1. Veritabanınıza ad verin bölümünde Veritabanı kimliği'ni (default) olarak bırakın.

   2. Konum türü'nde veritabanınız için bir bölge belirtin. Örneğin: us-central1. En iyi performans için Chat uygulamasının Cloud Function'ı ile aynı veya yakındaki konumu seçin.

6. Create database'i (Veritabanı oluştur) tıklayın.

gcloud CLI

• gcloud firestore databases create komutuyla yerel modda bir Firestore veritabanı oluşturun:

  gcloud firestore databases create \
  --location=LOCATION \
  --type=firestore-native

  LOCATION yerine us-central1 gibi bir Firestore bölgesi adını yazın.

Örnek kodu inceleme

İsteğe bağlı olarak, Cloud Function'ı oluşturmadan önce GitHub'da barındırılan örnek kodu inceleyip tanıyabilirsiniz.

GitHub'da göster

Her dosyanın genel bir bakışını aşağıda bulabilirsiniz:

env.js

Chat uygulamasını belirli bir Google Cloud projesine ve bölgesine dağıtmak için ortam yapılandırma değişkenleri. Bu dosyadaki yapılandırma değişkenlerini güncellemeniz gerekir.

package.json ve package-lock.json

Node.js proje ayarları ve bağımlılıkları.

index.js

Chat uygulamasının Cloud Functions işlevi için giriş noktası. HTTP isteğinden Chat event'i okur, uygulama işleyicisini çağırır ve HTTP yanıtını JSON nesnesi olarak yayınlar.

controllers/app.js

Ana uygulama mantığı. Sohbet uygulaması bahsetmelerini ve eğik çizgi komutlarını işleyerek etkileşim etkinliklerini işler. Kart tıklamalarına yanıt vermek için app-action-handler.js işlevini çağırır.

controllers/app-action-handler.js

Kart tıklamasını işlemek için uygulama mantığı Chat etkileşim etkinlikleri.

services/space-service.js, services/user-service.js ve services/user-story-service.js

Bu dosyalar, Chat alanları, kullanıcılar ve kullanıcı hikayeleriyle çalışmaya özgü uygulama mantığının bölümlerini içerir. Bu dosyalardaki işlevler app.js veya app-action-handler.js tarafından çağrılır. Veritabanı işlemlerini gerçekleştirmek için bu dosyalardaki işlevler, firestore-service.js içindeki işlevleri çağırır.

services/firestore-service.js

Veritabanı işlemlerini gerçekleştirir. Bu dosyadaki işlevler services/space-service.js, services/user-service.js ve services/user-story-service.js tarafından çağrılır.

services/aip-service.js

Üretken yapay zeka metin tahmini için Vertex AI API'yi çağırır.

model/*.js

Bu dosyalar, uygulama hizmetlerinin verileri işlevler arasında depolamak ve aktarmak için kullandığı sınıfların ve numaralandırılmış türlerin tanımını içerir. Firestore veritabanı için veri modelini ayarlarlar.

views/*.js

Bu dizindeki her dosya, Chat uygulamasının Chat'e kart mesajı veya iletişim kutusu işlemi yanıtı olarak geri gönderdiği bir kart nesnesi oluşturur.

views/widgets/*.js

Her dosya, uygulamanın views/ dizinindeki kartları oluşturmak için kullandığı bir widget nesnesi türünü başlatır.

test/**/*.test.js

Bu dizindeki ve alt dizinlerindeki her dosya, ilgili işlev, denetleyici, hizmet, görünüm veya widget'ın birim testlerini içerir. Projenin kök dizinindeyken npm run test komutunu çalıştırarak tüm birim testlerini yürütebilirsiniz.

Cloud Functions işlevini oluşturma ve dağıtma

Bu bölümde, proje yönetimi Chat uygulamasının uygulama mantığını içeren bir Cloud Functions işlevi oluşturup dağıtacaksınız.

Cloud Functions, Chat'ten gelen ve Chat etkileşimi etkinliği içeren bir HTTP isteğine yanıt olarak çalışır. Çalıştırıldığında Cloud Functions kodu, etkinliği işler ve Chat'e bir yanıt döndürür. Chat bu yanıtı mesaj, iletişim kutusu veya başka bir kullanıcı etkileşimi türü olarak oluşturur. Geçerliyse Cloud Function, Firestore veri tabanından okuma veya Firestore veri tabanına yazma işlemi de yapar.

Cloud Functions işlevini oluşturmak için:

Google API Konsolu

1. Kodu GitHub'dan ZIP dosyası olarak indirin.

   ZIP dosyasını indirme

2. İndirilen ZIP dosyasını çıkarın.

   Ayıklanan klasör, Google Workspace örnekleri deposunun tamamını içerir.

3. Ayıklanan klasörde add-ons-samples-main/node/chat/project-management-app/ bölümüne gidin, ardından project-management-app klasörünü ZIP dosyası olarak sıkıştırın.

   ZIP dosyasının kök dizini aşağıdaki dosya ve klasörleri içermelidir:

   • env.js
   • README.md
   • gcloudignore.text
   • package-lock.json
   • package.json
   • index.js
   • model/
   • controllers/
   • views/
   • services/

4. Google API Konsolu'nda Cloud Functions sayfasına gidin:

   Cloud Functions'a gitme

   Chat uygulamanızın Google Cloud projesinin seçildiğinden emin olun.

5. Create Function'ı (İşlev oluştur) tıklayın.

6. İşlev oluştur sayfasında işlevinizi ayarlayın:

   1. Ortam bölümünde Cloud Run işlevi'ni seçin.
   2. İşlev adı alanına project-management-tutorial girin.
   3. Bölge'de bir bölge seçin.
   4. Kimlik doğrulama bölümünde Kimliği doğrulanmayan çağrılara izin ver'i seçin.
   5. İleri'yi tıklayın.

7. Çalışma zamanı bölümünde Node.js 20'yi seçin.

8. Giriş noktası bölümünde varsayılan metni silin ve projectManagementChatApp girin.

9. Kaynak kodu bölümünde Zip yükleme'yi seçin.

10. Hedef pakette, bir paket oluşturun veya seçin:

    1. Göz at'ı tıklayın.
    2. Bir paket seçin.
    3. Seç'i tıklayın.

    Google Cloud, zip dosyasını bu pakete yükler ve bileşen dosyalarını ayıklar. Ardından Cloud Functions, bileşen dosyalarını Cloud Functions'a kopyalar.

11. Zip dosyası bölümünde, GitHub'dan indirip çıkardığınız ve yeniden sıkıştırdığınız ZIP dosyasını yükleyin:

    1. Göz at'ı tıklayın.
    2. ZIP dosyasına gidip dosyayı seçin.
    3. Aç'ı tıklayın.

12. Dağıt'ı tıklayın.

    Cloud Functions ayrıntıları sayfası açılır ve işleviniz iki ilerleme göstergesiyle birlikte görünür: biri derleme, diğeri hizmet için. Her iki ilerleme göstergesi de kaybolup yerini onay işaretine bıraktığında işleviniz dağıtılmış ve hazır demektir.

13. Sabitleri ayarlamak için örnek kodu düzenleyin:

    1. Cloud Function ayrıntıları sayfasında Düzenle'yi tıklayın.
    2. İleri'yi tıklayın.
    3. Kaynak kodu bölümünde Satır içi düzenleyici'yi seçin.
    4. Satır içi düzenleyicide env.js dosyasını açın.
    5. project-id yerine Cloud proje kimliğinizi yazın.
    6. İsteğe bağlı: us-central1 değerini Cloud Function'ınız için desteklenen bir konumla güncelleyin.

14. Dağıt'ı tıklayın.

15. İşlevin dağıtımı tamamlandığında tetikleyici URL'yi kopyalayın:

    1. İşlev ayrıntıları sayfasında Tetikleyici'yi tıklayın.
    2. URL'yi kopyalayın. Aşağıdaki bölümde Chat uygulamasını yapılandırmak için bu bilgiye ihtiyacınız var.

gcloud CLI

1. Kodu GitHub'dan kopyalayın:

   git clone https://github.com/googleworkspace/add-ons-samples.git

2. Bu proje yönetimi sohbet uygulamasının kodunu içeren dizine geçin:

   cd add-ons-samples/node/chat/project-management-app

3. Ortam değişkenlerini ayarlamak için env.js dosyasını düzenleyin:

   1. project-id yerine Google Cloud proje kimliğinizi yazın.
   2. us-central1 yerine Google Cloud projenizin konumunu yazın.

4. Cloud Function'ı Google Cloud'a dağıtın:

   gcloud functions deploy project-management-tutorial \
   --gen2 \
   --region=REGION \
   --runtime=nodejs20 \
   --source=. \
   --entry-point=projectManagementChatApp \
   --trigger-http \
   --allow-unauthenticated

   REGION yerine, BT altyapısının barındırıldığı bir Cloud Functions konumu (ör. us-central1) girin.

1. İşlevin dağıtımı tamamlandığında yanıttan url özelliğini kopyalayın. Bu, Google Chat uygulamasını yapılandırmak için aşağıdaki bölümde kullandığınız tetikleyici URL'dir.

Google API Konsolu'nda Google Chat uygulamasını yapılandırma

Bu bölümde, Google API Konsolu'nda Chat uygulamanızla ilgili bilgilerle birlikte Chat API'nin nasıl yapılandırılacağı gösterilmektedir. Bu bilgiler arasında Chat uygulamasının adı, desteklenen eğik çizgi komutları ve Chat etkileşimi etkinliklerini gönderdiği Chat uygulamasının Cloud Function'ının tetikleyici URL'si yer alır.

1. Google API Console'da Menü > API'ler ve Hizmetler > Etkin API'ler ve Hizmetler > Google Chat API > Yapılandırma'yı tıklayın.

   Chat API yapılandırmasına gitme

2. Uygulama adı alanına Project Manager yazın.

3. Avatar URL'si bölümüne https://developers.google.com/chat/images/quickstart-app-avatar.png yazın.

4. Açıklama bölümüne Manages projects with user stories. yazın.

5. Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini açık konumuna getirin.

6. İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.

7. Bağlantı ayarları bölümünde HTTP uç nokta URL'si'ni seçin.

8. Hizmet hesabı e-posta adresini kopyalayın. Google Chat uygulamanızın işlevinizi çağırmasına yetki verirken bu e-postaya ihtiyacınız olur.

9. Tetikleyiciler bölümünde Tüm tetikleyiciler için ortak bir HTTP uç nokta URL'si kullan'ı seçin.

10. HTTP uç nokta URL'si alanına, https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial biçiminde Cloud Function tetikleyici URL'sini yapıştırın. Cloud Functions'ı gcloud KSA ile dağıttıysanız bu, url özelliğidir.

11. Chat uygulamasının eğik çizgi komutlarını kaydedin. Eğik çizgi komutu kaydetmek için:

    1. Komutlar bölümünde Komut ekle'yi tıklayın.

    2. Aşağıdaki tabloda ayrıntılı olarak açıklanan her komut için Komut Kimliği'ni girin, Açıklama'yı girin, Komut türü bölümünde Eğik çizgi komutu'nu seçin, Eğik çizgi komutu adı'nı girin, İletişim kutusu'nu seçin ve Bitti'yi tıklayın:

       Komut Kimliği	Açıklama	Eğik çizgi komutu adı	Dialog
       1	Belirtilen başlığa sahip bir hikaye oluşturun.	/createUserStory	Seçili değil
       2	Kullanıcıya atanan tüm hikayeleri listeler.	/myUserStories	Seçili değil
       3	Belirtilen hikayenin mevcut durumunu gösterir.	/userStory	Seçili değil
       4	Hikayelerin düzenlenebileceği bir iletişim kutusu açar.	/manageUserStories	Seçili
       5	Alandaki tüm haberleri siler.	/cleanupUserStories	Seçili değil

12. Görünürlük bölümünde Bu Google Chat uygulamasını Workspace alanınızdaki belirli kişiler ve gruplar için kullanılabilir hale getirin'i seçip e-posta adresinizi girin.

13. İsteğe bağlı olarak, Günlükler bölümünde Günlük hatalarını günlüğe kaydetme'yi seçin.

14. Kaydet'i tıklayın. Yapılandırma kaydedildi mesajı gösterilir.

Chat uygulaması, Chat'teki mesajları almaya ve yanıtlamaya hazırdır.

Chat uygulamasını test etme

Proje yönetimi Chat uygulamasını test etmek için uygulamaya mesaj gönderin ve kullanıcı hikayeleri oluşturmak, düzenlemek ve silmek için uygulamanın eğik çizgi komutlarını kullanın.

1. Kendinizi güvenilir test kullanıcıları arasına eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e gidin

2. Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.

4. Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.

   Not: Chat uygulamanızı sonuç listesinde görmüyorsanız Google API Konsolu'ndaki Chat API Yapılandırması sayfasının Görünürlük ayarlarında Google Workspace hesabınızı eklediğinizden emin olun.
5. Uygulamayla yeni doğrudan mesajda Hello yazıp enter tuşuna basın. Proje Yönetimi Chat uygulaması, yapabileceklerini ayrıntılı olarak açıklayan bir yardım menüsüyle yanıt verir.
6. Hikaye oluşturmak için mesaj çubuğuna /createUserStory Test story yazıp gönderin. Proje yönetimi sohbet uygulaması, Vertex AI'daki üretken yapay zekayı kullanarak sizin için oluşturduğu kullanıcı hikayesini ayrıntılı olarak açıklayan bir kart mesajıyla yanıt verir.

7. API Konsolu'nda, Chat uygulamasını eklediğiniz alan, bu alanla etkileşimde bulunan kullanıcılar ve oluşturduğunuz kullanıcı hikayesi hakkında oluşturulan kayıtları incelemek için Firestore veritabanını kontrol edin.

   Firestore'a gidin

8. Google Chat'e geri dönün.

   Google Chat'e gidin

9. Dilerseniz hikayeyi düzenlemek için Düzenle'yi tıklayın. Hikayeden memnun kaldığınızda Kaydet'i tıklayın.
10. Uygulama tarafından desteklenen her eğik çizgi komutunu test edin. Bu komutları görmek için / yazın veya Sohbet uygulamasından bahsedin.
11. /cleanupUserStories/ komutunu vererek test kullanıcı hikayesini silin. Alternatif olarak, uygulamayı kaldırın veya silin. Kaldırıldığında uygulama, o alanda oluşturulan tüm kullanıcı hikayelerini siler.

Sorun giderme

Bir Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir hata oluştu" veya "İsteğiniz işlenemiyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmese de Chat uygulamaları için hata günlüğü kaydı etkinleştirildiğinde hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri kullanılabilir. Hataları görüntüleme, hata ayıklama ve düzeltmeyle ilgili yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.

Temizleme

Bu eğitimde kullanılan kaynaklar için Google Cloud hesabınızdan ücret alınmasını önlemek istiyorsanız Cloud projesini silmenizi öneririz.

Dikkat: Bir projeyi silmenin etkileri şunlardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir proje kullandıysanız projeyi sildiğinizde projede yaptığınız diğer tüm çalışmalar da silinir.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. appspot.com'daki bir URL gibi proje kimliğini kullanan URL'leri korumak için projenin tamamını silmek yerine proje içindeki seçili kaynakları silin.

Birden fazla eğitim ve hızlı başlangıç kılavuzunu incelemeyi planlıyorsanız projeleri yeniden kullanmak, proje kotası sınırlarını aşmanızı önleyebilir.

1. Google API Konsolu'nda Kaynakları yönet sayfasına gidin. Şunu tıklayın: Menü > IAM & Admin > Kaynakları Yönetin.

   Kaynak Yöneticisi'ne gidin

2. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
3. İletişim kutusunda proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

İlgili konular

• Google Workspace'te erişilebilen bir yapay zeka aracısıyla seyahat planlama
• Gemini Yapay Zeka Chat uygulamasıyla Chat görüşmelerine dayalı soruları yanıtlama
• Google Chat, Vertex AI, Apps Komut Dosyası ve kullanıcı kimlik doğrulaması ile olaylara yanıt verme
• ADK yapay zeka ajanı ve Gemini modeliyle ifadelerin doğruluğunu kontrol etme
• Temel yapay zeka kavramlarını Chat uygulamalarına entegre etme
• Apps Komut Dosyası ile Google Workspace eklentisi olarak Chat uygulaması oluşturma