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

Bu eğitimde, ekiplerin kullanabileceği bir Google Chat uygulamasının nasıl geliştirileceği gösterilmektedir yönetmek için kullanabileceğiniz bir araçtır. Chat uygulaması Vertex AI, ekiplerin kullanıcı hikayeleri (bir ürünün özelliklerini temsil eden) kullanıcı bakış açısından değerlendirerek bir yazılım sistemi) hikayeleri bir Firestore veritabanında saklamaktadır.

• 

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

• .
  Şekil 2. Charlie, /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, hikayenin ayrıntılarını son haline getirmek için Düzenle'yi tıklıyor. Yapay zeka açıklaması doğru ancak Charlie daha fazla ayrıntı istiyor. Bu nedenle Charlie, Vertex AI'ın hikaye açıklamasına şartları eklemesini sağlamak için Genişlet'i tıklıyor. Charlie hikayeyi kendisine atıyor, durumu başladı olarak ayarlıyor, uygun bir öncelik ve boyut seçiyor, ardından Kaydet'i tıklıyor.
• .
  Şekil 5. Charlie, /manageUserStories eğik çizgi komutuyla ekibin tüm kullanıcı hikayelerini istediği zaman görebilir ve yönetebilir.

Ön koşullar

• İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.

• 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. Alıcı: olup olmadığını öğrenmek için Faturalandırmayı etkinleştirmek için gereken izinler.

  • Kimliği doğrulanmamış Google Cloud Functions işlevi çağrılarını Bunu doğrulamak için Google Cloud Kuruluş alanla kısıtlı paylaşım kullanıyorsa.

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

• Google Cloud KSA kullanıyorsanız bir Node.js ve gcloud KSA ile çalışacak şekilde yapılandırılmış geliştirme ortamına sahiptir. Görüntüleyin Node.js geliştirmesini ayarlama ortam.

Hedefler

• Çevik yazılımları yöneten bir Chat uygulaması derleme bilgi edinmenizi sağlar.
• Kullanıcıların üretken yapay zekayla kullanıcı hikayeleri yazmalarına yardımcı olun Vertex AI'ın sunduğu yapay zeka destekli hikaye yazma araçları:
  • Hikaye açıklamalarını oluşturup yeniden üretin.
  • Şartları tamamlamak için notlardan hikaye açıklamalarını genişletin.
  • Yazım hatalarını düzeltmek için dil bilgisini düzeltin.
• Bir Firestore veritabanına yazarak ve veritabanından okuyarak işinizle ilgili güncel bilgileri takip edin.
• Kullanıcıların Chat alanlarında ortak çalışmayı kolaylaştırma doğrudan görüşmeden hikaye oluşturabilir, düzenleyebilir, atayabilir ve başlatabilirsiniz.

Kullanılan ürünler

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

• Chat API: Mesaj alan ve yanıt veren Google Chat uygulamaları geliştirmek için bir API Mesajlar gibi sohbet etkileşimi etkinlikleri. Proje yönetimi Google Chat uygulaması, mesajlara yanıt vermek için Chat API'yi kullanır yapılandırma özelliklerini kullandığınızdan emin olun. Chat'te nasıl görüneceğini (ör. ad ve avatar resmi) belirler.
• Vertex AI API: Üretken yapay zeka platformu. Proje yönetimi Google Chat uygulaması, kullanıcı hikayesi yazmak için Vertex AI API'yi kullanır başlıklar ve açıklamalar.
• Firestore: Sunucusuz belge veritabanı. Proje yönetimi Google Chat uygulaması, kullanıcı hikayeleriyle ilgili verileri depolamak için Firebase'i kullanır.

• Cloud Functions: Basit bir sunucusuz bilgi işlem hizmeti ile Chat'e yanıt verebilen tek amaçlı, bağımsız işlevler bir sunucu veya çalışma zamanı ortamını yönetmeye gerek kalmadan etkileşim etkinlikleri İlgili içeriği oluşturmak için kullanılan Google Chat uygulaması, şu işlemler için Cloud Functions'ı kullanır: Chat'in etkileşim etkinliklerini gönderdiği HTTP uç noktasını barındırır. bu etkinlikleri işleyen ve bunlara yanıt veren bir mantık çalıştırmak için işlem platformuna gidin.

  Cloud Functions, derleme için aşağıdaki Google Cloud ürünlerini kullanır: etkileşim etkinliklerini işleme alabilir ve işlem kaynaklarını barındırabilirsiniz:

  • Cloud Build: Tümüyle yönetilen sürekli entegrasyon, teslim ve dağıtım platformu geliştirmenizi sağlar.
  • Pub/Sub: Hizmetleri ayıran eşzamansız ve ölçeklenebilir bir mesajlaşma hizmeti bu iletileri işleyen hizmetlerden mesajlar oluşturan siteler bulunur.
  • 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ının mimarisiyle ilgili bildirimler Chat etkileşimi etkinliklerini bir HTTP uç noktasında işler, yardımcı olmak için Vertex AI'ı kullanıcı hikayeleri yazabilir ve kullanıcı hikayesi ayrıntılarını Firestore veritabanında saklar. İlgili içeriği oluşturmak için kullanılan aşağıdaki şemada Google Workspace ve Google Workspace 360'ın Kullanılan Google Cloud kaynakları.

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

