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 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ır ve ardından hikayeyi alanda paylaşır. -
Ş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
- 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 amacıyla Faturalandırmayı etkinleştirmek için gereken izinler bölümüne bakın.
Kimliği doğrulanmamış Google Cloud Functions işlevi çağrılarını kullanın. Bu çağrıları, Google Cloud kuruluşunuzun alanla kısıtlı paylaşım kullanıp kullanmadığını belirleyerek 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.
- Bir Firestore veritabanına yazarak ve veritabanından okuyarak işinizle ilgili güncel bilgileri takip edin.
- 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 alanları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ını ve açıklamalarını 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: Sunucu 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ıza olanak tanıyan basit, sunucusuz bir 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 ve bu etkinlikleri işleyen ve bunlara yanıt veren bir mantık çalıştırmak amacıyla işlem platformu olarak Cloud Functions'ı 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, teslim 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 ortamdır.
Mimari
Proje yönetimi Google Chat uygulama mimarisi, Chat etkileşim etkinliklerini bir HTTP uç noktasında 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ı 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:
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.
Chat, Cloud Functions'in HTTP uç noktasına senkronize bir HTTP isteği gönderir.
Proje yönetimi Google Chat uygulaması, HTTP isteğini işler:
Vertex AI, kullanıcı hikayesi yazmanıza veya güncellemenize yardımcı olur.
Firestore veritabanı, kullanıcı hikayesi verilerini depolar, alır, günceller veya siler.
Cloud Functions, Chat'e HTTP yanıtı döndürür. Bu yanıt, yanıtı kullanıcıya bir 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 konsolu
- Google Cloud Console'da Menü > IAM ve Yönetici > Proje Oluştur'a gidin.
-
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 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.
- Projeniz için olası konumları görüntülemek üzere Konum alanında Göz at'ı tıklayın. Ardından Seç'i tıklayın.
- 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'ı yükleyin ve başlatın.
Cloud projesi oluşturmak içingcloud projects create
komutunu kullanın: Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID değerini değiştirin.gcloud projects create PROJECT_ID
Cloud projesi için faturalandırmayı etkinleştirme
Google Cloud konsolu
- Google Cloud konsolunda Faturalandırma'ya gidin. Menü > Faturalandırma > Projelerim'i tıklayın.
- Kuruluş seçin bölümünde, Google Cloud projenizle ilişkili kuruluşu seçin.
- 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.
- Hesap belirle'yi tıklayın.
gcloud CLI
- Mevcut faturalandırma hesaplarını listelemek için şu komutu çalıştırın:
gcloud billing accounts list
- 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
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 doğru Cloud projesinde etkinleştirdiğinizi onaylayın ve ardından Sonraki'yi tıklayın.
Doğru API'leri etkinleştirdiğinizden emin olduktan sonra Etkinleştir'i tıklayın.
gcloud CLI
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.
gcloud services enable
komutuyla Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API ve Cloud Run Admin API'yi etkinleştirin:gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ run.googleapis.com
Cloud Build, Pub/Sub ve Cloud Run 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ğiticide, Firestore ve Vertex AI API'lerini çağırmak için Cloud Functions işlevine eklenmiş varsayılan hizmet hesabı ile birlikte Uygulama Varsayılan Kimlik Bilgileri kullanılı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şturulduğuna ve yapılandırıldığına göre Google Chat uygulamasını derleyip dağıtmaya hazırsınız. Bu bölümde aşağıdakileri yapacaksınız:
- Kullanıcı hikayelerini kalıcı olarak saklayıp alabileceğiniz bir Firestore veritabanı oluşturun.
- İsteğe bağlı olarak örnek kodu inceleyin.
- Chat'ten alınan etkinliklere yanıt olarak HTTP istekleri olarak Chat uygulamasının kodunu barındırmak ve çalıştırmak için bir Cloud Functions işlevi oluşturun.
- 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ı, Firestore veri modeli başlıklı makaleyi inceleyin.
koleksiyonlar halinde düzenlenmiş belgelerine dayalı bir NoSQL veri modeli kullanır. Daha fazla bilgi içinAşağıdaki şemada, proje yönetimi Google Chat uygulamasının veri modeline genel bir bakış sunulmaktadır:
Kök koleksiyon spaces
'tür. 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 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 Hikayeler'in 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 ( 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 belgesinin Document ID özelliğine 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 tamamlanması gereken aciliyet derecesi. Olası değerler Low , Medium veya High 'dir. |
size | Enum İş miktarı. Olası değerler: Small , Medium veya Large . |
status | Enum Çalışma aşaması. Olası değerler OPEN , STARTED veya COMPLETED 'dir. |
title | String Hikayenin başlığı; kısa bir özet. |
users
Hikaye oluşturan veya hikaye atanan kullanıcılar.
Alanlar | |
---|---|
Document ID | String Belirli bir kullanıcının benzersiz kimliği. Firebase'deki userStories öğesinin assignee ile ve Chat API'deki kullanıcının kaynak adıyla 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 konsolu
Google Cloud Console'da Firestore'a gidin. Menü > Firestore'u tıklayın.
Create database'i (Veritabanı oluştur) tıklayın.
Firestore modunuzu seçin bölümünde Yerel mod'u tıklayın.
Devam'ı tıklayın.
Veritabanını yapılandırın:
Veritabanınızı adlandırın bölümünde Veritabanı Kimliği'ni
(default)
olarak bırakın.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ın bir konum seçin.
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 birkaç dakikanızı ayırarak GitHub'da barındırılan örnek kodu inceleyin ve bu kod hakkında bilgi edinin.
Aşağıda, her bir dosyaya ilişkin genel bakış 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
vepackage-lock.json
- Node.js proje ayarları ve bağımlılıkları.
index.js
- Chat uygulamasının Cloud Functions işlevi için giriş noktası. HTTP isteğinden Chat 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ında bahsetme 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şleyen uygulama mantığıChat etkileşim etkinlikleri.
services/space-service.js
,services/user-service.js
veservices/user-story-service.js
- Bu dosyalarda; uygulama mantığının Chat alanları, kullanıcılar ve kullanıcı hikayeleriyle çalışmaya özgü bölümleri bulunur. Bu dosyalardaki işlevler
app.js
veyaapp-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
veservices/user-story-service.js
tarafından çağrılır. services/aip-service.js
- Üretken yapay zeka metin tahmini için Vertex AI API'yi çağırır.
model/*.js
- Bu dosyalar, uygulama hizmetlerinin verileri 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 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
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
GitHub'daki kodu zip dosyası olarak indirin.
İndirilen ZIP dosyasını ayıklayın.
Çıkarılan klasör, Google Workspace örnekleri deposunun tamamını içerir.
Çıkarılan klasörde
google-chat-samples-main/node/project-management-app/
konumuna gidin veproject-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/
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanız için Google Cloud projesinin seçildiğinden emin olun.
İşlev Oluştur'u tıklayın.
İşlev oluştur sayfasında işlevinizi ayarlayın:
- Ortam bölümünde Cloud Run İşlevi'ni seçin.
- İşlev adı alanına
project-management-tutorial
yazın. - Bölge'den bir bölge seçin.
- Kimlik Doğrulama altında, Kimliği doğrulanmayan çağrılara izin ver'i seçin.
- İleri'yi tıklayın.
Çalışma zamanı bölümünde Node.js 20'yi seçin.
Giriş noktası alanında varsayılan metni silin ve
projectManagementChatApp
yazın.Kaynak kodu bölümünde Posta yüklemesi'ni seçin.
Hedef paket'te bir paket create veya seçin:
- Göz at'ı tıklayın.
- Bir paket seçin.
- Seç'i tıklayın.
Google Cloud, zip dosyasını yükler ve bu paketteki bileşen dosyalarını çıkarır. Ardından Cloud Functions, bileşen dosyalarını Cloud Functions'a kopyalar.
Zip dosyası alanına, GitHub'dan indirdiğiniz, ayıklayıp yeniden sıkıştırdığınız zip dosyasını yükleyin:
- Göz at'ı tıklayın.
- ZIP dosyasına gidin ve seçin.
- Aç'ı tıklayın.
Dağıt'ı tıklayın.
Cloud Functions ayrıntı sayfası açılır ve işlevinizde biri derleme, diğeri hizmet için olmak üzere iki ilerleme göstergesi gösterilir. 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.
Sabitler ayarlamak için örnek kodu düzenleyin:
- Cloud Function ayrıntıları sayfasında Düzenle'yi tıklayın.
- İleri'yi tıklayın.
- Kaynak kod bölümünde Satır içi düzenleyici'yi seçin.
- Satır içi düzenleyicide
env.js
dosyasını açın. - project-id kısmını Cloud proje kimliğinizle değiştirin.
- İsteğe bağlı: us-central1 değerini, Cloud Functions işleviniz için desteklenen bir konum ile güncelleyin.
Dağıt'ı tıklayın.
İşlevin dağıtılmasını tamamladıktan sonra tetikleyici URL'sini kopyalayın:
- İşlev ayrıntıları sayfasında Tetikleyici'yi tıklayın.
- 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
GitHub'dan kodu kopyalayın:
git clone https://github.com/googleworkspace/google-chat-samples.git
Şu proje yönetimi Chat uygulamasının kodunun bulunduğu dizine geçin:
cd google-chat-samples/node/project-management-app
Ortam değişkenlerini ayarlamak için
env.js
dosyasını düzenleyin:- project-id kısmını Google Cloud proje kimliğinizle değiştirin.
- us-central1 yerine Google Cloud projenizin konumunu yazın.
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, altyapısının barındırıldığı Cloud Functions konumunu (ör.
us-central1
) girin.
- İşlev dağıtımı tamamlandığında yanıttan
url
özelliğini kopyalayın. Bu, Google Chat uygulamasını yapılandırmak için aşağıdaki bölümde kullanacağınız Tetikleyici URL'sidir.
Google Cloud Console'da Google Chat uygulamasını yapılandırma
Bu bölümde, Chat uygulamanızın adı, desteklenen eğik çizgi komutları ve Chat uygulamasının Chat etkileşim etkinliklerini gönderdiği Cloud Functions işlevinin tetikleyici URL'si gibi Chat uygulamanızla ilgili bilgilerle Google Cloud Console'da Chat API'yi nasıl yapılandıracağınız gösterilmektedir.
Google Cloud konsolunda Menü > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma'yı tıklayın.
Uygulama adı alanına
Project Manager
yazın.Avatar URL'si alanına
https://developers.google.com/chat/images/quickstart-app-avatar.png
yazın.Açıklama alanına
Manages projects with user stories.
yazın.Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini açık konuma getirin.
İşlevler bölümünde, Bire bir mesaj al, Alanlara ve grup görüşmelerine katıl'ı seçin.
Bağlantı ayarları altında HTTP uç nokta URL'si seçeneğini belirleyin.
HTTP uç nokta URL'si alanına, Cloud Functions dağıtımından kopyaladığınız
https://
REGION-
PROJECT_ID.cloudfunctions.net/project-management-tutorial
biçimindeki tetikleyici URL'sini yapıştırın. Cloud Functions işlevini gcloud KSA ile dağıttıysanız bu,url
özelliğidir.Chat uygulamasının eğik çizgi komutlarını kaydedin. Eğik çizgi komutu kaydetmek için:
- Eğik çizgi komutları bölümünde Eğik çizgi komutu ekle'yi tıklayın.
Aşağıdaki tabloda ayrıntılı olarak açıklanan her eğik çizgi komutu için Ad, Komut Kimliği, Açıklama bilgilerini girin ve eğik çizgi komutunun İletişim kutusu açıp açmayacağını seçip Bitti'yi tıklayın:
Ad Komut kimliği Açıklama Bir iletiş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 hikayeleri 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
Görünürlük bölümünde, Bu Chat uygulamasını Workspace alanınızdaki belirli kişilere ve gruplara sun'u seçin ve e-posta adresinizi girin.
İsteğe bağlı olarak Günlükler bölümünde Günlüğe hata kaydet'i seçin.
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.
Kendinizi güvenilir test kullanıcısı olarak eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.
- Yeni sohbet'i tıklayın.
- 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.
Sonuçlardan Chat uygulamanızı seçin. Bir doğrudan mesaj açılır.
- Uygulamayı içeren yeni doğrudan mesajda
Hello
yazıpenter
tuşuna basın. Proje yönetimi Chat uygulaması, yapabileceklerini ayrıntılı olarak açıklayan bir yardım menüsüyle yanıt verir. - 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 zeka teknolojisini kullanarak sizin için oluşturduğu kullanıcı hikayesini ayrıntılı şekilde açıklayan bir kart mesajıyla yanıt verir. Chat uygulamasını eklediğiniz alan, uygulamayla etkileşime giren kullanıcılar ve oluşturduğunuz kullanıcı hikayesiyle ilgili oluşturulan kayıtları incelemek için konsolda Firestore veritabanını kontrol edin.
Google Chat'e geri dönün.
- İsteğe bağlı olarak hikayeyi düzenlemek için Düzenle'yi tıklayın. Hikayeden memnun kaldığınızda Kaydet'i tıklayın.
- Uygulama tarafından desteklenen her eğik çizgi komutunu test edin. Bunları görmek için
/
yazın veya Chat uygulamasından bahsedin. /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
Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir sorun 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.
- Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.
- Proje listesinde, silmek istediğiniz projeyi seçin ve ardından Sil'i tıklayın.
- İletişim kutusuna proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.
İ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