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

Bu eğitim, ekiplerin projeleri gerçek zamanlı olarak yönetmek için kullanabileceği bir Google Chat uygulamasının nasıl geliştirileceğini gösterir. Chat uygulaması, ekiplerin kullanıcı hikayeleri yazmalarına yardımcı olmak için Vertex AI'ı kullanır (Bu hikayeler, ekibin geliştirebileceği kullanıcı bakış açısından bir yazılım sisteminin özelliklerini temsil eder) ve hikayeleri bir Firestore veritabanında sürdürür.

• 

  Şekil 1. Can, Chat alanında ekibiyle özellik geliştirme hakkında konuşuyor. Proje yönetimi Chat uygulamasından bahsedildiğinde Chat uygulaması yardım istemeye başlar.

• 
  Şekil 2. /createUserStory Eğ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ıyor ve ardından hikayeyi alanda paylaşıyor.
• 
  Şekil 4. Charlie, hikaye ayrıntılarını tamamlamak için Düzenle'yi tıklar. Yapay zeka açıklaması doğrudur ancak Charlie daha fazla ayrıntı ister. Bu nedenle, Vertex AI'ın hikaye açıklamasına şartlar eklemesi için Genişlet'i tıklar. Caner hikayeyi kendisine atar, durumu "Başladı" olarak ayarlar, uygun bir öncelik ve boyut seçer ve Kaydet'i tıklar.
• 
  Şekil 5. Charlie, /manageUserStories eğik çizgi komutunu
  kullanarak ekibin tüm kullanıcı hikayelerini dilediğinde 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şin:

  • Bir Google Cloud projesi oluşturun.
  • Cloud projesine bir Google Cloud faturalandırma hesabı 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 işlevi çağrıları kullanın. Google Cloud kuruluşunuzun alanla kısıtlanmış paylaşım kullanıp kullanmadığını belirleyerek bu çağrıları doğrulayabilirsiniz.

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

• Google Cloud CLI kullanıyorsanız gcloud CLI ile çalışacak şekilde yapılandırılmış bir Node.js geliştirme ortamı. Node.js geliştirme ortamı oluşturma başlıklı makaleyi inceleyin.

Hedefler

• Çevik yazılım projelerini yöneten bir Chat uygulaması oluşturun.
• Vertex AI tarafından desteklenen üretken yapay zeka destekli hikaye yazma araçlarıyla kullanıcıların kullanıcı hikayeleri yazmasına yardımcı olun:
  • Hikaye açıklamalarını oluşturup yeniden üretin.
  • Notlardan hikaye açıklamalarını genişleterek şartları tamamlayın.
  • Yazım hatalarını düzeltmek için dil bilgisini kontrol edin.
• Firestore veritabanına veri yazarak ve veritabanından veri 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 olanak tanıyarak 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 yanıtlayan Google Chat uygulamaları geliştirmek için bir API. Proje yönetimi Google Chat uygulaması, Chat tarafından gönderilen etkileşim etkinliklerini almak ve yanıtlamak ve Chat'te nasıl görüneceğini belirleyen özellikleri (ör. ad ve avatar resmi) yapılandırmak için Chat API'yi kullanır.
• Vertex AI API: Üretken yapay zeka platformu. Proje yönetimi Google Chat uygulaması, kullanıcı hikayesi başlıkları ve açıklamaları yazmak için Vertex AI API'yi kullanır.
• Firestore: Sunucusuz bir belge veritabanı. Proje yönetimi için kullanılan Google Chat uygulaması, kullanıcı hikayeleriyle ilgili verileri depolamak için Firebase'i kullanır.

• Cloud Functions: Bir sunucu veya çalışma zamanı ortamını yönetme gereği olmadan Chat etkileşim etkinliklerine yanıt verebilecek tek amaçlı, bağımsız işlevler oluşturmanıza olanak tanıyan hafif bir sunucusuz bilgi işlem hizmetidir. 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'i kullanır ve bu etkinlikleri işleyip yanıtlayan mantığı çalıştırmak için bir bilgi işlem platformu olarak kullanır.

  Cloud Functions, etkileşim etkinliklerini oluşturmak, 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, iletim 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 hizmetidir.
  • Cloud Run Admin API: Container mimarisine alınmış uygulamaları çalıştırmak için tümüyle yönetilen bir ortam.

Mimari

Proje yönetimi Google Chat uygulaması mimarisi, Chat etkileşim 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 depolar. Aşağıdaki şemada, Google Workspace'in ve kullanılan 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 proje yönetimi Google Chat uygulamasını doğrudan mesaj göndererek, bir alanda uygulamadan bahsederek veya eğik çizgi komutu girerek çağırır.