1. Bir kullanıcı Chat'te bir mesaj gönderir ve Google Chat üzerinden bir projeyi yönetmek için veya eğik çizgi komutu girerek erişebilirsiniz.

2. Chat, Cloud Functions işlevine eş zamanlı bir HTTP isteği gönderir. HTTP uç noktası.

3. Proje yönetimindeki Google Chat uygulaması, istek:

   1. Vertex AI, kullanıcı hikayesini yazmanıza veya güncellemenize yardımcı olur.

   2. Firestore veritabanı, kullanıcı hikayesini saklar, alır, günceller veya siler dışı verilerdir.

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

Ortamı hazırlama

Bu bölümde, web sitesi için Google Cloud projesinin nasıl Chat uygulaması.

Google Cloud projesi oluşturma

Google Cloud Console

1. Google Cloud konsolunda Menü'ye gidin > IAM ve Yönetici > Proje oluşturun'u tıklayın.

   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ği'ni düzenlemek için Düzenle'yi tıklayın. Proje kimliği değiştirilemez Bu nedenle, ilk deneme süresi boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin. belirler.

3. Konum alanında, işletmenizin olası konumlarını görüntülemek için Göz at'ı tıklayın belirler. 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. Bazı özellikler Google Workspace geliştirici belgelerinde açıklanan özelliklere yalnızca bir kuruluşla ilişkilendirilebilir.
4. Oluştur'u tıklayın. Google Cloud Console, Kontrol Paneli sayfasına gider ve projeniz oluşturulur birkaç dakika.

gcloud CLI

Aşağıdaki geliştirme ortamlarından birinde Google Cloud KSA (`gcloud`):

• Cloud Shell: gcloud CLI ile online terminal kullanmak için Cloud Shell'i etkinleştirin.
  . Cloud Shell'i etkinleştir
• Yerel Kabuk: Yerel geliştirme ortamı kullanmak için yükle ve başlatmak öğrenin.
  . Bir 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ştirin

Bir faturalandırma hesabını bağlayamazsanız Bu değişikliği yapmak için gereken izinler. Daha fazla bilgi için bkz. Faturalandırmayı etkinleştirmek için gereken izinler.

Google Cloud Console

1. Google Cloud konsolunda Faturalandırma'ya gidin. Sonraki slayta geçin Menü > Faturalandırma > Projelerim'i tıklayın.

   Projelerim İçin Faturalandırma'ya gidin

2. Bir kuruluş seçin bölümünde, ilişkili kuruluşu seçin Google Cloud projenize ekleyin.
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 şu öğenin Proje Kimliğidir: Faturalandırmayı etkinleştirmek istediğiniz bulut projesi.
   • BILLING_ACCOUNT_ID, bağlanacak faturalandırma hesabı kimliğidir. Google Cloud projesinden bahsedeceğiz.

API'leri etkinleştirme

Google Cloud Console

1. Google Cloud konsolunda Google Chat API'yi, Vertex AI API'yi, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API ve Cloud Run Admin API.

   API'leri etkinleştirme

2. API'leri doğru şekilde etkinleştirdiğinizden emin olun. Cloud projesine, ardından İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizden emin olun ve ardından Etkinleştir'i tıklayın.

gcloud CLI

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

   gcloud config set project PROJECT_ID
   

   PROJECT_ID değerini projenin Proje Kimliği ile değiştirin Oluşturduğunuz Cloud projesi.

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

   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.

Kimlik doğrulama ve yetkilendirme

Bu işlem için kimlik doğrulama ve yetkilendirme yapılandırması gerekmez eğiticidir.

Bu eğiticide, Firestore ve Vertex AI API'lerini çağırmak için Uygulama Varsayılan Kimlik Bilgileri Cloud Functions işlevine eklenmiş olan varsayılan hizmet hesabını gerekmez. Üretim ortamı bağlamında normal oluştur ve ekle Cloud Functions işlevine bir hizmet hesabını bağlayabilirsiniz.

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

