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 hazırlanacağını gösterir. Chat uygulaması, ekiplerin kullanıcı hikayeleri yazmasına yardımcı olmak için Vertex AI kullanır (Bu, ekibin geliştirebileceği kullanıcı bakış açısından bir yazılım sisteminin özelliklerini temsil eder) ve hikayeleri bir Firestore veritabanında tutar.

• 

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

• 
  Şekil 2. Charlie, /createUserStory eğik çizgi komutunu kullanarak bir hikaye oluşturuyor.
• 
  Şekil 3. Proje yönetimindeki Chat uygulaması, hikayenin açıklamasını yazmak için Vertex AI'ı kullanıyor, ardından hikayeyi alanda paylaşıyor.
• 
  Şekil 4. Charlie, hikaye ayrıntılarını tamamlamak için Düzenle'yi tıklıyor. Yapay zeka açıklaması doğru fakat Can daha fazla ayrıntı istiyor. Bu yüzden Genişlet'i tıklayarak Vertex AI'ın hikaye açıklamasına koşullar eklemesini sağlıyor. Charlie hikayeyi kendine atar, durumu "Başlangıç" olarak ayarlar, uygun bir öncelik ve boyut seçer, ardından Kaydet'i tıklar.
• 
  Şekil 5. Charlie, eğik çizgi komutuyla /manageUserStories ekibin kullanıcı hikayelerini dilediği zaman görüp yönetebilir.

Ön koşullar

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

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

  • Bir Google Cloud projesi oluşturun.
  • Google Cloud faturalandırma hesabını Cloud projesine bağlayın. Erişiminiz olup olmadığını öğrenmek amacıyla Faturalandırmayı etkinleştirmek için gereken izinler bölümüne bakın.

  • Google Cloud kuruluşunuzun alanla kısıtlı paylaşım kullanıp kullanmadığını belirleyerek doğrulayabileceğiniz kimliği doğrulanmamış Google Cloud Functions işlevi çağrılarını kullanın.

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

• Google Cloud KSA kullanılıyorsa gcloud KSA ile çalışacak şekilde yapılandırılmış bir Node.js geliştirme ortamı. Node.js geliştirme ortamını ayarlama bölümünü 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ı tekrar oluşturun.
  • Gereklilikleri tamamlamak için notlardaki hikaye açıklamalarını genişletin.
  • Yazım hatalarını düzeltmek için dil bilgisini düzeltin.
• Bir Firestore veritabanına yazma ve veritabanından okuma işlemleri yaparak çalışmayı 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 yanıtlayan Google Chat uygulamaları geliştirmek için kullanılan bir API. Proje yönetimi Google Chat uygulaması, Chat tarafından gönderilen etkileşim etkinliklerini almak ve yanıtlamak, ayrıca Chat'te nasıl görüneceğini belirleyen ad ve avatar resmi gibi özellikleri 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ı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ıyor.

• Cloud Functions: Bir sunucuyu veya çalışma zamanı ortamını yönetmeye gerek kalmadan Chat etkileşim etkinliklerine yanıt verebilen tek amaçlı, bağımsız işlevler oluşturmanızı sağlayan hafif, sunucusuz bilgi işlem hizmeti. Proje yönetimi Google Chat uygulaması, Chat'in etkileşim etkinliklerini gönderdiği ve bu etkinlikleri işleyen ve bunlara yanıt veren mantığı çalıştırmak amacıyla işlem platformu olarak HTTP uç noktasını barındırmak için Cloud Functions'ı kullanır.

  Cloud Functions, etkileşim etkinliklerini oluşturmak, işlemek ve bilgi işlem kaynakları 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 sürekli entegrasyon, teslim ve dağıtım platformu.
  • Pub/Sub: Bu mesajları işleyen hizmetlerden mesaj üreten hizmetleri 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 olan Google Chat uygulama mimarisi, bir HTTP uç noktasında Chat etkileşim etkinliklerini alıp işler, kullanıcı hikayelerinin yazılmasına 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, 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 ondan bahsederek veya eğik çizgi komutu girerek proje yönetimi Google Chat uygulamasını çağırır.

2. Chat, Cloud Functions işlevinin HTTP uç noktasına eşzamanlı 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 HTTP yanıtı döndürür ve mesajı kullanıcıya mesaj veya iletişim kutusu olarak gösterir.

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 Console

1. Google Cloud konsolunda Menü > IAM ve Yönetici > Proje oluştur'a gidin.

   Proje Oluşturma bölümüne git

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

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

