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 cerita pengguna (yang mewakili fitur sistem software dari sudut pandang pengguna untuk dikembangkan oleh tim) dan mempertahankan cerita tersebut dalam database Firestore.

• 

  Gambar 1. Charlie membahas pengembangan fitur di ruang Chat dengan timnya. Dengan menyebutkan aplikasi Chat pengelolaan project, aplikasi Chat akan 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 tersebut di ruang.
• 
  Gambar 4. Charlie mengklik Edit untuk menyelesaikan detail cerita. Deskripsi AI sudah akurat, tetapi Candra menginginkan detail lebih lanjut, jadi Candra mengklik Luaskan agar Vertex AI menambahkan persyaratan ke deskripsi cerita. Charlie menetapkan cerita tersebut kepada dirinya sendiri, menetapkan status ke dimulai, memilih prioritas dan ukuran yang sesuai, lalu mengklik Simpan.
• 
  Gambar 5. Candra dapat melihat dan mengelola semua cerita pengguna tim dengan perintah garis miring /manageUserStories kapan saja.

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 mengetahui apakah Anda memiliki akses, lihat Izin yang diperlukan untuk mengaktifkan penagihan.

  • Gunakan pemanggilan Fungsi Google Cloud 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 berfungsi dengan gcloud CLI. Lihat Menyiapkan lingkungan pengembangan Node.js.

Tujuan

• Buat aplikasi Chat yang mengelola project software yang gesit.
• Bantu pengguna menulis cerita pengguna dengan alat penulisan cerita yang dibantu AI generatif yang didukung oleh Vertex AI:
  • Membuat dan membuat ulang deskripsi cerita.
  • Perluas deskripsi cerita dari catatan untuk memenuhi persyaratan.
  • Memperbaiki tata bahasa untuk memperbaiki kesalahan ketik.
• Menjaga agar pekerjaan tetap terbaru dengan menulis ke, dan membaca dari, database Firestore.
• Fasilitasi kolaborasi di ruang Chat dengan memungkinkan 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 pengelolaan project menggunakan Chat API untuk menerima dan merespons peristiwa interaksi yang dikirim oleh Chat, dan untuk mengonfigurasi atribut yang menentukan cara munculnya di Chat, seperti nama dan gambar avatar.
• Vertex AI API: Platform AI generatif. Aplikasi Google Chat manajemen project menggunakan Vertex AI API untuk menulis judul dan deskripsi cerita pengguna.
• Firestore: Database dokumen serverless. Aplikasi Google Chat manajemen project menggunakan Firebase untuk menyimpan data tentang cerita 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 pengelolaan project menggunakan Cloud Functions untuk menghosting endpoint HTTP yang menjadi tujuan pengiriman peristiwa interaksi oleh 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, penayangan, 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 yang terkelola sepenuhnya untuk menjalankan aplikasi dalam container.

Arsitektur

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

Cara kerja aplikasi Google Chat pengelolaan project adalah seperti ini:

1. Pengguna mengirim pesan di Chat dan memanggil aplikasi Google Chat pengelolaan project dengan mengirim pesan langsung, 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 cerita 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 yang sesuai dengan kebutuhan Anda sepanjang waktu project tersebut.

3. Di kolom Location, klik Browse untuk menampilkan lokasi potensial 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 Billing. 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 Actions (), klik Change billing, lalu pilih akun Penagihan Cloud.
4. Klik Tetapkan akun.

gcloud CLI

1. Untuk mencantumkan akun penagihan yang tersedia, jalankan:

   gcloud billing accounts list

2. Menautkan 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 Next.

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

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 untuk 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 untuk Cloud Functions.

Autentikasi dan otorisasi

Tidak diperlukan konfigurasi autentikasi dan otorisasi untuk mengikuti tutorial ini.

Untuk memanggil Firestore dan Vertex AI API, tutorial ini menggunakan Kredensial Default Aplikasi dengan akun layanan default yang dilampirkan ke Cloud Function, yang tidak perlu Anda siapkan. Dalam konteks lingkungan produksi, Anda biasanya akan create dan melampirkan akun layanan ke Cloud Function.

Membuat dan men-deploy aplikasi Google Chat

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

1. Buat database Firestore untuk mempertahankan dan mengambil cerita pengguna.
2. Secara opsional, tinjau kode contoh.
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.

Membuat database Firestore

Di bagian ini, Anda akan membuat database Firestore untuk mempertahankan 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 pengelolaan project menggunakan model data NoSQL berdasarkan dokumen yang diatur ke dalam koleksi . Untuk mempelajari lebih lanjut, lihat Model data Firestore.

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

Kumpulan root adalah spaces, dengan setiap dokumen mewakili ruang tempat aplikasi Chat membuat cerita. Setiap cerita 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) Cerita 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 ditugaskan cerita.
displayName	String Nama tampilan ruang di Chat API. Tidak ditetapkan untuk pesan langsung dengan pengguna.

userStories

