Mengelola project dengan Google Chat, Vertex AI, dan Firestore

Tutorial ini menunjukkan cara membuat aplikasi Google Chat yang dapat digunakan tim untuk mengelola project secara real time. Aplikasi Chat menggunakan Vertex AI untuk membantu tim menulis kisah pengguna (yang merepresentasikan fitur sistem software dari sudut pandang pengguna untuk dikembangkan oleh tim) dan mempertahankan kisah tersebut dalam database Firestore.

• 

  Gambar 1. Charlie mendiskusikan pengembangan fitur di ruang Chat dengan timnya. Menyebutkan aplikasi Chat pengelolaan project akan memicu aplikasi Chat untuk menawarkan bantuan.

• 

  Gambar 2. Dengan menggunakan perintah garis miring /createUserStory, Charlie membuat cerita.

• 

  Gambar 3. Aplikasi Chat pengelolaan project menggunakan Vertex AI untuk menulis deskripsi cerita, lalu membagikan cerita di ruang.

• 

  Gambar 4. Charlie mengklik Edit untuk menyelesaikan detail cerita. Deskripsi AI akurat, tetapi Charlie menginginkan detail lebih lanjut, jadi Charlie mengklik Perluas agar Vertex AI menambahkan persyaratan ke deskripsi cerita. Charlie menetapkan cerita untuk dirinya sendiri, menetapkan status ke dimulai, memilih prioritas dan ukuran yang sesuai, lalu mengklik Simpan.

• 

  Gambar 5. Kapan saja, Charlie dapat melihat dan mengelola semua cerita pengguna tim dengan perintah garis miring /manageUserStories.

Prasyarat

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.

• Akses ke layanan Google Cloud untuk melakukan hal berikut:

  • Membuat project Google Cloud.
  • Tautkan akun penagihan Google Cloud ke project Cloud. Untuk mempelajari apakah Anda memiliki akses, lihat Izin yang diperlukan untuk mengaktifkan penagihan.

  • Gunakan pemanggilan Google Cloud Function yang tidak diautentikasi, yang dapat Anda verifikasi dengan menentukan apakah organisasi Google Cloud Anda menggunakan berbagi yang dibatasi domain.

  Jika perlu, minta akses atau izin kepada administrator Google Cloud Anda.

• Jika menggunakan Google Cloud CLI, lingkungan pengembangan Node.js yang dikonfigurasi untuk bekerja dengan gcloud CLI. Lihat Menyiapkan lingkungan pengembangan Node.js.

Tujuan

• Buat aplikasi Chat yang mengelola project software agile.
• Membantu pengguna menulis kisah pengguna dengan alat penulisan cerita yang dibantu AI generatif dan didukung oleh Vertex AI:
  • Membuat dan membuat ulang deskripsi cerita.
  • Perluas deskripsi cerita dari catatan untuk menyelesaikan persyaratan.
  • Perbaiki tata bahasa untuk memperbaiki kesalahan ketik.
• Selalu perbarui pekerjaan dengan menulis ke dan membaca dari database Firestore.
• Memfasilitasi kolaborasi di ruang Chat dengan mengizinkan pengguna membuat, mengedit, menetapkan, dan memulai cerita langsung dari percakapan.

Produk yang digunakan

Aplikasi pengelolaan project menggunakan produk Google Workspace dan Google Cloud berikut:

• Chat API: API untuk mengembangkan aplikasi Google Chat yang menerima dan merespons peristiwa interaksi Chat, seperti pesan. Aplikasi Google Chat untuk pengelolaan project menggunakan Chat API untuk menerima dan merespons peristiwa interaksi yang dikirim oleh Chat, serta mengonfigurasi atribut yang menentukan tampilannya di Chat, seperti nama dan gambar avatar.
• Vertex AI API: Platform AI generatif. Aplikasi Google Chat untuk pengelolaan project menggunakan Vertex AI API untuk menulis judul dan deskripsi cerita pengguna.
• Firestore: Database dokumen serverless. Aplikasi Google Chat untuk pengelolaan project menggunakan Firebase untuk menyimpan data tentang kisah pengguna.