3. Konum alanında projeniz için potansiyel 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. Create'i (Oluştur) 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: Halihazırda gcloud KSA bulunan bir online terminal kullanmak için Cloud Shell'i etkinleştirin.
  Cloud Shell'i etkinleştir
• Yerel Kabuk: Yerel bir geliştirme ortamı kullanmak için gcloud KSA'yı yükleyin ve initialize.
  Bulut 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 komutunu değiştirin.

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

Faturalandırma hesabı bağlayamazsanız bu değişikliği yapmak için gereken izinlere sahip değilsinizdir. Daha fazla bilgi edinmek üzere Faturalandırmayı etkinleştirmek için gereken izinler bölümüne bakın.

Google Cloud Console

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

   Projelerim için Faturalandırma sayfasına git

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 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ı bir Google Cloud projesine bağlayın:

   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 Console

1. Google Cloud konsolunda 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ştirmekte olduğunuzu onaylayın ve Etkinleştir'i tıklayın.

gcloud CLI

1. Gerekirse geçerli 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 Admin API'leri Cloud Functions'ın ön koşullarıdır.

Kimlik doğrulama ve yetkilendirme

Bu eğiticiyi uygulamak için kimlik doğrulama ve yetkilendirme yapılandırması gerekmez.

Bu eğiticide, Firestore ve Vertex AI API'lerini çağırmak için Cloud Functions işlevine ekli varsayılan hizmet hesabıyla birlikte Uygulama Varsayılan Kimlik Bilgileri kullanılır. Bu kimlik bilgilerini ayarlamanız gerekmez. Üretim ortamı söz konusu olduğunda ise genellikle bir hizmet hesabı oluşturup Cloud Functions işlevine ekleyebilirsiniz.

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ı derleyip dağıtmaya hazırsınız. Bu bölümde aşağıdaki işlemleri yapacaksınız:

1. Kullanıcı hikayelerini saklayabileceğiniz ve alacağınız bir Firestore veritabanı oluşturun.
2. Dilerseniz örnek kodu inceleyebilirsiniz.
3. Chat'ten HTTP istekleri olarak alınan etkinliklere yanıt olarak Chat uygulamasının kodunu barındıracak ve çalıştıracak 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ı oluşturma

Bu bölümde kullanıcı hikayelerini korumak ve almak için bir Firestore veritabanı oluşturacaksınız ancak veri modelini tanımlamayacaksı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ş belgeleri temel alan bir NoSQL veri modeli kullanır. Daha fazla bilgi edinmek için Firestore veri modeli bölümüne bakın.

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

Kök koleksiyonda spaces bulunur. Burada her doküman, Chat uygulamasının hikayeler oluşturduğu bir alanı temsil eder. Her kullanıcı hikayesi, userStories alt koleksiyonunda bir belgeyle temsil edilir. Her kullanıcı ise users alt koleksiyonundaki bir dokümanla temsil edilir.

Koleksiyon, belge 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ına karşılık gelir.
userStories	Subcollection of Documents (userStories) Chat uygulaması ve kullanıcıları tarafından oluşturulan hikayeler. Firebase'deki userStories öğesinin Document ID değerine karşılık gelir.
users	Subcollection of Documents (user) Hikaye oluşturan veya bunlara atanan kullanıcılar.
displayName	String Chat API'deki alanın görünen adı. Kullanıcılarla doğrudan mesajlar için ayarlanmadı.

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 için atanan kullanıcının kaynak adı. users dokümanının Document ID öğesine ve kullanıcının Chat API'deki 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 İşi tamamlama konusundaki aciliyet. Olası değerler Low, Medium veya High'dir.
size	Enum Çalışma miktarı. Olası değerler Small, Medium veya Large'dir.
status	Enum Çalışma aşaması. Olası değerler OPEN, STARTED veya COMPLETED'dir.
title	String Hikayenin başlığı; kısa bir özet.

users

Hikayeleri oluşturan veya bunlara atanan kullanıcılar.

Alanlar
Document ID	String Belirli bir kullanıcının benzersiz kimliği. Firebase'deki userStories öğesinin assignee değerine ve Chat API'de kullanıcının kaynak adına karşılık gelir.
avatarUrl	String Kullanıcının Chat avatar resmini barındıran URL.
displayName	String Kullanıcının Chat'te görünen adı.

Firestore veritabanını oluşturmak için aşağıdaki adımları uygulayın:

Google Cloud Console

