Bu eğitimde, olaylara anında yanıt veren bir Google Chat uygulamasının nasıl oluşturulacağı gösterilmektedir. Uygulama bir olaya yanıt verirken Chat alanı oluşturup doldurur; mesajlar, eğik çizgi komutları ve iletişim kutularıyla olay çözümünü kolaylaştırır ve bir Google Dokümanlar dokümanında olay yanıtını özetlemek için yapay zekayı kullanır.
Olay, çözüm için bir ekip ekibinin hemen ilgilenmesini gerektiren bir olaydır. Olaylara örnek olarak aşağıdakiler verilebilir:
- Müşteri İlişkileri Yönetimi (CRM) platformunda zamana duyarlı bir destek kaydı oluşturulur ve hizmet ekibinin bir çözüm üzerinde birlikte çalışması gerekir.
- Bir sistem çevrimdışı olur ve bir grup site güvenilirliği mühendisini (SRE'ler) uyararak sistemi tekrar çevrimiçi hale getirmek için birlikte çalışabilirler.
- Şiddetli deprem meydana geldiğinden, acil durum çalışanlarının müdahalede koordinasyonu sağlamaları gerekiyor.
Bu eğiticinin amacı doğrultusunda, olay bir kullanıcı web sayfasından bir düğmeyi tıklayarak bildirdiğinde olay uyarısı başlar. Web sayfası kullanıcılardan temel olay bilgilerini girmelerini isteyerek bir olayı simüle eder: başlık, açıklama ve yanıt verenlerin e-posta adresleri.
Olay yönetimi Chat uygulamasının nasıl çalıştığını görün:
-
Şekil 2. Olay için Chat alanının oluşturulduğuna dair bildirim. -
Şekil 3. Olay yanıtı Chat alanı. -
Şekil 4. Olayı eğik çizgi komutuyla çözme. -
Şekil 5. Olay çözümü iletişim kutusu. -
Şekil 6. Olay çözümüne yönelik Google Dokümanlar dokümanı uzayda paylaşıldı. -
Şekil 7. Yapay zeka özeti olay çözümü Google Dokümanlar dokümanı.
Ön koşullar
Kuruluşunuzda aşağıdaki ön koşullardan herhangi birinin etkinleştirilmesi gerekiyorsa Google Workspace yöneticinizden bunları etkinleştirmesini isteyin:
- Google Chat'e erişimi olan bir Google Workspace hesabı.
- Google Workspace için Dizin'i (kişi paylaşımı) etkinleştirmek istiyorsanız. Olay uygulaması, olay yanıt verenlerinin ad ve e-posta adresi gibi iletişim bilgilerini aramak için dizini kullanır. Olaylara yanıt verenler, Google Workspace kuruluşunuzda Google Chat hesabı olan kullanıcılar olmalıdır.
Hedefler
- Olaylara yanıt veren bir Chat uygulaması oluşturun.
- Aşağıdakileri yaparak kullanıcıların olaylara yanıt vermesine yardımcı olun:
- Olay yanıt alanları oluşturuluyor.
- Olayları ve yanıtları özetleyen mesajlar yayınlama.
- Etkileşimli Chat uygulaması özellikleriyle iş birliğini destekleme.
- Vertex AI ile görüşmeleri ve çözümleri özetleyin.
Mimari
Aşağıdaki şemada, olay yanıtı Google Chat uygulaması tarafından kullanılan Google Workspace ve Google Cloud kaynaklarının mimarisi gösterilmektedir.
Bu mimari, olay yanıtı Google Chat uygulamasının olayları ve çözümleri nasıl işlediğini gösterir.
Bir kullanıcı, Apps Komut Dosyası'nda barındırılan harici bir web sitesinden olay başlatır.
Web sitesi, yine Apps Komut Dosyası'nda barındırılan Google Chat uygulamasına eşzamansız bir HTTP isteği gönderir.
Olay yanıtı Google Chat uygulaması isteği işler:
Apps Komut Dosyası Yönetici SDK'sı hizmeti, kullanıcı kimliği ve e-posta adresi gibi ekip üyesi bilgilerini alır.
Apps Komut Dosyası Gelişmiş Chat hizmetini kullanan Chat API'ye yapılan bir dizi HTTP isteğiyle, olay yanıtı Google Chat uygulaması bir olay Chat alanı oluşturur, bu alanı ekip üyeleriyle doldurur ve alana bir mesaj gönderir.
Ekip üyeleri Chat alanında olayı tartışır.
Bir ekip üyesi, olayın çözümünü işaret etmek için eğik çizgi komutu çağırır.
Apps Komut Dosyası'nı kullanan Chat API'ye yapılan bir HTTP çağrısı. Gelişmiş Chat hizmeti, Chat alanındaki tüm mesajları listeler.
Vertex AI, listelenen mesajları alır ve bir özet oluşturur.
Apps Komut Dosyası
DocumentApp
hizmeti, Dokümanlar dokümanı oluşturur ve Vertex AI'ın özetini dokümana ekler.Olay yanıtı Google Chat uygulaması, özet Dokümanlar dokümanının bağlantısını paylaşan bir mesaj göndermek için Chat API'yi çağırır.
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
- Google Cloud konsolunda 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 kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, projenin ömrü boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin.
- 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.
- 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
Cloud projesi için faturalandırmayı etkinleştirin
Google Cloud Console
- 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
- Kullanılabilir faturalandırma hesaplarını listelemek için şu komutu çalıştırın:
gcloud billing accounts list
- 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
Google Cloud konsolunda Google Chat API, Google Docs API, Admin SDK API ve Vertex AI API'yi etkinleştirin.
API'leri doğru Cloud projesinde etkinleştirdiğinizi onaylayın ve İleri'yi tıklayın.
Doğru API'leri etkinleştirmekte olduğunuzu onaylayın ve 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, Google Docs API, Admin SDK API ve Vertex AI API'yi etkinleştirin:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Kimlik doğrulama ve yetkilendirmeyi ayarlama
Kimlik doğrulama ve yetkilendirme, Chat uygulamasının bir olay yanıtını işlemek için Google Workspace ve Google Cloud'daki kaynaklara erişmesini sağlar.
Bu eğiticide, uygulamayı dahili olarak yayınlarsınız. Böylece yer tutucu bilgileri rahatça kullanılabilir. Uygulamayı harici olarak yayınlamadan önce yer tutucu bilgilerini izin ekranındaki gerçek bilgilerle değiştirin.
Google Cloud konsolunda Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.
Kullanıcı türü bölümünde, Dahili'yi seçin ve Oluştur'u tıklayın.
Uygulama adı alanına
Incident Management
yazın.Kullanıcı destek e-postası alanında e-posta adresinizi veya uygun bir Google grubunu seçin.
Geliştirici iletişim bilgileri altında e-posta adresinizi girin.
Kaydet ve Devam Et'i tıklayın.
Kapsam Ekle veya Kaldır'ı tıklayın. Cloud projenizde etkinleştirdiğiniz her API için kapsam listesinin bulunduğu bir panel görünür.
Aşağıdaki kapsamları Manuel olarak ekle bölümüne yapıştırın:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
Tabloya Ekle'yi tıklayın.
Güncelle'yi tıklayın.
Kaydet ve Devam Et'i tıklayın.
Uygulama kaydı özetini inceleyin, ardından Kontrol Paneline Dön'ü tıklayın.
Chat uygulamasını oluşturma ve dağıtma
Aşağıdaki bölümde, Chat uygulamanız için gerekli tüm uygulama kodunu içeren bir Apps Komut Dosyası projesinin tamamını kopyalayıp güncelleyeceksiniz. Böylece her dosyayı kopyalayıp yapıştırmanıza gerek yoktur.
Bazı işlevlerin adlarının sonuna alt çizgi eklenebilir (örneğin, ChatApp.gs
dilinden processSlashCommand_()
). Alt çizgi, tarayıcıda açık olduğunda işlevi olay başlatma web sayfasından gizler. Daha fazla bilgi edinmek için Gizli işlevler bölümünü inceleyin.
Apps Komut Dosyası, .gs
komut dosyaları ve .html
dosyaları olmak üzere iki dosya türünü destekler. Bu desteğe uymak için uygulamanın istemci taraflı JavaScript'i <script />
etiketlerinin ve CSS'si bir HTML dosyasındaki <style />
etiketlerinin içine eklenir.
İsteğe bağlı olarak projenin tamamını GitHub'da görüntüleyebilirsiniz.
Her bir dosyayla ilgili genel bakışı burada bulabilirsiniz:
Consts.gs
Cloud proje kimliğiniz, Vertex AI konum kimliğiniz ve bir olayı kapatmak için kullanılan eğik çizgi komut kimliği dahil olmak üzere diğer kod dosyalarının başvurduğu sabitleri tanımlar.
Consts.gs
kodunu gösterChatApp.gs
Mesajlar, kart tıklamaları, eğik çizgi komutları ve iletişim kutuları gibi Chat etkileşimi etkinliklerini işler. Olay çözümleme ayrıntılarını toplamaya yönelik bir iletişim kutusu açarak
/closeIncident
eğik çizgi komutuna yanıt verir. Chat API'despaces.messages.list
yöntemini çağırarak alandaki mesajları okur. Kullanıcı kimliklerini Apps Komut Dosyası'ndaki Admin SDK Directory hizmetini kullanarak alır.ChatApp.gs
kodunu gösterChatSpaceCreator.gs
Kullanıcıların olay başlatma web sayfasına girdiği form verilerini alır, bu verileri oluşturup doldurarak Chat alanı oluşturmak için kullanır ve ardından olay hakkında bir mesaj yayınlar.
ChatSpaceCreator.gs
kodunu gösterDocsApi.gs
Kullanıcının Google Drive'ında bir Google Dokümanlar dokümanı oluşturmak için Google Docs API'yi çağırır ve
VertexAiApi.gs
'da oluşturulan olay bilgilerinin özetini dokümana yazar.DocsApi.gs
kodunu gösterVertexAiApi.gs
Vertex AI kullanarak Chat alanındaki konuşmayı özetler. Bu özet,
DocsAPI.gs
konumunda özel olarak oluşturulmuş bir dokümanda yayınlanır.VertexAiApi.gs
kodunu gösterWebController.gs
Olay başlatma web sitesini yayınlar.
WebController.gs
kodunu gösterIndex.html
Olay başlatma web sitesini oluşturan HTML.
Index.html
kodunu gösterJavaScript.html
Olay başlatma web sitesi için gönderme, hata ve temizleme gibi form davranışlarını yönetir.
WebController.gs
içindeki özelinclude
işleviyleIndex.html
içine dahil edilir.JavaScript.html
kodunu gösterStylesheet.html
Olay başlatma web sitesinin CSS'si.
WebController.gs
içindeki özelinclude
işleviyleIndex.html
içine dahil edilir.Stylesheet.html
kodunu göster
Cloud proje numaranızı ve kimliğinizi bulma
Google Cloud konsolunda Cloud projenize gidin.
Ayarlar ve Yardımcı Programlar > Proje ayarları'nı tıklayın.
Proje numarası ve Proje kimliği alanlarındaki değerleri not edin. Bunları aşağıdaki bölümlerde kullanacaksınız.
Apps Komut Dosyası projesini oluşturma
Bir Apps Komut Dosyası projesi oluşturmak ve bu projeyi Cloud projenize bağlamak için:
- Google Chat ile olaylara yanıt verme Apps Komut Dosyası projesini açmak için aşağıdaki düğmeyi tıklayın.
Projeyi açın - Genel Bakış'ı tıklayın.
- Genel bakış sayfasında Kopya oluştur'u tıklayın.
Apps Komut Dosyası projesi kopyanızı adlandırın:
Google Chat ile olaylara yanıt verme kopyası'nı tıklayın.
Proje başlığı alanına
Incident Management Chat app
yazın.Yeniden adlandır'ı tıklayın.
Apps Komut Dosyası projesi kopyanızda,
Consts.gs
dosyasına gidin veYOUR_PROJECT_ID
yerine Cloud projenizin kimliğini girin.
Apps Komut Dosyası projesinin Cloud projesini ayarlayın
- Apps Komut Dosyası projenizde, Proje Ayarları'nı tıklayın.
- Google Cloud Platform (GCP) Project (Google Cloud Platform (GCP) Projesi) bölümünde Change project (Projeyi değiştir) seçeneğini tıklayın.
- GCP proje numarası alanına Cloud projenizin numarasını yapıştırın.
- Proje ayarla'yı tıklayın. Cloud projesi ile Apps Komut Dosyası projesi birbirine bağlandı.
Apps Komut Dosyası dağıtımı oluşturma
Artık tüm kodlar yerleştirildiğine göre, Apps Komut Dosyası projesini dağıtabilirsiniz. Google Cloud'da Chat uygulamasını yapılandırırken dağıtım kimliğini kullanırsınız.
Apps Komut Dosyası'nda olay yanıtı uygulamasının projesini açın.
Dağıt > Yeni dağıtım'ı tıklayın.
Eklenti ve Web uygulaması seçili değilse Tür seç'in yanında, dağıtım türlerini tıklayın ve Eklenti ile Web uygulaması'nı seçin.
Açıklama alanına bu sürüm için
Complete version of incident management app
gibi bir açıklama girin.Yürütme yöntemi bölümünde Web uygulamasına erişen kullanıcı'yı seçin
Erişimi olanlar bölümünde Workspace kuruluşunuzdaki herkes'i seçin. Burada "Workspace kuruluşunuz", Google Workspace kuruluşunuzun adıdır.
Deploy'u (Dağıt) tıklayın. Apps Komut Dosyası, dağıtımın başarılı olduğunu bildirir ve olay başlatma web sayfası için dağıtım kimliği ve URL sağlar.
Daha sonra bir olay başlattığınızda ziyaret edilecek Web uygulaması URL'sini not edin. Deployment ID'yi kopyalayın. Bu kimliği Google Cloud Console'da Chat uygulamasını yapılandırırken kullanırsınız.
Done'ı (Bitti) tıklayın.
Google Cloud Console'da Chat uygulamasını yapılandırma
Bu bölümde, Google Cloud Console'da Google Chat API'yi, Apps Komut Dosyası projenizden oluşturduğunuz dağıtımın kimliği de dahil olmak üzere Chat uygulamanızla ilgili bilgilerle nasıl yapılandıracağınız gösterilmektedir.
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.
Uygulama adı alanına
Incident Management
yazın.Avatar URL'si alanına
https://developers.google.com/chat/images/quickstart-app-avatar.png
yazın.Açıklama alanına
Responds to incidents.
yazın.Etkileşimli özellikleri etkinleştir 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ı bölümünde Apps Komut Dosyası projesi'ni seçin.
Daha önce Apps Komut Dosyası proje dağıtımından kopyaladığınız Apps Komut Dosyası Dağıtım Kimliği'ni Dağıtım Kimliği alanına yapıştırın.
Tamamen uygulanmış Chat uygulamasının kullandığı bir eğik çizgi komutu kaydedin:
Eğik çizgi komutları altında, Eğik çizgi komutu ekle'yi tıklayın.
Ad alanına
/closeIncident
yazın.Komut Kimliği'ne
1
yazın.Açıklama alanına
Closes the incident being discussed in the space.
yazın.İletişim kutusu açar'ı seçin.
Done'ı (Bitti) tıklayın. Eğik çizgi komutu kaydedilir ve listelenir.
Görünürlük bölümünde Bu Chat uygulamasını Workspace Alanınızdaki belirli kişi ve gruplar için kullanılabilir hale getirin'i seçin ve e-posta adresinizi girin.
Günlükler bölümünde Hataları Logging'e kaydet'i seçin.
Kaydet'i tıklayın. Uygulamanın test edilmeye hazır olduğunu belirten bir yapılandırma kaydedildi mesajı görüntülenir.
Chat uygulamasını test etme
Olay yönetimi Chat uygulamasını test etmek için web sayfasından bir olay başlatın ve Chat uygulamasının beklendiği gibi çalıştığını doğrulayın:
Apps Komut Dosyası dağıtımı web uygulaması URL'sine gidin.
Apps Komut Dosyası, verilerinize erişmek için izin istediğinde İzinleri incele'yi tıklayın, Google Workspace alanınızda uygun bir Google Hesabı ile oturum açın ve İzin ver'i tıklayın.
Olay başlatma web sayfası açılır. Test bilgilerini girin:
- Olay başlığı alanına
The First Incident
yazın. - İsterseniz Olay yanıtlayıcıları bölümüne olay yanıt sorumlunuzun e-posta adreslerini girin. Söz konusu kullanıcıların Google Workspace kuruluşunuzda Google Chat hesabı olan kullanıcılar olması gerekir. Aksi takdirde alan oluşturulamaz. Otomatik olarak eklendiği için kendi e-posta adresinizi girmeyin.
- İlk mesaj'a
Testing the incident management Chat app.
yazın.
- Olay başlığı alanına
Chat alanı oluştur'u tıklayın. Bir
creating space
mesajı görünür.Alan oluşturulduktan sonra
Space created!
mesajı gösterilir. Alan aç'ı tıklayın. Bu işlem, alanı Chat'te yeni bir sekmede açar.İsterseniz siz ve diğer olay yanıt ekipleri alana mesaj gönderebilirsiniz. Uygulama, Vertex AI kullanarak bu mesajları özetliyor ve retrospektif belgesi paylaşıyor.
Olay yanıtını sonlandırmak ve çözüm sürecini başlatmak için Chat alanına
/closeIncident
yazın. Olay yönetimi iletişim kutusu açılır.Olayı kapat bölümünde, olay çözümü için
Test complete
gibi bir açıklama girin.Kapat'ı tıklayın.
Olay Yönetimi uygulaması, alandaki mesajları listeler, Vertex AI ile özetler, özeti bir Google Dokümanlar dokümanına yapıştırır ve dokümanı alanda paylaşır.
Temizleme
Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.
- Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.
- Proje listesinden silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
- İ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
- Projeleri Google Chat, Vertex AI ve Firestore ile yönetme
- Olay yanıtı uygulaması, API'leri çağırmak ve Chat API ile Vertex AI API gibi Google Cloud hizmetlerini çağırmak için kullanıcı kimlik bilgileriyle kimlik doğrulaması yapar.
Yani, olayı başlatan kullanıcının bu hizmetlere erişimi olması gerekir. Uygulamayı daha güçlü hale getirmek için
/closeIncident
eğik çizgi komutunu çağıran kullanıcının kullanıcı kimlik bilgileri yerine Vertex AI API'yi hizmet hesabı olarak çağırmayı düşünün. Vertex AI API için bir hizmet hesabını yapılandırma konusunda yardım almak istiyorsanız Özel hizmet hesabı kullanma bölümünü inceleyin.