• Cloud Functions: Layanan komputasi serverless yang ringan memungkinkan Anda membuat fungsi mandiri dengan tujuan tunggal yang dapat merespons peristiwa interaksi Chat tanpa perlu mengelola server atau lingkungan runtime. Aplikasi Google Chat untuk pengelolaan project menggunakan Cloud Functions untuk menghosting endpoint HTTP yang menerima peristiwa interaksi dari Chat dan sebagai platform komputasi untuk menjalankan logika yang memproses dan merespons peristiwa ini.

  Cloud Functions menggunakan produk Google Cloud berikut untuk mem-build, memproses peristiwa interaksi, dan menghosting resource komputasi:

  • Cloud Build: Platform continuous integration, pengiriman, dan deployment yang terkelola sepenuhnya yang menjalankan build otomatis.
  • Pub/Sub: Layanan pesan asinkron dan skalabel yang memisahkan layanan yang menghasilkan pesan dari layanan yang memproses pesan tersebut.
  • Cloud Run Admin API: Lingkungan terkelola sepenuhnya untuk menjalankan aplikasi dalam container.

Arsitektur

Arsitektur aplikasi Google Chat untuk pengelolaan project menerima dan memproses peristiwa interaksi Chat di endpoint HTTP, menggunakan Vertex AI untuk membantu menulis cerita pengguna, dan menyimpan detail cerita pengguna dalam database Firestore. Diagram berikut menunjukkan arsitektur resource Google Workspace dan Google Cloud yang digunakan.

Aplikasi Google Chat untuk manajemen proyek berfungsi seperti ini:

1. Pengguna mengirim pesan di Chat dan memanggil aplikasi Google Chat project management dengan mengirim pesan langsung ke aplikasi, menyebutkannya di ruang, atau memasukkan perintah garis miring.

2. Chat mengirimkan permintaan HTTP sinkron ke endpoint HTTP Cloud Function.

3. Aplikasi Google Chat pengelolaan project memproses permintaan HTTP:

   1. Vertex AI membantu menulis atau memperbarui kisah pengguna.

   2. Database Firestore menyimpan, mengambil, memperbarui, atau menghapus data cerita pengguna.

4. Cloud Functions menampilkan respons HTTP ke Chat yang menampilkannya kepada pengguna sebagai pesan atau dialog.

Menyiapkan lingkungan

Bagian ini menunjukkan cara membuat dan mengonfigurasi project Google Cloud untuk aplikasi Chat.

Membuat project Google Cloud

Konsol Google Cloud

1. Di konsol Google Cloud, buka Menu > IAM & Admin > Create a Project.

   Buka Membuat Project

2. Di kolom Project Name, masukkan nama deskriptif untuk project Anda.

   Opsional: Untuk mengedit Project ID, klik Edit. Project ID tidak dapat diubah setelah project dibuat, jadi pilih ID yang sesuai dengan kebutuhan Anda sepanjang waktu project tersebut.

3. Di kolom Lokasi, klik Jelajah untuk menampilkan potensi lokasi untuk project Anda. Kemudian, klik Select.
   Perhatian: Tidak dapat menemukan organisasi Google Workspace Anda?
   Artinya, Anda tidak login ke akun Google Workspace. Beberapa fitur yang dijelaskan dalam dokumentasi developer Google Workspace hanya tersedia untuk project yang terkait dengan organisasi.
4. Klik Buat. Konsol Google Cloud akan membuka halaman Dasbor dan project Anda akan dibuat dalam beberapa menit.

gcloud CLI

Di salah satu lingkungan pengembangan berikut, akses Google Cloud CLI (gcloud):

• Cloud Shell: Untuk menggunakan terminal online dengan gcloud CLI yang sudah disiapkan, aktifkan Cloud Shell.
  Aktifkan Cloud Shell
• Shell Lokal: Untuk menggunakan lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI.
  Untuk membuat project Cloud, gunakan perintah gcloud projects create:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan menetapkan ID untuk project yang ingin Anda buat.

Mengaktifkan penagihan untuk project Cloud