1. Google Cloud konsolunda 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'de Yerel mod'u tıklayın.

4. Devam'ı tıklayın.

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

   1. Veritabanınızı adlandırın bölümünde Veritabanı Kimliği'ni (default) olarak bırakın.

   2. Konum türü alanında veritabanınız için us-central1 gibi bir bölge belirtin. En iyi performans için Chat uygulamasının Cloud Functions işleviyle aynı veya yakındaki konumu seçin.

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

gcloud CLI

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

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

  LOCATION kısmını us-central1 gibi bir Firestore bölgesinin adıyla değiştirin.

Örnek kodu inceleyin

İsteğe bağlı olarak, Cloud Functions işlevini oluşturmadan önce GitHub'da barındırılan örnek kodu inceleyin ve öğrenin.

GitHub'da göster

Her bir dosyayla ilgili genel bakışı burada 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'nin 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 etkinliğini okur, uygulama işleyiciyi çağırır ve HTTP yanıtını bir JSON nesnesi olarak yayınlar.

controllers/app.js

Ana uygulama mantığı. Chat uygulamasından bahsetme ve eğik çizgi komutlarını kullanarak etkileşim etkinliklerini işler. Kart tıklamalarına yanıt vermek için app-action-handler.js yöntemini çağırır.

controllers/app-action-handler.js

Kart tıklamasını işleyen uygulama mantığı Chat etkileşim 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 özgü bölümlerini içerir. Bu dosyalardaki işlevler app.js veya app-action-handler.js tarafından çağrılır. Veritabanı işlemleri 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ıyor.

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 depolamak ve işlevler arasında veri aktarmak için kullandığı sınıfların ve numaralandırmaların tanımlarını içerir. Firestore veritabanının veri modelini belirler.

views/*.js

Bu dizindeki her dosya, Chat uygulamasının ardından 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/ dizininde kartları oluşturmak için kullandığı bir tür widget nesnesi somutlaştırır.

test/**/*.test.js

Bu dizindeki 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 ç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 etkileşim etkinliği içeren bir Chat HTTP isteğine yanıt olarak çalışır. Çalıştırıldığında Cloud Functions işlevi 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 türde bir kullanıcı etkileşimi olarak oluşturur. Cloud Functions işlevi de varsa Firestore veritabanından okuma veya yazma işlemleri yapar.

Cloud Functions işlevini nasıl oluşturacağınız aşağıda açıklanmıştır:

Google Cloud Console

1. Kodu GitHub'dan bir zip dosyası olarak indirin.

   Zip dosyasını indirme

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

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

3. Çıkarılan klasörde google-chat-samples-main/node/project-management-app/ hedefine gidin ve ardından project-management-app klasörünü bir zip dosyasında sıkıştırın.

   Zip dosyasının kök dizini şu 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 konsolunda Cloud Functions sayfasına gidin:

   Cloud Functions'a gidin

   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'da 2. nesil'i seçin.
   2. İşlev adı alanına project-management-tutorial girin.
   3. Bölge'de bir bölge seçin.
   4. Kimlik Doğrulama altında, 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 değerini girin.

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

10. Hedef paket bölümünde bir paket oluşturun veya seçin:

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

    Google Cloud, zip dosyasını yükler ve bu paketteki bileşen dosyalarını çıkarır. Cloud Functions daha sonra bileşen dosyalarını Cloud Functions işlevine kopyalar.

11. GitHub'dan indirdiğiniz, çıkarttığınız ve yeniden sıkıştırdığınız zip dosyasını Zip dosyası'na yükleyin:

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

12. Deploy'u (Dağıt) tıklayın.

    Cloud Functions ayrıntıları sayfası açılır ve işleviniz, biri derleme, diğeri hizmet için olmak üzere iki ilerleme durumu göstergesiyle birlikte görüntülenir. Her iki ilerleme göstergesi de kaybolup onay işaretiyle değiştirildiğinde, işleviniz dağıtılmış ve hazır hale gelir.

13. Örnek kodu sabit değerler belirleyecek şekilde düzenleyin:

    1. Cloud Functions işlevi 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 kısmını Cloud projesi kimliğinizle değiştirin.
    6. İsteğe bağlı: Cloud Functions işleviniz için us-central1 öğesini desteklenen bir konumla güncelleyin.

14. Deploy'u (Dağıt) tıklayın.

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

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

gcloud CLI

1. GitHub'daki kodu klonlayın:

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