Google Cloud projeniz oluşturulduğuna ve yapılandırıldığına göre artık derleme ve Google Chat uygulamasını dağıtabilirsiniz. Bu bölümde takip etmek için:

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 etkinliklere yanıt olarak aldığı kod HTTP istekleri olarak alınır.
4. Google Chat API'de Google Chat uygulaması oluşturma ve dağıtma yapılandırma sayfası.

Firestore veritabanını oluşturma

Bu bölümde, kalıcı hale getirmek ve almak için bir Firestore veritabanı oluşturacaksınız veri modelini tanımlamamış olursunuz. Veri modeli ayarlandı model/user-story.js ve model/user.js tarafından örnek kodda dolaylı olarak dosyası olarak da kaydedebilir.

Proje yönetimi Chat uygulaması veritabanı, NoSQL kullanır modele göre doküman organize edilen koleksiyonlar. Daha fazla bilgi edinmek için bkz. Firestore veri modeli.

Aşağıdaki diyagramda proje yönetimine genel bir bakış Google Chat uygulamasının veri modeli:

Kök koleksiyonu spaces şeklindedir. Burada her doküman Chat uygulaması hikaye oluşturdu. Her kullanıcı hikayesi userStories alt koleksiyonundaki bir dokümanla temsil edilir ve her kullanıcı 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ı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 ile karşılık gelir.
users	Subcollection of Documents (user) Hikaye oluşturan veya atanan kullanıcılar.
displayName	String Alanın Chat API'sinde 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 üzere atanan kullanıcının kaynak adı. users dokümanının Document ID bölümüne ve Chat API'deki kullanıcının kaynak adına karşılık gelir.
description	String Kullanıcının bakış açısından yazılım özelliğinin açıklaması.
priority	Enum İşin aciliyeti. Olası değerler: Low, Medium veya High.
size	Enum İş miktarı. Olası değerler: Small, Medium veya Large.
status	Enum Çalışma aşaması. Olası değerler: OPEN, STARTED veya COMPLETED.
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 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ı aşağıdaki gibi oluşturabilirsiniz:

Google Cloud Console

1. Google Cloud Console'da Firestore'a gidin. Sonraki slayta geçin 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ı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 bir bölge belirtin. Örneğin: us-central1. En iyi performans için aynı veya yakın bir konum seçin konumunu Chat uygulamasının Cloud Functions işlevi olarak kullanıyor.

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

gcloud CLI

• Native mode'da Firestore veritabanı oluşturmak için gcloud firestore databases create komutu:

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

  LOCATION öğesini bir Firestore adıyla değiştirin bölgesi, örneğin us-central1 olarak

Örnek kodu inceleme

İsteğe bağlı olarak, Cloud Functions işlevini oluşturmadan önce bir dakikanızı ayırıp GitHub'da barındırılan örnek kodla ilgili bilgi edinin.

GitHub'da göster

Aşağıda, her bir dosyaya ilişkin genel bakış bulabilirsiniz:

env.js

Dağıtılacak ortam yapılandırması değişkenleri Chat uygulamasından belirli bir Google Cloud projesine bölge. 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ı. Google CANNOT TRANSLATE Şu kullanıcıdan sohbet etkinliği: uygulama işleyiciyi çağırır ve HTTP yanıtını bir JSON nesnesi.

controllers/app.js

Ana uygulama mantığı. Şunu işler: etkileşim etkinliklerini Chat uygulamasında bahsedilen ifadeler ve eğik çizgi komutları. 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şlemeye yönelik uygulama mantığı Sohbet etkileşimi etkinlikleri.

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

Bu dosyalar, Chat alanlarıyla çalışmaya özel uygulama mantığı ve kullanıcı hikayeleri konuştuk. Bu dosyalardaki işlevler app.js tarafından çağrılıyor veya app-action-handler.js. Veritabanı işlemlerini gerçekleştirmek için bu dosyalar, firestore-service.js içindeki işlevleri çağırıyor.

services/firestore-service.js

Veritabanı işlemlerini yönetir. Bu dosyadaki fonksiyonlar services/space-service.js, services/user-service.js ve services/user-story-service.js.

services/aip-service.js

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

