Membangun aplikasi Google Chat dengan agen AI Gemini Enterprise

Halaman ini menjelaskan cara mem-build add-on Google Workspace yang berfungsi di Google Chat dan berinteraksi dengan agen AI Gemini Enterprise.

Agen AI secara otonom memahami lingkungan, menalar, dan menjalankan tindakan multilangkah yang kompleks untuk mencapai tujuan yang ditentukan. Dalam tutorial ini, Anda akan menggunakan agen Pembuatan Ide yang disediakan secara default oleh Google yang membantu inovasi dan pemecahan masalah bagi pengguna versi bisnis.

Diagram berikut menunjukkan arsitektur dan pola pesan:

Dalam diagram sebelumnya, pengguna yang berinteraksi dengan aplikasi Chat yang diimplementasikan dengan agen AI Gemini Enterprise memiliki alur informasi berikut:

1. Pengguna mengirim pesan ke aplikasi Chat, baik di pesan langsung maupun di ruang Chat.
2. Logika aplikasi Chat yang diimplementasikan di Apps Script atau sebagai server web dengan endpoint HTTP menerima dan memproses pesan.
3. Agen AI Gemini Enterprise menerima dan memproses interaksi.
4. Secara opsional, aplikasi Chat atau agen AI dapat berintegrasi dengan layanan Google Workspace, seperti Kalender atau Spreadsheet, atau layanan Google lainnya, seperti Google Maps atau YouTube.
5. Aplikasi Chat mengirim respons secara asinkron menggunakan Google Chat API untuk mengomunikasikan progres agen AI.
6. Respons dikirimkan kepada pengguna.

Tujuan

• Menyiapkan lingkungan Anda.
• Men-deploy aplikasi Chat.
• Mengonfigurasi aplikasi Chat.
• Menguji aplikasi Chat.

Prasyarat

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
• Project Google Cloud yang mengaktifkan penagihan. Untuk memeriksa apakah penagihan diaktifkan untuk project yang ada, lihat Memverifikasi status penagihan project Anda. Untuk membuat project dan menyiapkan penagihan, lihat Membuat project Google Cloud.
• Aplikasi Gemini Enterprise yang disiapkan dengan Google Identity sebagai penyedia identitas.

Menyiapkan lingkungan Anda

Mengaktifkan Chat API

Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.

Di konsol Google Cloud, aktifkan Google Chat API.

Mengaktifkan API

Mengonfigurasi layar izin OAuth

Semua aplikasi yang menggunakan OAuth 2.0 memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth aplikasi Anda menentukan apa yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi Anda sehingga Anda dapat memublikasikannya nanti.

1. Di Konsol Google API, buka Menu menu > Platform Google Auth > Branding.

   Buka Branding

2. Jika sudah mengonfigurasi platform Google Auth, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth platform not configured yet, klik Get Started:
1. Di bagian App Information, di App name, masukkan nama untuk aplikasi.
2. Di User support email, pilih alamat email dukungan tempat pengguna dapat menghubungi Anda jika mereka memiliki pertanyaan tentang izin mereka.
3. Klik Next.
4. Di bagian Audience, pilih Internal.
5. Klik Next.
6. Di bagian Contact Information, masukkan Email address tempat Anda dapat diberi tahu tentang perubahan apa pun pada project Anda.
7. Klik Next.
8. Di bagian Finish, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih I agree to the Google API Services: User Data Policy.
9. Klik Continue.
10. Klik Create.
3. Untuk saat ini, Anda dapat melewati penambahan cakupan. Pada masa mendatang, saat membuat aplikasi untuk digunakan di luar organisasi Google Workspace Anda, Anda harus mengubah User type menjadi External. Kemudian, tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan lengkap Mengonfigurasi izin OAuth guide.

Membuat akun layanan di konsol Google Cloud

Buat akun layanan baru dengan peran Discovery Engine User dengan mengikuti langkah-langkah berikut:

