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.

Ö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 iznidir.

• 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 verileri.

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 menu > 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.
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

Google Cloud Console

1. Google Cloud konsolunda Faturalandırma'ya gidin. Sonraki slayta geçin Menü menu > 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 (more_vert), 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

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 class doküman organize edilen collections_bookmark 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.

Firestore veritabanını aşağıdaki gibi oluşturabilirsiniz:

Ö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ölgesi. 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:

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. menu > 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. add 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.

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.

1. Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Sonraki slayta geçin Menü menu > 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: delete.
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