Tutorial ini menunjukkan cara membuat aplikasi Google Chat yang merespons insiden secara real time. Saat merespons suatu insiden, aplikasi membuat dan mengisi ruang Chat, memfasilitasi insiden resolusi dengan pesan, perintah garis miring, dan dialog, serta menggunakan AI untuk meringkas respons insiden dalam dokumen Google Dokumen.
Insiden adalah peristiwa yang memerlukan perhatian segera dari tim yang harus diselesaikan. Contoh insiden meliputi:
- Kasus mendesak dibuat di Pengelolaan Hubungan Pelanggan (CRM) platform ini, membutuhkan tim layanan untuk berkolaborasi dalam sebuah resolusi.
- Sistem menjadi offline, dan memperingatkan sekelompok site reliability engineer (SRE) sehingga mereka dapat bekerja sama untuk menghadirkannya kembali secara online.
- Gempa bumi berkekuatan tinggi terjadi, dan petugas darurat membutuhkan untuk mengkoordinasikan tanggapan mereka.
Untuk tujuan tutorial ini, pemberitahuan insiden dimulai saat seseorang melaporkan insiden dengan menekan tombol klik dari laman web. Halaman web ini menyimulasikan insiden dengan meminta pengguna untuk memasukkan informasi insiden dasar: judul, deskripsi, dan alamat email responden.
Lihat cara kerja aplikasi Chat manajemen insiden:
-
Gambar 1. Situs tempat seseorang dapat melaporkan insiden. -
Gambar 2. Notifikasi bahwa ruang Chat insiden telah dibuat. -
Gambar 3. Ruang Chat respons insiden. -
Gambar 4. Menyelesaikan insiden dengan perintah garis miring. -
Gambar 5. Dialog resolusi insiden. -
Gambar 6. Dokumen Google Dokumen resolusi insiden dibagikan di ruang. -
Gambar 7. Dokumen Google Dokumen penyelesaian insiden ringkasan AI.
Prasyarat
Jika Anda perlu mengaktifkan salah satu prasyarat ini untuk organisasi Anda, minta administrator Google Workspace Anda untuk mengaktifkannya:
- Sebuah Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
- Untuk memiliki Direktori (berbagi kontak) diaktifkan untuk Google Workspace. Aplikasi insiden menggunakan direktori untuk mencari para petugas respons insiden info kontak, seperti nama dan alamat email Anda. Perespons insiden harus merupakan pengguna dengan Google Chat di organisasi Google Workspace Anda.
Tujuan
- Membangun aplikasi Chat yang merespons insiden.
- Bantu pengguna merespons insiden dengan melakukan hal berikut:
- Membuat ruang respons insiden.
- Memposting pesan yang merangkum insiden dan respons.
- Mendukung kolaborasi dengan Fitur aplikasi Chat.
- Meringkas percakapan dan resolusi dengan Vertex AI.
Arsitektur
Diagram berikut menunjukkan arsitektur Google Workspace dan Resource Google Cloud yang digunakan oleh respons insiden Aplikasi Google Chat.
Arsitektur ini menunjukkan bagaimana respons insiden Aplikasi Google Chat memproses insiden dan resolusi.
Pengguna memulai insiden dari situs web eksternal yang dihosting di Apps Script.
Situs mengirim permintaan HTTP asinkron ke Aplikasi Google Chat, yang juga dihosting di Apps Script.
Aplikasi Google Chat respons insiden akan memproses permintaan:
Layanan Apps Script Admin SDK mendapatkan anggota tim seperti ID pengguna dan alamat email.
Dengan serangkaian permintaan HTTP ke Chat API menggunakan Layanan Chat Lanjutan Apps Script, respons insiden Aplikasi Google Chat membuat Chat insiden mengisinya dengan anggota tim, dan mengirim pesan ke ruang tersebut.
Anggota tim mendiskusikan insiden tersebut di ruang Chat.
Seorang anggota tim memanggil perintah garis miring untuk memberi sinyal resolusi ke insiden bulanan.
Panggilan HTTP ke Chat API menggunakan Apps Script Layanan Chat lanjutan mencantumkan semua pesan ruang.
Vertex AI menerima pesan yang tercantum dan membuat ringkasan.
Layanan
DocumentApp
Apps Script membuat mendokumentasikan dokumen dan menambahkan ringkasan Vertex AI ke dokumen.Panggilan aplikasi Google Chat respons insiden Chat API untuk mengirim pesan yang membagikan link ke ringkasan Dokumen.
Menyiapkan lingkungan
Bagian ini menunjukkan cara membuat dan mengonfigurasi project Google Cloud untuk Aplikasi Chat.
Membuat project Google Cloud
Konsol Google Cloud
- Di konsol Google Cloud, buka Menu > IAM & Admin > Buat Project.
-
Di kolom Project Name, masukkan nama deskriptif untuk project Anda.
Opsional: Untuk mengedit Project ID, klik Edit. Project ID tidak dapat diubah setelah proyek dibuat, jadi pilihlah ID yang sesuai dengan kebutuhan Anda sepanjang waktu proyek.
- Di kolom Lokasi, klik Jelajahi untuk menampilkan potensi lokasi untuk proyek. Kemudian, klik Select.
- Klik Buat. Konsol Google Cloud membuka halaman Dashboard dan project Anda telah dibuat dalam beberapa menit.
gcloud CLI
Di salah satu lingkungan pengembangan berikut, akses paket Google Cloud CLI (`gcloud`):
-
Cloud Shell: Untuk menggunakan terminal online dengan gcloud CLI
sudah disiapkan, aktifkan Cloud Shell.
Mengaktifkan Cloud Shell -
Local Shell: Untuk menggunakan lingkungan pengembangan lokal,
instal dan
inisialisasi
gcloud CLI.
Untuk membuat project Cloud, gunakan perintah `gcloud projects create`:gcloud projects create PROJECT_ID
Mengaktifkan penagihan untuk project Cloud
Konsol Google Cloud
- Di konsol Google Cloud, buka Billing. Klik Menu > Penagihan > Project Saya.
- Di bagian Pilih organisasi, pilih organisasi yang dikaitkan dengan project Google Cloud Anda.
- Di baris project, buka menu Tindakan ( ), klik Ubah penagihan, lalu pilih Akun Penagihan Cloud Anda.
- Klik Tetapkan akun.
gcloud CLI
- Untuk menampilkan daftar akun penagihan yang tersedia, jalankan:
gcloud billing accounts list
- Tautkan akun penagihan dengan project Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
Ganti kode berikut:
PROJECT_ID
adalah Project ID untuk Project cloud yang penagihannya ingin Anda aktifkan.BILLING_ACCOUNT_ID
adalah ID akun penagihan yang akan ditautkan project Google Cloud.
Mengaktifkan API
Konsol Google Cloud
Di konsol Google Cloud, aktifkan Google Chat API, yakni Google Docs API, Admin SDK API, dan Vertex AI API.
Pastikan Anda mengaktifkan API dengan lalu klik Berikutnya.
Pastikan Anda mengaktifkan API yang benar, lalu klik Enable.
gcloud CLI
Jika perlu, tetapkan project Cloud saat ini ke project yang Anda buat dengan perintah
gcloud config set project
:gcloud config set project PROJECT_ID
Ganti PROJECT_ID dengan Project ID dari Project Cloud yang telah Anda buat.
Mengaktifkan Google Chat API, Google Docs API, Admin SDK API, dan Vertex AI API dengan perintah
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Menyiapkan autentikasi dan otorisasi
Otentikasi dan otorisasi memungkinkan Referensi akses aplikasi Chat di Google Workspace dan Google Cloud untuk memproses respons insiden.
Dalam tutorial ini, Anda akan memublikasikan aplikasi secara internal sehingga placeholder dapat digunakan tidak akurat atau tidak sesuai. Sebelum memublikasikan aplikasi secara eksternal, ganti placeholder dengan informasi aktual di layar izin.
Di Konsol Google Cloud, buka Menu > API & Layanan > Layar izin OAuth.
Di bagian Jenis pengguna, pilih Internal, lalu klik Buat.
Di App name, ketik
Incident Management
.Di bagian Email dukungan pengguna, pilih alamat email Anda atau alamat Grup Google.
Di bagian Informasi kontak developer, masukkan alamat email Anda.
Klik Simpan dan Lanjutkan.
Klik Add or Remove Scopes. Panel akan muncul dengan daftar cakupan untuk setiap API yang telah Anda aktifkan di project Cloud.
Di bagian Tambahkan cakupan secara manual, tempel cakupan berikut:
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
Klik Tambahkan ke Tabel.
Klik Perbarui.
Klik Simpan dan Lanjutkan.
Tinjau ringkasan pendaftaran aplikasi, lalu klik Kembali ke Dasbor.
Membuat dan men-deploy aplikasi Chat
Di bagian berikut, Anda akan menyalin dan memperbarui seluruh Project Apps Script yang berisi semua aplikasi yang diperlukan kode aplikasi Chat, jadi tidak perlu menyalin dan tempelkan setiap file.
Beberapa fungsi menyertakan garis bawah di akhir nama mereka, seperti
processSlashCommand_()
dari ChatApp.gs
. Garis bawah menyembunyikan fungsi
dari halaman web inisialisasi insiden
ketika terbuka di browser. Untuk selengkapnya
informasi, lihat
Fungsi pribadi.
Apps Script mendukung dua jenis file, skrip .gs
dan .html
. Untuk mematuhi dukungan ini, JavaScript sisi klien aplikasi disertakan
di dalam tag <script />
dan CSS-nya disertakan di dalam tag <style />
di dalamnya
file HTML.
Atau, Anda dapat melihat seluruh project di GitHub.
Berikut ringkasan setiap filenya:
Consts.gs
Mendefinisikan konstanta yang direferensikan oleh file kode lainnya, termasuk ID project Cloud, ID lokasi Vertex AI, dan ID perintah garis miring untuk menutup insiden.
Lihat kode
Consts.gs
ChatApp.gs
Menangani peristiwa interaksi Chat, termasuk pesan, klik kartu, perintah garis miring, dan dialog. Merespons Perintah garis miring
/closeIncident
dengan membuka dialog untuk mengumpulkan insiden detail resolusi. Membaca pesan dalam ruang dengan memanggil Metodespaces.messages.list
di Chat API. Mendapatkan ID pengguna menggunakan layanan Direktori Admin SDK dalam Apps Script.Lihat kode
ChatApp.gs
ChatSpaceCreator.gs
Menerima data formulir yang dimasukkan pengguna saat insiden melakukan inisialisasi pada halaman web, dan menggunakannya untuk menyiapkan Chat dengan membuat dan mengisinya, kemudian memposting pesan tentang insiden bulanan.
Lihat kode
ChatSpaceCreator.gs
DocsApi.gs
Memanggil Google Docs API untuk membuat dokumen Google Dokumen dengan pengguna Google Drive dan menulis ringkasan informasi insiden, yang dibuat di
VertexAiApi.gs
, ke dokumen.Lihat kode
DocsApi.gs
VertexAiApi.gs
Merangkum percakapan dalam Chat ruang angkasa menggunakan Vertex AI. Ringkasan ini diposting dalam folder dokumen di
DocsAPI.gs
.Lihat kode
VertexAiApi.gs
WebController.gs
Melayani situs inisialisasi insiden.
Lihat kode
WebController.gs
Index.html
HTML yang terdiri dari situs web inisialisasi insiden.
Lihat kode
Index.html
JavaScript.html
Menangani perilaku formulir termasuk pengiriman, kesalahan, dan membersihkan, untuk situs web inisialisasi insiden. Sudah disertakan menjadi
Index.html
dengan fungsiinclude
kustom diWebController.gs
.Lihat kode
JavaScript.html
Stylesheet.html
CSS untuk situs inisialisasi insiden. Penting disertakan ke dalam
Index.html
oleh fungsiinclude
kustom diWebController.gs
.Lihat kode
Stylesheet.html
Menemukan nomor dan ID project Cloud
Di konsol Google Cloud, buka project Cloud Anda.
Klik Setelan dan Utilitas > Setelan project.
Catat nilai di kolom Project number dan Project ID. Anda menggunakannya di bagian berikut.
Membuat project Apps Script
Untuk membuat project Apps Script dan menghubungkannya dengan Project cloud:
- Klik tombol berikut untuk membuka project Apps Script Respond to insiden with Google Chat.
Membuka project - Klik Ringkasan.
- Di halaman ringkasan, klik
Buat salinan.
Beri nama salinan project Apps Script:
Klik Salinan Respons terhadap insiden dengan Google Chat.
Di Project title, ketik
Incident Management Chat app
.Klik Ganti nama.
Di salinan project Apps Script, buka
Consts.gs
dan gantiYOUR_PROJECT_ID
dengan ID project Google Cloud.
Menetapkan project Cloud project Apps Script
- Di project Apps Script Anda,
klik
Project Settings.
- Pada Google Cloud Platform (GCP) Project, klik Change project.
- Di GCP project number, tempel nomor project dari project Cloud Anda.
- Klik Set project. Project Cloud dan Apps Script sekarang terhubung.
Membuat deployment Apps Script
Setelah semua kode berada di tempatnya, deploy Apps Script proyek. Anda menggunakan ID deployment saat mengonfigurasi Aplikasi Chat di Google Cloud.
Di Apps Script, buka project aplikasi respons insiden.
Klik Deploy > Deployment baru.
Jika Add-on dan Aplikasi web belum dipilih, di samping Pilih jenis, klik jenis deployment
, lalu pilih Add-on dan Web app.
Di bagian Description, masukkan deskripsi untuk versi ini, seperti
Complete version of incident management app
.Di bagian Jalankan sebagai, pilih Pengguna yang mengakses aplikasi web
Di bagian Siapa yang memiliki akses, pilih Siapa saja dalam organisasi Workspace Anda, dengan "organisasi Workspace Anda" adalah nama pengaturan Google Workspace Anda.
Klik Deploy. Laporan Apps Script berhasil deployment dan menyediakan ID deployment dan URL untuk insiden halaman web inisialisasi Anda.
Catat URL Aplikasi web yang akan dikunjungi nanti saat Anda memulai insiden. Salin ID Deployment. Anda menggunakan ID ini saat mengonfigurasi Aplikasi Chat di Konsol Google Cloud.
Klik Selesai.
Mengonfigurasi aplikasi Chat di Konsol Google Cloud
Bagian ini menunjukkan cara mengonfigurasi Google Chat API di konsol Google Cloud dengan informasi tentang aplikasi Chat Anda, termasuk ID deployment yang baru saja dibuat dari Apps Script proyek.
Di Konsol Google Cloud, klik Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API > Kelola > Konfigurasi.
Di App name, ketik
Incident Management
.Di Avatar URL, ketik
https://developers.google.com/chat/images/quickstart-app-avatar.png
.Pada Description, ketik
Responds to incidents.
.Klik tombol Enable Interactive features ke posisi aktif.
Di bagian Functionality, pilih Receive 1:1 messages, Join spaces and group conversations.
Di bagian Connection settings, pilih Apps Script project.
Di ID Deployment, tempel ID Deployment Apps Script yang sebelumnya Anda salin dari project Apps Script deployment.
Daftarkan perintah garis miring yang aplikasi Chat yang diterapkan sepenuhnya menggunakan:
Di bagian Perintah garis miring, klik Tambahkan perintah garis miring.
Di Name, ketik
/closeIncident
.Pada Command ID, ketik
1
.Di Description, ketik
Closes the incident being discussed in the space.
Pilih Opens a dialog.
Klik Selesai. Perintah garis miring terdaftar dan terdaftar.
Di bagian Visibility, pilih Sediakan aplikasi Chat ini untuk orang dan grup tertentu di Domain Workspace dan masukkan alamat email Anda.
Di bagian Logs, pilih Log errors to Logging.
Klik Simpan. Pesan konfigurasi tersimpan akan muncul, artinya aplikasi tersebut siap diuji.
Menguji aplikasi Chat
Untuk menguji aplikasi Chat manajemen insiden, mulai dari halaman web dan memverifikasi bahwa aplikasi Chat berfungsi seperti yang diharapkan:
Buka URL aplikasi web deployment Apps Script.
Jika Apps Script meminta izin untuk mengakses data Anda, Klik Tinjau izin, login dengan Akun Google yang sesuai di domain Google Workspace Anda, lalu klik Izinkan.
Halaman web inisialisasi insiden akan terbuka. Masukkan informasi pengujian:
- Di bagian Incident title, ketik
The First Incident
. - Secara opsional, di Perespons insiden, masukkan alamat email rekan perespons insiden Anda. Mereka harus pengguna dengan Akun Google Chat di organisasi Google Workspace Anda atau pembuatan ruang gagal. Jangan masukkan alamat email Anda karena disertakan secara otomatis.
- Di Pesan awal, ketik
Testing the incident management Chat app.
- Di bagian Incident title, ketik
Klik Create Chat Space. Pesan
creating space
akan muncul.Setelah ruang dibuat, pesan
Space created!
akan muncul. Klik Buka ruang, yang akan membuka ruang Chat di tab baru.Anda dan tim tanggap darurat lainnya juga dapat mengirim pesan di spasi. Aplikasi ini merangkum pesan-pesan tersebut menggunakan Vertex AI dan membagikan dokumen retrospektif.
Untuk mengakhiri respons insiden dan memulai proses resolusi, Ruang Chat, ketik
/closeIncident
. Manajemen insiden dialog akan terbuka.Di bagian Tutup insiden, masukkan deskripsi untuk resolusi insiden, seperti
Test complete
.Klik Tutup Insiden.
Aplikasi Manajemen Insiden mencantumkan pesan di ruang, merangkumnya dengan Vertex AI, menempelkan ringkasan ke dalam dokumen Google Dokumen, dokumen dalam ruang.
Pembersihan
Agar tidak menimbulkan biaya ke akun Google Cloud Anda untuk sumber daya yang digunakan dalam tutorial ini, sebaiknya Anda menghapus project Google Cloud.
- Di Konsol Google Cloud, buka halaman Manage resources. Klik Menu > IAM & Admin > Kelola Resource.
- Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus .
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus menyelesaikan proyek tersebut.
Topik terkait
- Menjawab pertanyaan berdasarkan percakapan Chat dengan aplikasi Gemini AI Chat
- Mengelola project dengan Google Chat, Vertex AI, dan Firestore
- Aplikasi respons insiden mengautentikasi dengan kredensial pengguna untuk memanggil API
dan memanggil layanan Google Cloud, seperti Chat API dan Vertex AI API.
Artinya, pengguna yang menginisialisasi
suatu insiden harus memiliki akses ke
layanan IT perusahaan mereka. Untuk membuat aplikasi lebih tangguh, pertimbangkan untuk memanggil Vertex AI API
sebagai akun layanan, bukan kredensial pengguna dari pengguna
perintah garis miring
/closeIncident
. Untuk mendapatkan bantuan dalam mengonfigurasi akun layanan untuk Vertex AI API, lihat Gunakan akun layanan kustom.