Jika tidak dapat menautkan akun penagihan, berarti Anda tidak memiliki izin yang diperlukan untuk melakukan perubahan ini. Untuk mengetahui informasi selengkapnya, lihat Izin yang diperlukan untuk mengaktifkan penagihan.

Konsol Google Cloud

1. Di konsol Google Cloud, buka Penagihan. Klik Menu > Penagihan > Project Saya.

   Buka Penagihan untuk Project Saya

2. Di Pilih organisasi, pilih organisasi yang terkait dengan project Google Cloud Anda.
3. Di baris project, buka menu Tindakan (), klik Ubah penagihan, lalu pilih akun Penagihan Cloud.
4. Klik Tetapkan akun.

gcloud CLI

1. Untuk mencantumkan akun penagihan yang tersedia, jalankan:

   gcloud billing accounts list

2. 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 dengan project Google Cloud.

Mengaktifkan API

Konsol Google Cloud

1. Di konsol Google Cloud, aktifkan Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API, dan Cloud Run Admin API.

   Aktifkan API

2. Pastikan Anda mengaktifkan API di project Cloud yang benar, lalu klik Berikutnya.

3. Pastikan Anda mengaktifkan API yang benar, lalu klik Aktifkan.

gcloud CLI

1. 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 Anda buat.

2. Aktifkan Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API, dan Cloud Run Admin API dengan perintah gcloud services enable:

   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, dan Cloud Run Admin API adalah prasyarat Cloud Functions.

Autentikasi dan otorisasi

Tidak diperlukan konfigurasi autentikasi dan otorisasi untuk mengikuti tutorial ini.

Untuk memanggil API Firestore dan Vertex AI, tutorial ini menggunakan Application Default Credentials dengan akun layanan default yang terlampir pada Cloud Function, yang tidak perlu Anda siapkan. Dalam konteks lingkungan produksi, Anda biasanya membuat dan melampirkan akun layanan ke Cloud Function.

Membuat dan men-deploy aplikasi Google Chat

Setelah project Google Cloud Anda dibuat dan dikonfigurasi, Anda siap untuk membuat dan men-deploy aplikasi Google Chat. Di bagian ini, Anda akan melakukan hal berikut:

1. Buat database Firestore untuk menyimpan dan mengambil cerita pengguna.
2. Tinjau kode contoh secara opsional.
3. Buat Cloud Function untuk menghosting dan menjalankan kode aplikasi Chat sebagai respons terhadap peristiwa yang diterima dari Chat sebagai permintaan HTTP.
4. Buat dan deploy aplikasi Google Chat di halaman konfigurasi Google Chat API.

Buat database Firestore

Di bagian ini, Anda akan membuat database Firestore untuk menyimpan dan mengambil cerita pengguna, tetapi Anda tidak menentukan model data. Model data ditetapkan secara implisit dalam kode contoh oleh file model/user-story.js dan model/user.js.

Database aplikasi Chat untuk pengelolaan project menggunakan model data NoSQL berdasarkan dokumen yang disusun ke dalam koleksi . Untuk mempelajari lebih lanjut, lihat Model data Firestore.

Diagram berikut adalah ringkasan model data aplikasi Google Chat untuk pengelolaan project:

Koleksi root adalah spaces, yang setiap dokumennya mewakili ruang tempat aplikasi Chat membuat cerita. Setiap kisah pengguna diwakili oleh dokumen dalam subkoleksi userStories, dan setiap pengguna diwakili oleh dokumen dalam subkoleksi users.

Melihat definisi koleksi, dokumen, dan kolom

spaces

Ruang tempat aplikasi Chat membuat cerita.

Kolom
Document ID	String ID unik ruang tertentu tempat cerita dibuat. Sesuai dengan nama resource ruang di Chat API.
userStories	Subcollection of Documents (userStories) Kisah yang dibuat oleh aplikasi Chat dan penggunanya. Sesuai dengan Document ID dari userStories di Firebase.
users	Subcollection of Documents (user) Pengguna yang membuat atau yang diberi tugas cerita.
displayName	String Nama tampilan ruang di Chat API. Tidak ditetapkan untuk pesan langsung dengan pengguna.