Konsol Google Cloud

1. Di Konsol Google Cloud, buka Menu menu > IAM & Admin > Akun Layanan.

   Buka Akun Layanan

   Langkah-langkah selanjutnya akan muncul di Konsol Google Cloud.

2. Pilih project Google Cloud.
3. Klik Create service account.
4. Masukkan nama akun layanan untuk ditampilkan di Konsol Google Cloud.
5. Jika tidak ingin menetapkan kontrol akses sekarang, klik Done untuk menyelesaikan pembuatan akun layanan. Untuk menetapkan kontrol akses sekarang, klik Create and continue , lalu lanjutkan ke langkah berikutnya.
6. Opsional: Tetapkan peran ke akun layanan Anda untuk memberikan akses ke resource project Google Cloud Anda selain resource Google Workspace. Untuk mengetahui detail selengkapnya, lihat Mengelola akses ke project, folder, dan organisasi.
7. Klik Continue.
8. Opsional: Masukkan pengguna atau grup yang dapat mengelola dan melakukan tindakan dengan akun layanan ini. Untuk mengetahui detail selengkapnya, lihat Peniruan akun layanan.
9. Klik Done untuk menyelesaikan pembuatan akun layanan.

   Catat alamat email untuk akun layanan.

gcloud CLI

1. Buat akun layanan:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Opsional: Tetapkan peran ke akun layanan Anda untuk memberikan akses ke resource project Google Cloud Anda selain resource Google Workspace. Untuk mengetahui detail selengkapnya, lihat Mengelola akses ke project, folder, dan organisasi.

Akun layanan akan muncul di halaman akun layanan.

Membuat kunci pribadi

Untuk membuat dan mendownload kunci pribadi untuk akun layanan, ikuti langkah-langkah berikut:

1. Di Konsol Google Cloud, buka Menu menu > IAM & Admin > Akun Layanan.

   Buka Akun Layanan

   Langkah-langkah selanjutnya akan muncul di Konsol Google Cloud.

2. Pilih project Google Cloud.
3. Klik alamat email akun layanan yang ingin Anda buatkan kunci.
4. Klik tab Keys.
5. Klik menu drop-down Kunci, lalu pilih Buat kunci baru.
6. Pilih JSON sebagai Jenis kunci dan klik Create.

   Pasangan kunci umum/pribadi baru Anda dibuat dan didownload ke komputer Anda sebagai file kunci akun layanan. Simpan file JSON yang didownload sebagai credentials.json di direktori kerja Anda. File ini adalah satu-satunya salinan kunci ini. Setelah Anda mendownload file kunci, Anda tidak dapat mendownloadnya lagi. Untuk mengetahui informasi tentang cara menyimpan kunci Anda dengan aman, lihat Praktik terbaik untuk mengelola kunci akun layanan.

Untuk mengetahui informasi selengkapnya tentang akun layanan, lihat akun layanan dalam dokumentasi Google Cloud IAM.

Membuat dan mengonfigurasi project aplikasi Chat

1. Di Konsol Google API, buka Menu menu > IAM & Admin > Setelan.

   Buka Setelan IAM &Admin

2. Perhatikan kolom Project number dan Project ID.

3. Buka Gemini Enterprise:

   Buka Gemini Enterprise

4. Perhatikan Location dan ID aplikasi.

5. Klik tombol berikut untuk membuka project Apps Script GE AI Agent Quickstart.

   Membuka project

6. Klik info_outline Overview > Make a copy.

7. Di project Apps Script Anda, klik Project Settings > Edit script properties > Add script property untuk menambahkan properti skrip berikut:

   1. REASONING_ENGINE_RESOURCE_NAME dengan resource aplikasi Gemini Enterprise yang disusun dengan informasi yang dicatat pada langkah-langkah sebelumnya.

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID
      

   2. SERVICE_ACCOUNT_KEY dengan kunci JSON dari akun layanan yang didownload pada langkah-langkah sebelumnya seperti { ... }.