model/*.js

Bu dosyalar, uygulamanın ve işlevler arasında veri depolamak ve aktarmak için kullanılan hizmetler de dahildir. Bu kişiler veri modelini kullanır.

views/*.js

Bu dizindeki her dosya örneklendirilir kullanıcının göreceği kart nesnesi Chat uygulaması, aşağıdaki bilgiler doğrultusunda Chat'e geri gönderir: bir kart mesajı ya da iletişim kutusu işlemi yanıtı.

views/widgets/*.js

Her dosya örneklendirilir bir widget türü uygulamanın views/ dizininde kartları oluşturmak için kullandığı nesnedir.

test/**/*.test.js

Bu dizindeki ve alt dizinlerindeki her dosya, birim testlerini içerir hizmet, görünüm veya widget için kullanabilirsiniz. içindeyken npm run test komutunu çalıştırarak tüm birim testlerini yürütebilirsiniz kök dizinine ekleyin.

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

Bu bölümde bir Cloud Functions işlevi oluşturup dağıtacaksınız. uygulama mantığını ele aldık.

Cloud Functions işlevi yanıt olarak çalışır Chat'ten, Chat içeren bir HTTP isteğine olabilir. Çalıştırıldığında Cloud Functions işlevi kodu etkinliği işler ve Chat'e, Chat tarafından oluşturulan bir yanıt döndürür. iletişim kutusunu veya diğer kullanıcı etkileşimi türlerini kapsar. Geçerli durumlarda, Cloud İşlev ayrıca Firestore veritabanından okuma veya bu veritabanına yazma işlemi yapar.

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

Google Cloud Console

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

   Zip dosyasını indirme

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

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

3. Çıkarılan klasörde şuna gidin: google-chat-samples-main/node/project-management-app/, ardından sıkıştırın project-management-app klasörünü zip dosyası olarak kaydedin.

   ZIP dosyasının kök dizini şunu içermelidir: dosyalar ve klasörler:

   • 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

   Google Cloud projesinin Chat uygulaması seçildi.

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

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

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

7. Çalışma zamanı'nda Node.js 20'yi seçin.

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

9. Kaynak kodu bölümünde Posta yüklemesi'ni seçin.

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

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

    Google Cloud, zip dosyasını yükleyip bileşen dosyalarını çıkarır bu pakette yer alıyor. Ardından Cloud Functions, bileşen dosyalarını Cloud Functions işlevi görür.

11. Zip dosyası olarak, GitHub'dan indirdiğiniz zip dosyasını yükleyin. çıkartıldı ve yeniden sıkıştırıldı:

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

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

    Cloud Functions ayrıntısı sayfası açılır ve işleviniz görüntülenir. Biri derleme, diğeri hizmet için olmak üzere iki ilerleme göstergesi. Her iki ilerleme göstergesi de kaybolduğunda ve bir onay işaretiyle değiştirildiğinde işareti koyun, fonksiyonunuz dağıtılmış ve hazır.

13. Sabit değerleri ayarlamak için örnek kodu 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ı: us-central1 öğesini desteklenen konum Cloud Functions işleviniz için kullanmaya devam edersiniz.

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

15. İşlevin dağıtılmasını tamamladıktan sonra tetikleyici URL'sini kopyalayın:

    1. İşlev ayrıntıları sayfasında Tetikleyici'yi tıklayın.
    2. URL'yi kopyalayın. Bu dosyayı, Chat uygulamasını açın.

gcloud CLI

1. GitHub'dan kodu klonlayın:

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

2. Bu projenin kodunu barındıran dizine geçin yönetim amaçlı Chat uygulaması:

   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 yerine şununla değiştirin: Cloud Functions işlevi konumu altyapının barındırıldığı yer (ör. us-central1).

1. İşlev dağıtılmasını tamamladığında url özelliğini tıklayın. Bu, aşağıdaki bölümde kullanacağınız tetikleyici URL'sidir. Google Chat uygulamasını yapılandırın.

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

Bu bölümde, Chat uygulamanızla ilgili bilgilerin bulunduğu Google Cloud Console, Chat uygulamasının adı, desteklenen eğik çizgi ve komutlarını ve Chat uygulamasının tetikleyici URL'sini Chat etkileşim etkinliklerini gönderdiği işlev.

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

   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 tıklayarak 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'dan kopyaladığınız tetikleyici URL'yi yapıştırın. Şu şekilde biçimlendirilmiş işlev dağıtımı: https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Cloud Functions işlevini gcloud KSA ile dağıttıysanız url