userStories

Kisah yang dibuat oleh aplikasi Chat dan penggunanya.

Kolom
Document ID	String ID unik dari kisah pengguna tertentu yang dibuat oleh aplikasi Chat dan penggunanya.
assignee	Document (user) Nama resource pengguna yang ditetapkan untuk menyelesaikan cerita. Sesuai dengan Document ID dokumen users dan dengan nama resource pengguna di Chat API.
description	String Deskripsi fitur software dari sudut pandang pengguna.
priority	Enum Seberapa mendesak pekerjaan harus diselesaikan. Nilai yang mungkin adalah Low, Medium, atau High.
size	Enum Jumlah pekerjaan. Nilai yang mungkin adalah Small, Medium, atau Large.
status	Enum Fase pekerjaan. Nilai yang mungkin adalah OPEN, STARTED, atau COMPLETED.
title	String Judul cerita; ringkasan singkat.

users

Pengguna yang membuat atau yang diberi tugas untuk membuat cerita.

Kolom
Document ID	String ID unik pengguna tertentu. Sesuai dengan assignee dari userStories di Firebase, dan dengan nama resource pengguna di Chat API.
avatarUrl	String URL yang menghosting gambar avatar Chat pengguna.
displayName	String Nama tampilan Chat pengguna.

Berikut cara membuat database Firestore:

Konsol Google Cloud

1. Di konsol Google Cloud, buka Firestore. Klik Menu > Firestore.

   Buka Firestore

2. Klik Buat database.

3. Dari Pilih mode Firestore Anda, klik Native mode.

4. Klik Lanjutkan.

5. Konfigurasi database:

   1. Di Name your database, biarkan Database ID sebagai (default).

   2. Di Jenis lokasi, tentukan region untuk database Anda, seperti us-central1. Untuk mendapatkan performa terbaik, pilih lokasi yang sama atau terdekat dengan Cloud Function aplikasi Chat.

6. Klik Buat database.

gcloud CLI

• Buat database Firestore dalam mode Native dengan perintah gcloud firestore databases create:

  gcloud firestore databases create \
  --location=LOCATION \
  --type=firestore-native

  Ganti LOCATION dengan nama region Firestore, seperti us-central1.

Meninjau kode contoh

Atau, sebelum membuat Cloud Function, luangkan waktu untuk meninjau dan memahami contoh kode yang dihosting di GitHub.

Lihat di GitHub

Berikut ringkasan setiap file:

env.js

Variabel konfigurasi lingkungan untuk men-deploy aplikasi Chat ke project dan region Google Cloud yang ditentukan. Anda harus memperbarui variabel konfigurasi dalam file ini.

package.json dan package-lock.json

Setelan dan dependensi project Node.js.

index.js

Titik entri untuk Cloud Function aplikasi Chat. Fungsi ini membaca peristiwa Chat dari permintaan HTTP, memanggil pengendali aplikasi, dan memposting respons HTTP sebagai objek JSON.

controllers/app.js

Logika aplikasi utama. Memproses peristiwa interaksi dengan menangani sebutan aplikasi Chat dan perintah garis miring. Untuk merespons klik kartu, fungsi ini memanggil app-action-handler.js.

controllers/app-action-handler.js

Logika aplikasi untuk menangani klik kartu Peristiwa interaksi chat.

services/space-service.js, services/user-service.js, dan services/user-story-service.js

File ini berisi bagian logika aplikasi yang khusus untuk bekerja dengan ruang Chat, pengguna, dan cerita pengguna. Fungsi dalam file ini dipanggil oleh app.js atau app-action-handler.js. Untuk melakukan operasi database, fungsi dalam file ini memanggil fungsi di firestore-service.js.

services/firestore-service.js

Menangani operasi database. Fungsi dalam file ini dipanggil oleh services/space-service.js, services/user-service.js, dan services/user-story-service.js.

services/aip-service.js

Memanggil Vertex AI API untuk prediksi teks AI generatif.