2. Bu 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 girin.

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 us-central1 gibi altyapısının barındırıldığı bir Cloud Functions konumu ile değiştirin.

1. İşlevin dağıtımı tamamlandığında, yanıttaki 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'sidir.

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

Bu bölümde; Chat uygulamasının adı, desteklenen eğik çizgi komutları ve Chat etkileşim etkinliklerini gönderdiği Chat uygulamasının Cloud Functions işlevinin tetikleyici URL'si de dahil olmak üzere Chat uygulamanızla ilgili bilgilerle Google Cloud Console'da Chat API'yi nasıl yapılandıracağınız 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 git

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 düğmesini açık konuma getirin.

6. İşlevler bölümünde Bire bir mesaj al, Alanlara ve grup görüşmelerine katıl'ı seçin.

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

8. Uygulama 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 olarak biçimlendirilmiş olarak yapıştırın. Cloud Functions işlevini gcloud KSA ile dağıttıysanız bu url özelliğidir.

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 ve Açıklama bilgilerini girip eğik çizgi komutunun İletişim kutusu açar'ı seçip Bitti'yi tıklayın:

      Ad	Komut Kimliği	Açıklama	İletiş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 haberleri listeler.	Seçili değil
      /userStory	3	Belirtilen hikayenin mevcut durumunu görüntüler.	Seçili değil
      /manageUserStories	4	Hikayelerin düzenlenebildiği bir iletişim kutusu açar.	Seçili
      /cleanupUserStories	5	Alandaki tüm haberler silinir.	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 tarafından kullanılabilir yap'ı seçip e-posta adresinizi girin.

11. İsterseniz Günlükler bölümünde Hataları Logging'e kaydet'i seçin.

12. Kaydet'i tıklayın. Yapılandırmanın kaydedildiği bir mesaj görünür. Bu, Chat uygulamasının teste hazır olduğu anlamına gelir.

Chat uygulamasını test etme

Mesaj gönderip kullanıcı hikayelerini oluşturmak, düzenlemek ve silmek için eğik çizgi komutlarını kullanarak proje yönetimi Chat uygulamasını 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 kişi ekle alanına Chat uygulamanızın adını yazın.

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

   Not: Sonuçlar listesinde Chat uygulamanızı görmüyorsanız Google Workspace hesabınızı Google Cloud Console'da, Chat API Yapılandırması sayfasının Görünürlük ayarlarına eklediğinizden emin olun.
5. Uygulamayla olan yeni doğrudan mesajda Hello yazıp enter tuşlarına 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ın ve mesajı gönderin. Proje yönetimi Chat uygulaması, Vertex AI'ın üretken yapay zekasını kullanarak sizin için oluşturduğu kullanıcı hikayesinin ayrıntılarını açıklayan bir kart mesajıyla yanıt verir.

7. Konsolda, Chat uygulamasını eklediğiniz alan, bu uygulamayla etkileşimde bulunan kullanıcılar ve oluşturduğunuz kullanıcı hikayesi ile ilgili olarak oluşturduğu kayıtları incelemek için Firestore veritabanını kontrol edin.

   Firestore'a git

8. Google Chat'e 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. Görmek için / yazın veya Chat uygulamasından bahsedin.
11. /cleanupUserStories eğik çizgi komutu vererek test kullanıcı hikayesini silin. Alternatif olarak, uygulamayı kaldırın veya kaldırın. Uygulama kaldırıldığında, uygulama bu 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 sorun oluştu." veya "İsteğiniz işleme alınamıyor" 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ük kaydı etkinken hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri mevcuttur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme 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: Projeyi silmenin etkileri aşağıdaki gibidir:

• Projedeki her şey silinir. Bu eğitim için mevcut bir projeyi kullandıysanız bu projeyi sildiğinizde projede yaptığınız diğer tüm çalışmaları da silmiş olursunuz.
• Özel proje kimlikleri kaybolur. Bu projeyi oluşturduğunuzda, ileride 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 projenin içindeki seçili kaynakları silin.

Birden fazla eğiticiyi ve hızlı başlangıç kılavuzunu incelemeyi planlıyorsanız projeleri yeniden kullanmak, proje kota sınırlarını aşmanızı önlemeye yardımcı olabilir.

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

   Resource Manager'a git

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

İlgili konular

• Gemini AI Chat uygulamasıyla yapılan Chat görüşmelerine dayalı soruları yanıtlama
• Google Chat, Vertex AI ve Apps Komut Dosyası ile olaylara yanıt verme