2. Chat, Cloud Functions'in HTTP uç noktasına senkronize bir HTTP isteği gönderir.

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

   1. Vertex AI, kullanıcı hikayesini yazmanıza veya güncellemenize 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, Chat uygulaması için Google Cloud projesinin nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.

Google Cloud projesi oluşturma

Google Cloud konsolu

1. Google Cloud Console'da Menü > IAM ve Yönetici > Proje Oluştur'a gidin.

   Proje Oluştur'a gidin

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 oluşturulduktan sonra proje kimliği değiştirilemez. Bu nedenle, projenin kullanım süresi boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.

3. Konum alanında, projenizin olası konumlarını görüntülemek için 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 dokümanlarında açıklanan özelliklerden bazıları yalnızca bir kuruluşla ilişkili projelerde kullanılabilir.
4. Oluştur'u tıklayın. Google Cloud Console, 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'si önceden ayarlanmış bir internet terminali kullanmak için Cloud Shell'i etkinleştirin.
  Cloud Shell'i etkinleştirme
• Yerel Kabuk: Yerel bir geliştirme ortamı kullanmak için gcloud CLI'yi yükleyin ve başlatı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 değerini değiştirin.

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

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

Google Cloud konsolu

1. Google Cloud Console'da Faturalandırma'ya gidin. Menü > Faturalandırma > Projelerim'i tıklayın.

   Projelerim için Faturalandırma'ya gidin

2. 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 Billing hesabını seçin.
4. Hesap belirle'yi tıklayın.

gcloud CLI

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

   gcloud billing accounts list

2. Bir faturalandırma hesabını Google Cloud projesine 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 projesine bağlanacak faturalandırma hesabı kimliğidir.

API'leri etkinleştirme

Google Cloud konsolu

1. Google Cloud Console'da Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API ve Cloud Run Yönetici API'yi etkinleştirin.

   API'leri etkinleştirme

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

3. Doğru API'leri etkinleştirdiğinizden emin olduktan sonra 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 kısmını, oluşturduğunuz Cloud projesinin proje kimliği ile değiştirin.

2. gcloud services enable komutunu kullanarak 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 Yönetici API'leri, Cloud Functions'in ön koşullarını oluşturur.

Kimlik doğrulama ve yetkilendirme

Bu eğitimde kimlik doğrulama ve yetkilendirme yapılandırması gerekmez.

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

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

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

1. Kullanıcı hikayelerinin saklanacağı ve alınacağı bir Firestore veritabanı oluşturun.
2. İsteğe bağlı olarak örnek kodu inceleyin.
3. Chat uygulamasının kodunu, Chat'ten HTTP isteği olarak alınan etkinliklere yanıt olarak barındırmak ve çalıştırmak için bir Cloud Functions işlevi oluşturun.
4. Google Chat API yapılandırma sayfasında bir 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şturur ancak veri modelini tanımlamazsınız. Veri modeli, örnek kodda model/user-story.js ve model/user.js dosyaları tarafından dolaylı olarak ayarlanır.

Proje yönetimi Chat uygulaması veritabanı, koleksiyonlar halinde düzenlenmiş belgelere dayalı bir NoSQL veri modeli kullanır. Daha fazla bilgi için Firestore veri modeli başlıklı makaleyi inceleyin.

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

Kök koleksiyonu spaces şeklindedir. Burada her doküman, Chat uygulamasının hikaye oluşturduğu bir alanı temsil eder. Her kullanıcı hikayesi, userStories alt koleksiyonundaki bir dokümanla, her kullanıcı ise users alt koleksiyonundaki bir dokümanla 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. Alanın Chat API'deki 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 özelliğine karşılık gelir.
users	Subcollection of Documents (user) Hikaye oluşturan veya hikaye atanmış kullanıcılar.
displayName	String Chat API'deki alanın görünen adı. Kullanıcılarla doğrudan mesajlar için ayarlanmamıştır.

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 tamamlamak üzere atanan kullanıcının kaynak adı. users belgesinin Document ID özelliğine ve Chat API'deki kullanıcının kaynak adına karşılık gelir.
description	String Yazılım özelliğinin kullanıcının bakış açısından açıklaması.
priority	Enum İşin tamamlanması gereken aciliyet derecesi. 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ığı ve kısa bir özeti.

users

Hikayeler oluşturan veya hikaye atanmış 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 karşılık gelir.
avatarUrl	String Kullanıcının Chat avatar resmini barındıran URL.
displayName	String Kullanıcının Chat görünen adı.

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

Google Cloud konsolu