model/*.js

File ini berisi definisi class dan enum yang digunakan layanan aplikasi untuk menyimpan dan meneruskan data antar-fungsi. Mereka menetapkan model data untuk database Firestore.

views/*.js

Setiap file dalam direktori ini membuat instance objek kartu yang kemudian dikirim kembali ke Chat oleh aplikasi Chat sebagai pesan kartu atau respons tindakan dialog.

views/widgets/*.js

Setiap file meng-instansiasi objek widget yang digunakan aplikasi untuk membuat kartu di direktori views/.

test/**/*.test.js

Setiap file dalam direktori ini dan subdirektorinya berisi pengujian unit untuk fungsi, pengontrol, layanan, tampilan, atau widget yang sesuai. Anda dapat menjalankan semua pengujian unit dengan menjalankan npm run test saat berada di direktori root project.

Membuat dan men-deploy Cloud Function

Di bagian ini, Anda akan membuat dan men-deploy Cloud Function yang terdiri dari logika aplikasi aplikasi Chat manajemen project.

Cloud Function berjalan sebagai respons terhadap permintaan HTTP dari Chat yang berisi peristiwa interaksi Chat. Saat dijalankan, kode Cloud Function akan memproses peristiwa dan mengembalikan respons ke Chat yang dirender Chat sebagai pesan, dialog, atau jenis interaksi pengguna lainnya. Jika berlaku, Cloud Function juga membaca dari, atau menulis ke, database Firestore.

Berikut cara membuat Cloud Function:

Konsol Google Cloud

1. Download kode dari GitHub sebagai file ZIP.

   Download file ZIP

2. Ekstrak file zip yang didownload.

   Folder yang diekstrak berisi seluruh repositori contoh Google Workspace.

3. Di folder yang diekstrak, buka google-chat-samples-main/node/project-management-app/, lalu kompres folder project-management-app menjadi file zip.

   Direktori root file zip harus berisi file dan folder berikut:

   • env.js
   • README.md
   • gcloudignore.text
   • package-lock.json
   • package.json
   • index.js
   • model/
   • controllers/
   • views/
   • services/

4. Di konsol Google Cloud, buka halaman Cloud Functions:

   Buka Cloud Functions

   Pastikan project Google Cloud untuk aplikasi Chat Anda dipilih.

5. Klik Create Function.

6. Di halaman Create function, siapkan fungsi Anda:

   1. Di Environment, pilih Cloud Run Function.
   2. Di Function name, masukkan project-management-tutorial.
   3. Di Region, pilih wilayah.
   4. Di bagian Autentikasi, pilih Izinkan pemanggilan yang tidak diautentikasi.
   5. Klik Berikutnya.

7. Di Runtime, pilih Node.js 20.

8. Di Entry point, hapus teks default dan masukkan projectManagementChatApp.

9. Di Kode sumber, pilih Upload ZIP.

10. Di Destination bucket, buat atau pilih bucket:

    1. Klik Browse.
    2. Pilih bucket.
    3. Klik Pilih.

    Google Cloud mengupload file zip ke dan mengekstrak file komponen di bucket ini. Cloud Functions kemudian menyalin file komponen ke dalam Cloud Function.

11. Di File ZIP, upload file ZIP yang Anda download dari GitHub, ekstrak, dan kompresi ulang:

    1. Klik Browse.
    2. Buka dan pilih file zip.
    3. Klik Buka.

12. Klik Deploy.

    Halaman Cloud Functions detail akan terbuka, dan fungsi Anda akan muncul dengan dua indikator progres: satu untuk build dan satu untuk layanan. Saat kedua indikator progres menghilang dan digantikan dengan tanda centang, fungsi Anda telah di-deploy dan siap.

13. Edit kode contoh untuk menetapkan konstanta:

    1. Di halaman Detail Cloud Function, klik Edit.
    2. Klik Berikutnya.
    3. Di Source code, pilih Inline editor.
    4. Di editor inline, buka file env.js.
    5. Ganti project-id dengan project ID Google Cloud Anda.
    6. Opsional: Perbarui us-central1 dengan lokasi yang didukung untuk Cloud Function Anda.