8. Klik Save script properties

9. Di project Apps Script Anda, klik Project Settings.

10. Di bagian Google Cloud Platform (GCP) Project, klik Change project.

11. Di GCP project number, tempelkan nomor project Google Cloud yang dicatat pada langkah-langkah sebelumnya.

12. Klik Set project. Project Cloud dan project Apps Script kini terhubung.

Membuat deployment pengujian

Anda memerlukan ID deployment untuk project Apps Script ini, sehingga Anda dapat menggunakannya pada langkah berikutnya.

Untuk mendapatkan ID deployment utama, lakukan hal berikut:

1. Di project Apps Script aplikasi Chat, klik Deploy > Test deployments.
2. Di bagian Head deployment ID, klik Copy.
3. Klik Done.

Mengonfigurasi aplikasi Chat

Dengan deployment Apps Script Anda, ikuti langkah-langkah berikut untuk men-deploy aplikasi Google Chat untuk pengujian:

1. Di Konsol API, cari Google Chat API, lalu klik Google Chat API.
2. Klik Manage.

3. Klik Configuration dan siapkan aplikasi Chat:

   1. Di kolom App name, masukkan GE Quickstart.
   2. Di kolom Avatar URL, masukkan https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. Di kolom Description, masukkan GE Quickstart.
   4. Di bagian Functionality, pilih Join spaces and group conversations.
   5. Di bagian Connection settings, pilih Apps Script project.
   6. Di kolom Deployment ID, tempelkan ID deployment Utama yang sebelumnya Anda salin.
   7. Di bagian Visibility, pilih Specific people and groups in your domain, lalu masukkan email Anda.

4. Klik Save.

Aplikasi Chat siap merespons pesan.

Menguji aplikasi Chat

Untuk menguji aplikasi Chat, buka ruang pesan langsung dengan aplikasi Chat dan kirim pesan:

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

   Buka Google Chat

2. Klik add New chat.
3. Di kolom Add 1 or more people, ketik nama aplikasi Chat Anda.

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

5. Di pesan langsung baru dengan aplikasi, ketik I need to find ideas! lalu tekanenter.

   Aplikasi Chat akan membalas dengan respons agen Default Idea Generation.

Untuk menambahkan penguji tepercaya dan mempelajari lebih lanjut cara menguji fitur interaktif, lihat Menguji fitur interaktif untuk aplikasi Google Chat.

Memecahkan masalah

Saat aplikasi atau kartu Google Chat menampilkan error, antarmuka Chat akan menampilkan pesan yang menyatakan "Something went wrong." atau "Unable to process your request". 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 saat 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.

1. Di Konsol Google API, buka halaman Manage resources. Klik Menu menu > IAM & Admin > Manage Resources.

   Buka Resource Manager

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

Topik terkait

• Mem-build agen Gemini Enterprise yang terintegrasi erat dengan penyimpanan data, API, dan aplikasi Chat Workspace
• Mem-build agen Vertex AI yang terintegrasi erat dengan penyimpanan data, API, dan aplikasi Chat Workspace
• Mem-build aplikasi Google Chat dengan agen AI ADK
• Mem-build aplikasi Google Chat dengan agen AI ADK yang diekspos oleh A2A
• Mem-build aplikasi Google Chat dengan agen AI ADK yang diekspos oleh A2UI
• Memeriksa kebenaran pernyataan dengan agen AI ADK dan model Gemini
• Merencanakan perjalanan dengan agen AI yang dapat diakses di seluruh Google Workspace
• Mengintegrasikan konsep dasar AI di aplikasi Chat
• Menjawab pertanyaan berdasarkan percakapan Chat dengan aplikasi Chat AI Gemini
• Merespons insiden dengan Google Chat, Vertex AI, Apps Script, dan autentikasi pengguna
• Mengelola project dengan Google Chat, Vertex AI, dan Firestore