1. Google Cloud Console'da Firestore'a gidin. Menü > Firestore'u tıklayın.

   Firestore'a git

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

3. Firestore modunuzu seçin bölümünde Yerel mod'u tıklayın.

4. Devam'ı tıklayın.

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

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

   2. Konum türü bölümünde, veritabanınız için bir bölge belirtin (ör. us-central1). En iyi performans için Chat uygulamasının Cloud Functions işleviyle aynı veya yakın bir konum seçin.

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

gcloud CLI

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

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

  LOCATION yerine bir Firestore bölgesinin adını (ör. us-central1) yazın.

Örnek kodu inceleyin

İsteğe bağlı olarak, Cloud Functions işlevini oluşturmadan önce GitHub'da barındırılan örnek kodu inceleyip tanımanızı öneririz.

GitHub'da göster

Her dosyaya genel bakış aşağıda verilmiştir:

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 giriş noktası. HTTP isteğinde sohbet etkinliğini okur, uygulama işleyiciyi çağırır ve HTTP yanıtını JSON nesnesi olarak yayınlar.

controllers/app.js

Ana uygulama mantığı. Chat uygulamasında bahsedilen ifadeleri 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ığı Sohbet etkileşimi etkinlikleri.

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

Bu dosyalar, uygulama mantığının Chat alanları, kullanıcılar ve kullanıcı hikayeleriyle çalışmaya özel 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 yönetir. 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 öngörüsü için Vertex AI API'yi çağırır.

model/*.js

Bu dosyalar, uygulama hizmetlerinin verileri saklamak ve işlevler arasında aktarmak için kullandığı sınıfların ve enum'ların tanımını içerir. Firestore veritabanının veri modelini ayarladılar.

views/*.js

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

views/widgets/*.js

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

test/**/*.test.js

Bu dizin ve alt dizinlerindeki her dosya, ilgili işlev, denetleyici, hizmet, görünüm veya widget için 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 işlevi, Chat'ten gelen ve Chat etkileşim etkinliği içeren bir HTTP isteğine yanıt olarak çalışır. Cloud Function kodu çalıştırıldığında 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. Cloud işlevi, uygun durumlarda Firestore veritabanından da veri okur veya veritabanına veri yazar.

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

Google Cloud konsolu

1. GitHub'dan kodu zip dosyası olarak indirin.

   Zip dosyasını indirme

2. İndirilen ZIP dosyasını ayıklayın.

   Çıkarılan klasör, Google Workspace örnekleri deposunun tamamını içerir.

3. Ayıklanan klasörde google-chat-samples-main/node/project-management-app/'e gidin ve 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 Cloud Console'da Cloud Functions sayfasına gidin:

   Cloud Functions'a git

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

5. İşlev Oluştur'u tıklayın.

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

   1. Ortam bölümünde Cloud Run İşlevi'ni seçin.
   2. İşlev adı alanına project-management-tutorial yazın.
   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ı alanında varsayılan metni silin ve projectManagementChatApp yazın.

9. Kaynak kod bölümünde Sıkıştırılmış dosya yükle'yi seçin.

10. Hedef paket'te bir paket create 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ı yükleyip bu paketteki bileşen dosyalarını çıkarır. Ardından Cloud Functions, bileşen dosyalarını Cloud Functions'a kopyalar.

11. Zip dosyasında, GitHub'dan indirdiğiniz, çıkarttığınız ve yeniden sıkıştırılan 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österilir: biri derleme, diğeri hizmet içindir. Her iki ilerleme göstergesi de kaybolduğunda ve yerine bir onay işareti konulduğunda işleviniz dağıtılır ve hazır olur.

13. Sabitler 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 kod 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 kısmını Cloud proje kimliğinizle değiştirin.
    6. İsteğe bağlı: us-central1 değerini, Cloud Functions işleviniz için desteklenen bir konum ile güncelleyin.

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

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

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

gcloud CLI

1. GitHub'dan kodu kopyalayın:

   git clone https://github.com/googleworkspace/google-chat-samples.git

2. Şu proje yönetimi Chat uygulamasının kodunun bulunduğu dizine geçin:

   cd google-chat-samples/node/project-management-app

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

   1. project-id kısmını Google Cloud proje kimliğinizle değiştirin.
   2. us-central1 yerine Google Cloud projenizin konumunu yazın.

4. Cloud Functions işlevini 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 öğesini, altyapısının barındırıldığı us-central1 gibi bir Cloud Functions konumuyla değiştirin.

1. İşlev dağıtımı tamamlandığında yanıttan url mülkünü kopyalayın. Bu, Google Chat uygulamasını yapılandırmak için aşağıdaki bölümde kullanacağınız Tetikleyici URL'sidir.

