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ışı olduktan sonra bir grup site güvenilirliği mühendislerini (SRE'ler) uyarır. Böylece uygulamayı tekrar çevrimiçi duruma getirmek üzere birlikte çalışabilirler.
- Yüksek büyüklükte bir deprem meydana geliyor ve acil durum çalışanları ve cevaplarını koordine etmektir.
Bu eğitimde belirtildiği gibi, olay uyarısı bir kullanıcı bir web sayfasından yapılan düğmeyi tıklayarak olayı bildirir. 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.
Chat olay yönetimi uygulamasını çalışırken görün:
-
Şekil 1. Kullanıcıların olayı bildirebileceği web sitesi. -
.
Şekil 2. Chat alanının oluşturulduğuna dair bildirim. -
.
Şekil 3. Olay yanıtı 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 bu ön koşullardan herhangi birinin etkinleştirilmesi gerekiyorsa Google Workspace yöneticinize başvurarak:
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
- Mevcut Dizin (kişi paylaşımı) Google Workspace için etkinleştirilmiş olmalıdır. Olay uygulaması, olaya müdahale edenlerin iletişim bilgileri (ör. ad) ve e-posta adresi. Olay müdahale ekibi, Google Chat kullanıcısı olmalıdır hesabınızda oturum açın.
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 iletiler yayınlama.
- Ortak çalışmayı desteklemek için etkileşimli araçlar Chat uygulaması özellikleri.
- Vertex AI ile konuşmaları 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, olaya verilen yanıtın Google Chat uygulaması bir olayı ve çözümü işler.
Bir kullanıcı, şurada barındırılan harici bir web sitesinden bir olay başlatır: Apps Komut Dosyası.
Web sitesi, Apps Komut Dosyası'nda da barındırılan Google Chat uygulaması
Olay yanıtı Google Chat uygulaması, isteği işler:
Apps Komut Dosyası Yönetici SDK'sı hizmetine ekip üyesi eklenir kullanıcı kimliği ve e-posta adresi gibi bilgileri dahil edin.
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ı kullanarak 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ıp bir özet oluşturur.
Apps Komut Dosyası
DocumentApp
hizmeti, yardımcı olur ve Vertex AI'ın özetini uygulayacaksınız.Google Chat uygulamasının aradığı olay yanıtı Özet bağlantısının paylaşıldığı bir mesaj göndermek için Chat API'si Dokümanlar dokümanı.
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 kimliği değiştirilemez Bu nedenle, ilk deneme süresi boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin. belirler.
- 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 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: 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.
- Bir kuruluş seçin bölümünde, ilişkili kuruluşu seçin Google Cloud projenize ekleyin.
- 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
ş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
Google Cloud konsolunda Google Chat API'yi, Google Docs API'yi ve Admin SDK API ve Vertex AI API.
API'leri doğru şekilde etkinleştirdiğinizden emin olun. Cloud projesine, ardından İleri'yi tıklayın.
Doğru API'leri etkinleştirdiğinizden emin olun ve ardından Etkinleştir'i tıklayın.
gcloud CLI
Gerekirse mevcut Cloud projesini, oluşturduğunuz projeye ayarlayın
gcloud config set project
komutuyla:gcloud config set project PROJECT_ID
PROJECT_ID değerini projenin Proje Kimliği ile değiştirin Oluşturduğunuz Cloud projesi.
Google Chat API, Google Docs API, Admin SDK API ve Vertex AI API'yi etkinleştirme
gcloud services enable
komutuyla: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ğiticide, uygulamayı dahili olarak yayınladığınız için yer tutucu kullanmanın bir sakıncası yoktur ekleyebilirsiniz. Uygulamayı harici olarak yayınlamadan önce yer tutucunun yerine gerçek bilgilerle donatılmış bilgiler yer alır.
Google Cloud konsolunda şu adrese gidin: Menü > API'ler ve Hizmetler > OAuth izin ekranı'nı tıklayın.
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 Google grubu.
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
Add to Table'ı (Tabloya Ekle) tıklayın.
Güncelle'yi tıklayın.
Kaydet ve Devam Et'i tıklayın.
Uygulama kaydı özetini inceleyin ve ardından Kontrol Paneline Dön'ü tıklayın.
Chat uygulamasını oluşturma ve dağıtma
Aşağıdaki bölümde bir Gerekli tüm uygulamaları içeren Apps Komut Dosyası projesi olduğundan emin olmak için hem mevcut hem de her dosyayı yapıştırın.
Bazı işlevlerin adlarının sonunda alt çizgi vardır. Örneğin:
processSlashCommand_()
, kalkış: ChatApp.gs
. Alt çizgi, işlevi gizler
olay başlatma web sayfasından erişilebilir. Daha fazla
bkz.
Özel işlevler.
Apps Komut Dosyası, .gs
komut dosyaları ve .html
olmak üzere iki dosya türünü destekler.
dosyası olarak da kaydedebilir. 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.
Aşağıda, her bir dosyaya ilişkin genel bakış bulabilirsiniz:
Consts.gs
Diğer kod dosyalarının başvurduğu sabit değerleri tanımlar, Buna Cloud proje kimliğiniz, Vertex AI konum kimliğiniz ve bir olayı kapatmak için eğik çizgi komutu kimliği.
Consts.gs
kodunu gösterChatApp.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. Alandaki mesajları okumak içinspaces.messages.list
yöntemini çağırın. Şuradaki Yönetici SDK'sı Dizini hizmetini kullanarak kullanıcı kimliklerini alır: Apps Komut Dosyası.ChatApp.gs
kodunu gösterChatSpaceCreator.gs
Kullanıcıların olayda girdiği form verilerini alır ilk kullanıma hazırlama web sayfasını sağlar ve bu API'yi kullanarak alan adını oluşturup doldurduktan sonra gösterir.
ChatSpaceCreator.gs
kodunu gösterDocsApi.gs
Bir Google Dokümanlar dokümanı oluşturmak için Google Docs API'yi kullanıcının Google Drive'ına gönderir ve olay bilgilerinin bir özetini yazarsa,
VertexAiApi.gs
ürününde oluşturuldu.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österWebController.gs
Olay başlatma web sitesini sunar.
WebController.gs
kodunu gösterIndex.html
Olay başlatma web sitesini oluşturan HTML.
Index.html
kodunu gösterJavaScript.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österStylesheet.html
Olay başlatma web sitesinin CSS'si. İnsanların
Index.html
içine özelinclude
işlevi tarafından dahil edilirWebController.gs
.Stylesheet.html
kodunu göster
Cloud proje numaranızı ve kimliğinizi bulma
Google Cloud konsolunda Cloud projenize gidin.
Ayarlar ve Yardımcı Programlar'ı tıklayın. > Proje ayarları.
Proje numarası ve Proje Kimliği alanlarındaki değerleri not edin. Siz kullanabilirsiniz.
Apps Komut Dosyası projesini oluşturma
Apps Komut Dosyası projesi oluşturmak ve bu projeyi Cloud projesi:
- Aşağıdaki düğmeyi tıklayarak Google Chat ile olaylara yanıt verin Apps Komut Dosyası projesini açı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 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ı projesi için oluşturduğunuz kopyada
Consts.gs
adresine gidin. dosyasını seçin veYOUR_PROJECT_ID
yerine Cloud projesi.
Apps Komut Dosyası projesinin Cloud projesini ayarlayın
- Apps Komut Dosyası projenizde,
Proje Ayarları'nı tıklayın.
- Google Cloud Platform (GCP) Project bölümünde Projeyi değiştir seçeneğini 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'daki Chat uygulaması.
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ı seçili değilse Tür seçin, dağıtım türlerini
tıklayın, ardından Eklenti ve 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 olanlar bölümünde Workspace kuruluşunuzdaki herkes'i seçin. Burada "Workspace kuruluşunuz" kişinin adı Google Workspace kuruluşu.
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 edilecek 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 konsolunda Menü'yü tıklayın. > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma.
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 tıklayarak 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.
Deployment ID (Dağıtım Kimliği) alanına Apps Komut Dosyası Dağıtım Kimliğini yapıştırın. daha önce Apps Komut Dosyası projesinden kopyaladığınız dağıtım.
Şu boyutta bir eğik çizgi komutu kaydedin: tam olarak uygulanmış Chat uygulamasında şunlar kullanılır:
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 şunu yazın:
Closes the incident being discussed in the space.
İletiş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, Hataları günlüğe kaydetme'yi 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 olup olmadığını kontrol edin ve Chat uygulamasının beklendiği gibi çalışıyor:
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, uygun bir Google Hesabı ile oturum açın seçin 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 müdahale ekipleri bölümüne şu e-posta adreslerini de girebilirsiniz: yanıt verebilirsiniz. Belirli bir Google Workspace kuruluşunuzdaki Google Chat hesabınız veya alan oluşturulamadı. dahil edilir.
- İ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österilir.Alan oluşturulduktan sonra bir
Space created!
mesajı gösterilir. Sonraki slayta geçin Alanı aç: Bu işlem, alanı Chat'te yeni bir sekmede açar.İsterseniz siz ve diğer olay müdahale ekipleri, boşluk oluşturur. Uygulama, Vertex AI'ı kullanarak bu mesajları özetler ve retrospektif belgesidir.
Olay yanıtını sonlandırmak ve çözüm sürecini başlatmak için Chat alanı,
/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
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.
-
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.
- 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 AI Chat 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.
Yani, olayı başlatan kullanıcının şunlara erişmesi gerekir:
kullanıma sunuyoruz. 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. Hizmet hesabını yapılandırma konusunda yardım için Vertex AI API hakkında Özel hizmet hesabı kullanın.