9. Chat uygulaması eğik çizgiyle başlayan komutlar. 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 verilen her eğik çizgi komutu için, Ad, Komut Kimliği, Açıklama bilgilerini girin ve İletişim kutusu açar eğik çizgi komutunu, ardından Bitti'yi tıklayın:

      Ad	Komut kimliği	Açıklama	İletişim kutusu açar
      /createUserStory	1	Belirtilen başlıkla 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	Haberlerin düzenlenebileceği bir iletişim kutusu açar.	Seçili
      /cleanupUserStories	5	Alandaki tüm yazıları siler.	Seçili değil

10. Görünürlük altında Bu Chat uygulamasını kuruluşunuzdaki belirli kişi ve grupların kullanımına sunun Workspace alanı'nı tıklayın 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. Yapılandırma tarafından kaydedilmiş bir mesaj görünür. Bu mesaj, Chat uygulaması hazır olduğunu göreceksiniz.

Chat uygulamasını test etme

Proje yönetimi Chat uygulamasını mesajlaşma yoluyla test etme ve kullanıcı hikayelerini oluşturmak, düzenlemek ve silmek için eğik çizgi komutlarını kullanmak.

1. Oluşturduğunuz Google Workspace hesabını kullanarak Google Chat'i açın ve kendinizi güvenilir test kullanıcısı olarak eklediğinizde sağlanan bir değerdir.

   Google Chat'e git

2. Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kişi ekle alanına eklemek istediğiniz kişinin adını Chat uygulaması.

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

   Not: emin olmak için, Google Workspace hesabınızı Chat API Yapılandırması'nın görünürlük ayarları sayfasını kontrol edin.
5. Uygulamayı içeren yeni doğrudan mesajda Hello yazın ve enter tuşuna basın. Proje yönetimi Chat uygulaması, ne olduğunu açıklayan bir yardım menüsüyle yapabiliyoruz.
6. Hikaye oluşturmak için/createUserStory Test story mesaj çubuğunu kullanın ve gönderin. Proje yönetimi Chat uygulaması, şu bilgileri içeren bir kart mesajıyla yanıt verir: Vertex AI'ın üretken yapay zeka teknolojisini kullanarak sizin için oluşturduğu kullanıcı hikayesine göz atın.

7. Konsolda Firestore veritabanını kontrol ederek eklediğiniz alanla ilgili olarak oluşturduğu kayıtlar etkileşime geçen kullanıcıları ve ve oluşturduğunuz kullanıcı hikayesi.

   Firestore'a git

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

   Google Chat'e git

9. İsterseniz hikayeyi düzenlemek için Düzenle'yi tıklayın. Projenizin hikayeyi paylaşmak için Kaydet'i tıklayın.
10. Uygulama tarafından desteklenen her eğik çizgi komutunu test edin. Bunları görmek için / veya Chat uygulamasından bahsedin.
11. /cleanupUserStories talimatını vererek test kullanıcısı hikayesini silin eğik çizgi komutu. Alternatif olarak: uygulamayı kaldırın veya kaldırın. Kaldırıldığında uygulama, bu alanda oluşturulan tüm kullanıcı hikayelerini siler.

Sorun giderme

Bir Google Chat uygulaması veya card bir hata döndürürse Chat arayüzünde "Bir sorun oluştu" mesajı gösteriliyor. veya "İsteğiniz işlenemiyor." Chat kullanıcı arayüzü herhangi bir hata mesajı görüntülenmiyor ancak Chat uygulaması veya kart beklenmeyen bir sonuç veriyorsa; Örneğin karttaki bir mesajda görünür.

Chat kullanıcı arayüzünde hata mesajı görüntülenmese de Hataları düzeltmenize yardımcı olmak için açıklayıcı hata mesajları ve günlük verileri sunulur Chat uygulamaları için hata günlük kaydı etkinleştirildiğinde. Görüntüleme konusunda yardım için ve hataları düzeltme ile ilgili daha fazla bilgi edinmek için Google Chat hatalarını giderme ve düzeltme

Temizleme

Aşağıdaki işlem için Google Cloud hesabınızdan ücret alınmasını önlemek amacıyla: kaynaklardan yararlanabilmeniz için Cloud projesi.

Dikkat: Proje silmenin aşağıdaki etkileri vardır:

• 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 çalışmaları da silmiş olursunuz.
• Ö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 proje içindeki seçili kaynakları silin.

Birden fazla eğiticiyi ve hızlı başlangıç kılavuzunu keşfetmeyi planlıyorsanız projeleri yeniden kullanarak proje kota sınırlarını aşmaktan kaçınabilirsiniz.

1. Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Sonraki slayta geçin Menü > IAM ve Yönetici > Kaynakları Yönetin.

   Resource Manager'a git 'nı inceleyin.

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

İlgili konular

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