14. Klik Deploy.

15. Setelah fungsi selesai di-deploy, salin URL pemicu:

    1. Di halaman Function details, klik Trigger.
    2. Salin URL-nya. Anda akan memerlukannya untuk mengonfigurasi aplikasi Chat di bagian berikutnya.

gcloud CLI

1. Clone kode dari GitHub:

   git clone https://github.com/googleworkspace/google-chat-samples.git

2. Beralih ke direktori yang menyimpan kode untuk aplikasi Chat pengelolaan project ini:

   cd google-chat-samples/node/project-management-app

3. Edit file env.js untuk menetapkan variabel lingkungan:

   1. Ganti project-id dengan ID project Google Cloud Anda.
   2. Ganti us-central1 dengan lokasi project Google Cloud Anda.

4. Deploy Cloud Function ke Google Cloud:

   gcloud functions deploy project-management-tutorial \
   --gen2 \
   --region=REGION \
   --runtime=nodejs20 \
   --source=. \
   --entry-point=projectManagementChatApp \
   --trigger-http \
   --allow-unauthenticated

   Ganti REGION dengan lokasi Cloud Function tempat infrastrukturnya dihosting, seperti us-central1.

1. Setelah fungsi selesai di-deploy, salin properti url dari respons. Ini adalah URL Pemicu yang Anda gunakan di bagian berikut untuk mengonfigurasi aplikasi Google Chat.

Mengonfigurasi aplikasi Google Chat di konsol Google Cloud

Bagian ini menunjukkan cara mengonfigurasi Chat API di konsol Google Cloud dengan informasi tentang aplikasi Chat Anda, termasuk nama aplikasi Chat, perintah garis miring yang didukung, dan URL pemicu Cloud Function aplikasi Chat yang mengirimkan peristiwa interaksi Chat.

1. Di konsol Google Cloud, klik Menu > More products > Google Workspace > Product Library > Google Chat API > Manage > Configuration.

   Buka konfigurasi Chat API

2. Di Nama aplikasi, ketik Project Manager.

3. Di Avatar URL, ketik https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. Di Deskripsi, ketik Manages projects with user stories.

5. Klik tombol Aktifkan fitur Interaktif ke posisi aktif.

6. Di bagian Functionality, pilih Join spaces and group conversations.

7. Di bagian Connection settings, pilih HTTP endpoint URL.

8. Di HTTP endpoint URL, tempelkan URL Pemicu yang Anda salin dari deployment Cloud Functions, yang diformat sebagai https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Jika Anda men-deploy Cloud Function dengan gcloud CLI, ini adalah properti url.

9. Daftarkan perintah garis miring aplikasi Chat. Untuk mendaftarkan perintah garis miring:

   1. Di bagian Commands, klik Add a command.

   2. Untuk setiap perintah miring yang dijelaskan dalam tabel berikut, masukkan Nama, ID Perintah, Deskripsi, dan pilih apakah perintah miring Membuka dialog, lalu klik Selesai:

      Nama	ID Perintah	Deskripsi	Jenis perintah	Nama perintah garis miring	Membuka dialog
      Membuat {i>user story<i}	1	Membuat cerita dengan judul yang ditentukan.	Perintah garis miring	/createUserStory	Batal dipilih
      Kisah pengguna saya	2	Mencantumkan semua artikel yang ditetapkan kepada pengguna.	Perintah garis miring	/myUserStories	Batal dipilih
      Kisah pengguna	3	Menampilkan status saat ini dari cerita yang ditentukan.	Perintah garis miring	/userStory	Batal dipilih
      Mengelola {i>user story<i}	4	Membuka dialog tempat cerita dapat diedit.	Perintah garis miring	/manageUserStories	Dipilih
      Membersihkan cerita pengguna	5	Menghapus semua cerita di ruang.	Perintah garis miring	/cleanupUserStories	Batal dipilih

10. Di bagian Visibilitas, pilih Jadikan aplikasi Chat ini tersedia untuk orang dan grup tertentu di domain Workspace Anda, lalu masukkan alamat email Anda.