Cerita yang dibuat oleh aplikasi Chat dan penggunanya.

Kolom
Document ID	String ID unik dari cerita pengguna tertentu yang dibuat oleh aplikasi Chat dan penggunanya.
assignee	Document (user) Nama resource pengguna yang ditugaskan 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 Urgensi untuk menyelesaikan pekerjaan. Nilai yang mungkin adalah Low, Medium, atau High.
size	Enum Jumlah pekerjaan. Nilai yang mungkin adalah Small, Medium, atau Large.
status	Enum Fase kerja. Nilai yang mungkin adalah OPEN, STARTED, atau COMPLETED.
title	String Judul cerita; ringkasan singkat.

users

Pengguna yang membuat atau yang diberi cerita.

Kolom
Document ID	String ID unik pengguna tertentu. Sesuai dengan assignee 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, klik Native mode.

4. Klik Lanjutkan.

5. Konfigurasikan database:

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

   2. Pada Location type, tentukan region untuk database, seperti us-central1. Untuk mendapatkan performa terbaik, pilih lokasi yang sama atau dekat 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 mempelajari kode contoh yang dihosting di GitHub.

Lihat di GitHub

Berikut ringkasan setiap filenya:

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. Metode 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 perintah garis miring dan sebutan aplikasi Chat. Untuk merespons klik kartu, metode 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 dari logika aplikasi yang khusus untuk menggunakan 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. Model data ini menetapkan database Firestore.

views/*.js

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

views/widgets/*.js

Setiap file membuat instance jenis objek widget yang digunakan aplikasi untuk mem-build 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 pengelolaan project.

Cloud Function berjalan sebagai respons terhadap permintaan HTTP dari Chat yang berisi peristiwa interaksi Chat. Saat dijalankan, kode Cloud Function memproses peristiwa dan menampilkan respons ke Chat yang dirender oleh 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.

   Mendownload 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 kompresi folder project-management-app menjadi file zip.

   Direktori utama 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 Authentication, pilih Allow unauthenticated invocations.
   5. Klik Berikutnya.

7. Di Runtime, pilih Node.js 20.

8. Di Titik entri, hapus teks default, lalu 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, diekstrak, dan dikompresi ulang:

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

12. Klik Deploy.

    Halaman Detail Cloud Functions akan terbuka, dan fungsi Anda akan muncul dengan dua indikator progres: satu untuk build dan satu untuk layanan. Saat kedua indikator progres menghilang dan diganti dengan tanda centang, fungsi Anda akan 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 Detail fungsi, klik Pemicu.
    2. Salin URL-nya. Anda memerlukannya untuk mengonfigurasi aplikasi Chat di bagian berikut.

gcloud CLI

1. Clone kode dari GitHub:

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

2. Beralihlah 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. Men-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 dari Cloud Function aplikasi Chat yang menjadi tujuan pengiriman peristiwa interaksi Chat.

1. Di konsol Google Cloud, klik Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API > Kelola > Konfigurasi.

   Buka konfigurasi Chat API

2. Di App name, 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 Receive 1:1 messages, Join spaces and group conversations.

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

8. Di HTTP endpoint URL, tempel URL Pemicu yang Anda salin dari deployment Cloud Functions, dengan format 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 Slash commands, klik Add a slash command.

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

      Nama	ID Perintah	Deskripsi	Membuka dialog
      /createUserStory	1	Buat cerita dengan judul yang ditentukan.	Batal dipilih
      /myUserStories	2	Mencantumkan semua cerita yang ditetapkan ke pengguna.	Batal dipilih
      /userStory	3	Menampilkan status saat ini dari cerita yang ditentukan.	Batal dipilih
      /manageUserStories	4	Membuka dialog tempat cerita dapat diedit.	Dipilih
      /cleanupUserStories	5	Menghapus semua artikel di ruang.	Batal dipilih

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

11. Atau, 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 mengirim pesan ke aplikasi tersebut dan menggunakan perintah garis miring untuk membuat, mengedit, dan menghapus cerita pengguna.

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

   Buka Google Chat

2. Klik Chat 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 dalam daftar hasil, pastikan Anda telah menyertakan akun Google Workspace di 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 pengelolaan project akan merespons dengan pesan kartu yang menjelaskan cerita pengguna yang dibuat 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 cerita pengguna yang Anda buat.

   Buka Firestore

8. Kembali ke Google Chat.

   Buka Google Chat

9. Atau, untuk mengedit cerita, klik Edit. Jika Anda puas dengan cerita, 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 Google Chat atau kartu menampilkan error, antarmuka Chat akan menampilkan pesan yang bertuliskan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error, 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 saat logging error untuk aplikasi Chat diaktifkan. Untuk mendapatkan bantuan dalam melihat, melakukan proses 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.

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 untuk mempelajari berbagai 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 > Manage Resources.

   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 Gemini AI Chat
• Merespons insiden dengan Google Chat, Vertex AI, dan Apps Script