Bu eğitimde, olaylara gerçek zamanlı olarak yanıt verir. Uygulama bir olaya müdahale ederken Chat alanı oluşturup doldurur, olayı kolaylaştırır mesajları, eğik çizgi komutları ve iletişim kutularıyla çözünür ve özetlemek için yapay zekayı kullanır. Google Dokümanlar dokümanına koyabilirsiniz.
Olay, ekibin hemen ilgilenmesi gereken olaylardır. çok sayıda kişi var. Olaylara örnek olarak şunlar verilebilir:
- Müşteri İlişkileri Yönetimi'nde (CRM) zamana duyarlı bir destek kaydı oluşturulur bir hizmet ekibinin bir çözüm için iş birliği yapmasını gerektiriyor.
- Bir sistem çevrimdışı olduğunda, site güvenilirliği mühendisleri (SRE'ler) bir grup olarak uyarı alır. Bu sayede, birlikte çalışarak sistemi tekrar çevrimdışı hale getirebilirler.
- Yüksek büyüklükte bir deprem meydana geliyor ve acil durum çalışanları ve cevaplarını koordine etmektir.
Bu eğitimde olay uyarısı, bir kullanıcı web sayfasından düğmeyi tıklayarak olayı bildirdiğinde başlar. Web sayfası kullanıcılardan şu temel olay bilgilerini girmelerini isteyen bir olaydır: başlık, ve katılımcıların e-posta adreslerini girin.
Olay yönetimi Chat uygulamasının nasıl çalıştığını görün:
-
.
Şekil 2. Chat alanının oluşturulduğuna dair bildirim. -
.
Şekil 3. Olaya yanıt verme Chat alanı. -
.
Şekil 4. Eğik çizgi komutuyla olayı çözme. -
Şekil 5. Olay çözme iletişim kutusu. -
Şekil 6. Alanda paylaşılan sorun çözme Google Dokümanlar dokümanı. -
.
Şekil 7. Google Dokümanlar'da yapay zeka özeti olay çözümü belgesi.
Ön koşullar
Kuruluşunuzda etkinleştirilmesi gereken ön koşullardan herhangi birine ihtiyacınız varsa Google Workspace yöneticinizden bunları etkinleştirmesini isteyin:
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı
- Google Workspace'te Dizin'in (kişi paylaşımı) etkin olması gerekir. Olay uygulaması, olaya müdahale eden kişilerin iletişim bilgilerini (ör. ad ve e-posta adresi) aramak için dizini kullanır. Olaya müdahale edenler, Google Workspace kuruluşunuzda Google Chat hesabı olan kullanıcılar olmalıdır.
Hedefler
- Olaylara yanıt veren bir Chat uygulaması derleyin.
- 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 sohbet uygulaması özellikleriyle ortak çalışmayı destekleme
- Vertex AI ile görüşmeleri ve çözümleri özetleyin.
Mimari
Aşağıdaki şemada, Google Workspace ve Olay yanıtı tarafından kullanılan Google Cloud kaynakları Google Chat uygulaması.
Mimari, olay yanıtı Google Chat uygulamasının bir olayı ve çözümü nasıl işlediğini gösterir.
Bir kullanıcı, şurada barındırılan harici bir web sitesinden bir olay başlatır: Apps Komut Dosyası.
Web sitesi, yine Apps Script'te barındırılan Google Chat uygulamasına eşzamansız bir HTTP isteği gönderir.
Olay yanıtlama Google Chat uygulaması isteği işler:
Apps Script Yönetici SDK'sı hizmeti, kullanıcı kimliği ve e-posta adresi gibi ekip üyesi bilgilerini alır.
Chat API'ye yapılan bir dizi HTTP isteğiyle Apps Komut Dosyası Gelişmiş Sohbet hizmeti, olaya verilen yanıt Google Chat uygulaması Chat'te olay oluşturur alanı ekip üyeleriyle doldurur ve alana bir mesaj gönderir.
Ekip üyeleri Chat alanında olay hakkında tartışır.
Bir ekip üyesi, paydaşa bir çözüm olduğunu belirtmek için eğik çizgi komutu çağırır gösterir.
Apps Komut Dosyası'nı kullanan Chat API'ye yapılan bir HTTP çağrısı Gelişmiş Chat hizmeti, tüm Chat sohbetlerini alanın mesajları görünür.
Vertex AI, listelenen mesajları alır ve bir özet oluşturur.
Apps Komut Dosyası
DocumentApp
hizmeti, yardımcı olur ve Vertex AI'ın özetini uygulayacaksınız.Olay yanıtı Google Chat uygulaması, özet Dokümanlar belgesinin 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, web sitesi için Google Cloud projesinin nasıl Chat uygulaması.
Google Cloud projesi oluşturma
Google Cloud Console
- Google Cloud konsolunda Menü'ye gidin > IAM ve Yönetici > Proje oluşturun'u tıklayın.
-
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.
- 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.
- 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'nin önceden ayarlandığı bir internet terminali 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ç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ştirin
Google Cloud Console
- Google Cloud konsolunda Faturalandırma'ya gidin. Sonraki slayta geçin 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 Console'da Google Chat API, Google Dokümanlar API, Admin SDK API ve Vertex AI API'yi etkinleştirin.
API'leri doğru Cloud projesinde etkinleştirdiğinizi onaylayıp İleri'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 değerini projenin Proje Kimliği ile değiştirin Oluşturduğunuz Cloud projesi.
gcloud services enable
komutuyla Google Chat API, Google Dokümanlar 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 yetkilendirme ayarlarını yapma
Kimlik doğrulama ve yetkilendirme, Google Workspace'te Chat uygulaması erişim kaynaklarına ve Google Cloud'un kullandığı bir teknolojidir.
Bu eğitimde uygulamayı dahili olarak yayınladığınız için yer tutucu bilgileri kullanabilirsiniz. Uygulamayı harici olarak yayınlamadan önce yer tutucunun yerine gerçek bilgilerle donatılmış bilgiler yer alır.
Google Cloud Console'da Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.
Kullanıcı türü bölümünde Dahili'yi seçin ve ardından Oluştur'u tıklayın.
Uygulama adı alanına
Incident Management
yazın.Kullanıcı desteği e-postası bölümünde e-posta adresinizi veya uygun bir Google grubunu seçin.
Geliştirici iletişim bilgileri bölümünün altına e-posta adresinizi girin.
Kaydet ve Devam Et'i tıklayın.
Kapsam Ekle veya Kaldır'ı tıklayın. Kapsamların listesini içeren bir panel görüntülenir Cloud projenizde etkinleştirdiğiniz her API için otomatik olarak oluşturulur.
Kapsamları manuel olarak ekle bölümüne aşağıdaki kapsamları 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 Script projesinin tamamını kopyalayıp güncelleyebilirsiniz. Bu nedenle, her dosyayı kopyalayıp yapıştırmanıza gerek yoktur.
Bazı işlevlerin adlarının sonuna alt çizgi eklenir (ör. ChatApp.gs
'dan processSlashCommand_()
). Alt çizgi, işlevi tarayıcıda açıkken olay başlatma web sayfasından gizler. Daha fazla
bkz.
Özel işlevler.
Apps Komut Dosyası, .gs
komut dosyaları ve .html
dosyalarının iki dosya türünü destekler. Bu desteğe uymak için uygulamanın istemci taraflı JavaScript'i
<script />
etiketlerinin içinde ve CSS'si, içindeki <style />
etiketlerinin içinde
bir HTML dosyası oluşturun.
Dilerseniz projenin tamamını GitHub'da görüntüleyebilirsiniz.
Her dosyaya genel bakış aşağıda verilmiştir:
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 referans verdiği sabitleri tanımlar.
Consts.gs
kodunu görüntülemeChatApp.gs
Aşağıdakiler dahil olmak üzere Chat etkileşimi etkinliklerini yönetir: mesajlar, kart tıklamaları, eğik çizgi komutları ve iletişim kutularıdır. Yanıt
/closeIncident
Olay toplamak için iletişim kutusu açarak eğik çizgi komutunu kullanın daha fazla bilgi edinebilirsiniz. Chat API'dekispaces.messages.list
yöntemini çağırarak alandaki mesajları okur. Apps Komut Dosyası'nda Admin SDK Directory hizmetini kullanarak kullanıcı kimliklerini alır.ChatApp.gs
kodunu görüntülemeChatSpaceCreator.gs
Kullanıcıların olay başlatma web sayfasına girdikleri form verilerini alır ve bu verileri kullanarak bir Chat alanı oluşturup doldurur, ardından olayla ilgili 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 Dokümanlar API'yi çağırır ve
VertexAiApi.gs
içinde oluşturulan olay bilgilerinin özetini dokümana yazar.DocsApi.gs
kodunu gösterVertexAiApi.gs
Chat'teki görüşmeyi özetler Vertex AI'ı kullanarak yeni şeyler öğrenebilirsiniz. Bu özet, özel olarak oluşturulmuş bir
DocsAPI.gs
uygulamasında doküman.VertexAiApi.gs
kodunu görüntülemeWebController.gs
Olay başlatma web sitesini sunar.
WebController.gs
kodunu görüntülemeIndex.html
Olay başlatma web sitesini oluşturan HTML.
Index.html
kodunu görüntülemeJavaScript.html
Gönderme, gönderme, hesap ve bildirim gibi form davranışlarını yönetir. ve olay başlatma web sitesiyle ilgili sorunları giderir. Her şey dahil
WebController.gs
içindeki özelinclude
işleviyleIndex.html
işlevine dönüştürülebilir.JavaScript.html
kodunu görüntülemeStylesheet.html
Olay başlatma web sitesinin CSS'si.
WebController.gs
içindeki özelinclude
işlevi tarafındanIndex.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
Apps Komut Dosyası projesi oluşturmak ve bunu Cloud projenize bağlamak için:
- Google Chat ile olaylara yanıt verme Apps Script 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ı projesinin kopyanıza bir ad verin:
Google Chat ile ilgili olaylara yanıt verme kopyası'nı tıklayın.
Proje başlığı'na
Incident Management Chat app
yazın.Yeniden adlandır'ı tıklayın.
Apps Komut Dosyası projesinin kopyasında
Consts.gs
dosyasına gidin veYOUR_PROJECT_ID
yerine Cloud projenizin kimliğini yazın.
Apps Komut Dosyası projesinin Cloud projesini ayarlayın
- Apps Komut Dosyası projenizde Proje Ayarları'nı tıklayın.
- Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
- GCP proje numarası alanına Cloud projenizin proje numarasını yapıştırın.
- Proje ayarla'yı tıklayın. Cloud projesi ve Apps Komut Dosyası şimdi de bağlantılı.
Apps Komut Dosyası dağıtımı oluşturma
Tüm kod yerleştirildikten sonra Apps Komut Dosyası'nı dağıtın. belirler. Dağıtım kimliğini, Google Cloud'da Chat uygulamasını yapılandırırken kullanırsınız.
Apps Komut Dosyası'nda olaya yanıt uygulamasının projesini açın.
Dağıt'ı tıklayın > Yeni dağıtım.
Eklenti ve Web uygulaması henüz seçilmemişse Türü seçin'in yanındaki dağıtım türlerini tıklayın ve Eklenti ile Web uygulaması'nı seçin.
Açıklama bölümünde, bu sürüm için aşağıdaki gibi bir açıklama girin:
Complete version of incident management app
.Farklı yürüt bölümünde Web uygulamasına erişen kullanıcı'yı seçin.
Erişimi olan kullanıcılar bölümünde Workspace kuruluşunuzdaki herkes'i seçin. "Workspace kuruluşunuz", Google Workspace kuruluşunuzun adıdır.
Dağıt'ı tıklayın. Apps Komut Dosyası raporları başarılı dağıtım ve olay için dağıtım kimliği ile URL sağlar ilk kullanıma hazırlama web sayfası.
Daha sonra bir olay başlattığınızda ziyaret etmek için web uygulaması URL'sini not edin. Deployment ID'yi (Dağıtım Kimliği) kopyalayın. Google Cloud Console'daki Chat uygulaması
Bitti'yi tıklayın.
Google Cloud Console'da Chat uygulamasını yapılandırma
Bu bölümde, Google Cloud Console'da Google Chat API'nin nasıl yapılandırılacağı gösterilmektedir Aşağıdakiler de dahil olmak üzere Chat uygulamanızla ilgili bilgileri içeren Apps Komut Dosyanızdan yeni oluşturduğunuz dağıtımın kimliği belirler.
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 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ı bölümünde Apps Komut Dosyası'nı seçin.
Dağıtım Kimliği alanına, daha önce Apps Komut Dosyası proje dağıtımından kopyaladığınız Apps Komut Dosyası dağıtım kimliğini yapıştırın.
Şu boyutta bir eğik çizgi komutu kaydedin: tam olarak uygulanmış Chat uygulamasında şunlar kullanılır:
Eğik çizgi komutları bölümünde 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 şunu yazın:
Closes the incident being discussed in the space.
Bir iletişim kutusu açar'ı seçin.
Bitti'yi tıklayın. Eğik çizgi komutu kaydedilir ve listelenir.
Görünürlük altında Bu Chat uygulamasını, Workspace Alanı'nı tıklayın ve e-posta adresinizi girin.
Günlükler bölümünde Günlüğe hata kaydet'i seçin.
Kaydet'i tıklayın. Yapılandırma tarafından kaydedilmiş bir mesaj görünür. Bu mesaj, uygulamanın hazır olduğunu göreceksiniz.
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. - İsteğe bağlı olarak, Olay müdahale ekipleri bölümüne şu e-posta adreslerini girin: yanıt verebilirsiniz. Kullanıcıların, Google Workspace kuruluşunuzda Google Chat hesabı olmalıdır. Aksi takdirde alan oluşturma işlemi başarısız olur. Kendi e-posta adresinizi girmeyin. Bu adres otomatik olarak eklenir.
- İlk mesaj alanına
Testing the incident management Chat app.
yazın
- Olay başlığı alanına
Sohbet alanı oluştur'u tıklayın.
creating space
mesajı gösterilir.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.İsteğe bağlı olarak, siz ve diğer olay müdahale ekipleri alanda mesaj gönderebilirsiniz. Uygulama, bu mesajları Vertex AI'ı kullanarak özetler ve geriye dönük bir belge paylaşır.
Olay yanıtını sonlandırmak ve çözüm sürecini başlatmak için sohbet alanında
/closeIncident
yazın. Olay yönetimi iletişim kutusu açılır.Olay kapatma bölümünde, olayın çözümü için bir açıklama girin.
Test complete
gibi.Olay Kapat'ı tıklayın.
Olay Yönetimi uygulaması, alandaki mesajları listeler ve özetler özeti bir Google Dokümanlar dokümanına yapıştırır ve kullanabilirsiniz.
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. Sonraki slayta geçin Menü > IAM ve Yönetici > Kaynakları Yönetin.
- Proje listesinden silmek istediğiniz projeyi seçin ve ardından Sil: .
- İletişim kutusuna proje kimliğini yazın ve silmek için Kapat'ı tıklayın gösterir.
İlgili konular
- Gemini yapay zeka sohbet uygulamasıyla Chat sohbetlerine dayalı soruları yanıtlama
- Google Chat, Vertex AI ve Firestore ile projeleri yönetme
- Olay yanıt uygulaması, API'leri çağırmak için kullanıcı kimlik bilgileriyle kimlik doğrular
ve Chat API ile Vertex AI API gibi Google Cloud hizmetlerini çağırın.
Bu nedenle, bir olayı başlatan kullanıcının bu hizmetlere erişimi olmalıdır. Uygulamayı daha sağlam hale getirmek için Vertex AI API'yi çağırmayı düşünebilirsiniz
kullanıcının çağırdığı kullanıcı kimlik bilgileri yerine hizmet hesabı olarak kullanılır.
/closeIncident
eğik çizgi komutu. Vertex AI API için bir hizmet hesabı yapılandırmaya dair yardım için Özel hizmet hesabı kullanma başlıklı makaleyi inceleyin.