11. Secara opsional, di bagian Logs, pilih Log errors to Logging.

12. Klik Simpan. Pesan konfigurasi tersimpan akan muncul, yang berarti aplikasi Chat siap diuji.

Menguji aplikasi Chat

Uji aplikasi Chat pengelolaan project dengan mengirimkan pesan ke aplikasi tersebut dan menggunakan perintah garis miringnya untuk membuat, mengedit, dan menghapus cerita pengguna.

1. Buka Google Chat menggunakan akun Google Workspace yang Anda berikan saat menambahkan diri Anda sebagai penguji tepercaya.

   Buka Google Chat.

2. Klik Percakapan baru.
3. Di kolom Tambahkan 1 orang atau lebih, ketik nama aplikasi Chat Anda.

4. Pilih aplikasi Chat Anda dari hasil. Pesan langsung akan terbuka.

   Catatan: Jika Anda tidak melihat aplikasi Chat di daftar hasil, pastikan Anda telah menyertakan akun Google Workspace Anda dalam setelan Visibilitas di halaman Konfigurasi Chat API di konsol Google Cloud.
5. Di pesan langsung baru dengan aplikasi, ketik Hello, lalu tekan enter. Aplikasi Chat manajemen project merespons dengan menu bantuan yang menjelaskan apa yang dapat dilakukannya.
6. Untuk membuat cerita, ketik /createUserStory Test story di panel pesan, lalu kirim. Aplikasi Chat manajemen project merespons dengan pesan kartu yang menjelaskan skenario pengguna yang dibuatnya untuk Anda menggunakan AI generatif dari Vertex AI.

7. Di konsol, periksa database Firestore untuk meninjau data yang dibuatnya tentang ruang tempat Anda menambahkan aplikasi Chat, pengguna yang telah berinteraksi dengannya, dan skenario pengguna yang Anda buat.

   Buka Firestore

8. Kembali ke Google Chat.

   Buka Google Chat.

9. Jika perlu, klik Edit untuk mengedit cerita. Jika Anda sudah puas dengan cerita tersebut, klik Simpan.
10. Uji setiap perintah garis miring yang didukung oleh aplikasi. Untuk melihatnya, ketik / atau sebutkan aplikasi Chat.
11. Hapus cerita pengguna pengujian dengan mengeluarkan perintah garis miring /cleanupUserStories. Atau, hapus atau uninstal aplikasi. Jika dihapus, aplikasi akan menghapus semua cerita pengguna yang dibuat di ruang tersebut.

Memecahkan masalah

Saat aplikasi atau kartu Google Chat menampilkan error, antarmuka Chat akan menampilkan pesan yang mengatakan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error apa pun, tetapi aplikasi atau kartu Chat menghasilkan hasil yang tidak terduga; misalnya, pesan kartu mungkin tidak muncul.

Meskipun pesan error mungkin tidak ditampilkan di UI Chat, pesan error deskriptif dan data log tersedia untuk membantu Anda memperbaiki error jika logging error untuk aplikasi Chat diaktifkan. Untuk mendapatkan bantuan dalam melihat, men-debug, dan memperbaiki error, lihat Memecahkan masalah dan memperbaiki error Google Chat.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, sebaiknya hapus project Cloud tersebut.

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tutorial ini, saat menghapusnya, Anda juga akan menghapus pekerjaan lain yang telah dilakukan dalam project tersebut.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang masih ingin Anda gunakan pada masa mendatang. Untuk mempertahankan URL yang menggunakan project ID tersebut, seperti URL di appspot.com, hapus resource yang dipilih di dalam project, alih-alih menghapus seluruh project.

Jika Anda berencana mempelajari beberapa tutorial dan panduan memulai, menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di Konsol Google Cloud, buka halaman Manage resources. Klik Menu > IAM & Admin > Kelola Resource.

   Buka Resource Manager

2. Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus .
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Topik terkait

• Menjawab pertanyaan berdasarkan percakapan Chat dengan aplikasi Chat AI Gemini
• Merespons insiden dengan Google Chat, Vertex AI, dan Apps Script