Google Cloud Console'da Google Chat uygulamasını yapılandırma

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

1. Google Cloud Console'da Menü > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma'yı tıklayın.

   Chat API yapılandırmasına gidin

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

3. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png yazın.

4. Açıklama alanına Manages projects with user stories. yazın.

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

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

7. Bağlantı ayarları altında HTTP uç nokta URL'si seçeneğini belirleyin.

8. HTTP uç noktası URL'si alanına, Cloud Functions dağıtımından kopyaladığınız Tetikleyici URL'sini https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial biçiminde yapıştırın. Cloud Functions'i gcloud CLI ile dağıttıysanız bu url mülküdür.

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

   1. Eğik çizgi komutları altında, Eğik çizgi komutu ekle'yi tıklayın.

   2. Aşağıdaki tabloda ayrıntılı olarak açıklanan her eğik çizgi komutu için Ad, Komut Kimliği, Açıklama'yı girin ve eğik çizgi komutunun İletişim kutusu açar olup olmadığını seçin, ardından Bitti'yi tıklayın:

      Ad	Komut kimliği	Açıklama	Bir iletişim kutusu açar
      /createUserStory	1	Belirtilen başlığa sahip bir hikaye oluşturun.	Seçili değil
      /myUserStories	2	Kullanıcıya atanan tüm hikayeleri listeler.	Seçili değil
      /userStory	3	Belirtilen hikayenin mevcut durumunu görüntüler.	Seçili değil
      /manageUserStories	4	Hikayeleri düzenleyebileceğiniz bir iletişim kutusu açar.	Seçili
      /cleanupUserStories	5	Alandaki tüm hikayeleri siler.	Seçili değil

10. Görünürlük bölümünde, Bu Chat uygulamasını Workspace alanınızdaki belirli kişiler ve grupların kullanımına sunun'u seçin ve e-posta adresinizi girin.

11. Dilerseniz Günlükler bölümünde Hataları günlüğe kaydet'i seçebilirsiniz.

12. Kaydet'i tıklayın. Bir yapılandırma kaydedilmiş mesajı görünür. Bu, Chat uygulamasının teste hazır olduğu anlamına gelir.

Chat uygulamasını test etme

Proje yönetimi Chat uygulamasına mesaj göndererek ve kullanıcı hikayeleri oluşturmak, düzenlemek ve silmek için eğik çizgi komutlarını kullanarak uygulamayı test edin.

1. Kendinizi Güvenilir Test Kullanıcısı olarak 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 kullanıcı 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: Sonuç listesinde Chat uygulamanızı görmüyorsanız Google Cloud Console'daki Chat API Yapılandırması sayfasının Görünürlük ayarlarına Google Workspace hesabınızı eklediğinizden emin olun.
5. Uygulamayla olan yeni doğrudan mesaja Hello yazın ve enter tuşuna basın. Proje yönetimi Chat uygulaması neler yapabileceğini 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 Chat uygulaması, Vertex AI'ın üretken yapay zekasını kullanarak sizin için oluşturduğu kullanıcı hikayesini ayrıntılı olarak açıklayan bir kart mesajıyla yanıt verir.

7. Konsolda, Chat uygulamasını eklediğiniz alan, uygulamayla etkileşime geçen kullanıcılar ve oluşturduğunuz kullanıcı hikayesi hakkında oluşturduğu 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. İsterseniz 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. Bunları görmek için / yazın veya Sohbet uygulamasından bahsedin.
11. /cleanupUserStories eğik çizgi komutunu kullanarak test kullanıcı hikayesini silin. Alternatif olarak, uygulamayı kaldırın veya kaldırın. Kaldırılan uygulama, ilgili 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" mesajı gösterilir. veya "İsteğiniz işlenemiyor." Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç verir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmeyebilir ancak Chat uygulamaları için hata günlüğü 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üzeltme hakkında yardım için Google Chat hatalarını giderme başlıklı makaleyi inceleyin.

Temizleme

Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.

Dikkat: Proje silmenin aşağıdaki etkileri vardı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 çalışmaları da silersiniz.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken, gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. Proje kimliğini kullanan URL'leri (ör. appspot.com'daki bir URL) korumak için projenin tamamını silmek yerine projedeki seçili kaynakları silin.

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

1. Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.

   Resource Manager'a gidin

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

İlgili konular

• Gemini yapay zeka sohbet uygulamasıyla Chat sohbetlerine dayalı soruları yanıtlama
• Google Chat, Vertex AI ve Apps Komut Dosyası ile olaylara yanıt verme