Membangun aplikasi Google Chat dengan agen AI ADK

Halaman ini menjelaskan cara membuat add-on Google Workspace yang berfungsi di Google Chat dan berinteraksi dengan agen AI Agent Development Kit (ADK) yang dihosting di Vertex AI Agent Engine.

Agen AI secara otonom memahami lingkungan, bernalar, dan menjalankan tindakan multi-langkah yang kompleks untuk mencapai sasaran yang ditentukan. Dalam tutorial ini, Anda akan men-deploy contoh multiagen Auditor LLM ADK yang mengkritik dan merevisi fakta menggunakan perujukan Gemini dan Google Penelusuran.

Diagram berikut menunjukkan arsitektur dan pola pengiriman pesan:

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

1. Pengguna mengirim pesan ke aplikasi Chat, baik di pesan langsung maupun di ruang Chat.
2. Logika aplikasi Chat yang diterapkan di Apps Script atau sebagai server web dengan endpoint HTTP menerima dan memproses pesan.
3. Agen AI yang diimplementasikan dengan ADK dan dihosting dengan Vertex AI Agent Engine menerima dan memproses interaksi.
4. Secara opsional, aplikasi Chat atau agen AI dapat terintegrasi 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

• Siapkan lingkungan Anda.
• Deploy agen AI ADK.
• Deploy aplikasi Chat.
• Konfigurasi aplikasi Chat.
• Uji 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.

Menyiapkan lingkungan Anda

Mengaktifkan Google Cloud 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, Vertex AI, dan Cloud Resource Manager API.

  Aktifkan 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 Cloud, buka Menu menu > Google Auth platform > Branding.

   Buka Branding

2. Jika sudah mengonfigurasi Google Auth platform, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth platform belum dikonfigurasi, klik Mulai:
1. Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
2. Di bagian Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
3. Klik Berikutnya.
4. Di bagian Audiens, pilih Internal.
5. Klik Berikutnya.
6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
7. Klik Berikutnya.
8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya menyetujui Layanan Google API: Kebijakan Data Pengguna.
9. Klik Lanjutkan.
10. Klik Buat.
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 Jenis pengguna menjadi Eksternal. Kemudian tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan lengkap Mengonfigurasi izin OAuth.

Buat akun layanan di konsol Google Cloud

Buat akun layanan baru dengan peran Vertex AI User dengan mengikuti langkah-langkah berikut:

Konsol Google Cloud

1. Di Konsol Google Cloud, buka Menu menu > IAM & Admin > Service Accounts.

   Buka Akun Layanan

2. Klik Create service account.
3. Isi detail akun layanan, lalu klik Buat dan lanjutkan.
4. Opsional: Tetapkan peran ke akun layanan Anda untuk memberikan akses ke resource project Google Cloud Anda. Untuk mengetahui detail selengkapnya, lihat Memberikan, mengubah, dan mencabut akses ke resource.
5. Klik Lanjutkan.
6. Opsional: Masukkan pengguna atau grup yang dapat mengelola dan melakukan tindakan dengan akun layanan ini. Untuk mengetahui detail selengkapnya, lihat Mengelola peniruan identitas akun layanan.
7. Klik Selesai. 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. Untuk mengetahui detail selengkapnya, lihat Memberikan, mengubah, dan mencabut akses ke resource.

Akun layanan akan muncul di halaman akun layanan.

Buat 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 > Service Accounts.

   Buka Akun Layanan

2. Pilih akun layanan Anda.
3. Klik Keys > Add key > Create new key.
4. Pilih JSON, lalu klik Buat.

   Pasangan kunci umum/pribadi baru Anda dibuat dan didownload ke komputer Anda sebagai file baru. Simpan file JSON yang didownload sebagai credentials.json di direktori kerja Anda. File ini adalah satu-satunya salinan kunci ini. Untuk mengetahui informasi tentang cara menyimpan kunci Anda dengan aman, lihat Mengelola kunci akun layanan.

5. Klik Tutup.

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

Men-deploy agen AI ADK

1. Buka contoh LLM Auditor di Vertex AI Agent Garden:

   Buka sampel

2. Klik Deploy.

3. Jika diminta, pilih project Google Cloud Anda.

4. Klik Deploy in Cloud Shell.

5. Jika diminta, klik Authorize dan ikuti alur OAuth untuk Cloud Shell.

6. Setelah Cloud Shell dimuat sepenuhnya, tekan Enter untuk menjalankan command line yang telah dimuat sebelumnya dan mulai men-deploy.

7. Jika diminta memasukkan wilayah, tekan Enter untuk menggunakan default.

8. Setelah selesai, buka Vertex AI Agent Engine:

   Membuka Vertex AI Agent Engine

9. Klik untuk menyalin nama resource agen yang baru di-deploy dari tabel.

Membuat dan mengonfigurasi project aplikasi Chat

1. Klik tombol berikut untuk membuka project Apps Script ADK AI Agent Quickstart.

   Membuka project

2. Klik info_outline Ringkasan > Buat salinan.

3. Di project Apps Script Anda, klik Setelan Project > Edit properti skrip > Tambahkan properti skrip untuk menambahkan properti skrip berikut:

   1. REASONING_ENGINE_RESOURCE_NAME dengan nama resource agen Vertex AI yang disalin di langkah sebelumnya.
   2. SERVICE_ACCOUNT_KEY dengan kunci JSON dari akun layanan yang didownload pada langkah sebelumnya, seperti { ... }.

4. Klik Simpan properti skrip

5. Di konsol Google Cloud, buka Menu menu > IAM & Admin > Setelan.

   Buka Setelan IAM & Admin

6. Di kolom Project number, salin nilai.

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

8. Pada Google Cloud Platform (GCP) Project, klik Change project.

9. Di GCP project number, tempelkan nomor project Google Cloud yang disalin pada langkah-langkah sebelumnya.

10. Klik Set project. Proyek Cloud dan proyek Apps Script kini terhubung.

Buat penerapan pengujian.

Anda memerlukan ID penyebaran untuk proyek Apps Script ini, agar dapat menggunakannya pada langkah selanjutnya.

Untuk mendapatkan ID deployment utama, lakukan hal berikut:

1. Di proyek Apps Script aplikasi Obrolan, klik Menyebarkan > Pengujian penerapan.
2. Di bawah ID penyebaran Head, klik Salin.
3. Klik Selesai.

Konfigurasi aplikasi Obrolan

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

1. Di konsol, cari Google Chat API, dan klik Google Chat API.
2. Klik Manage.

3. Klik Konfigurasi dan atur aplikasi Obrolan:

   1. Pada kolom Nama aplikasi, masukkan ADK Quickstart.
   2. Pada kolom URL Avatar, masukkan https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. Di kolom Description, masukkan ADK Quickstart.
   4. Di bawah Fungsionalitas, pilih Gabung ruang dan percakapan grup.
   5. Di bawah Pengaturan koneksi, pilih Proyek Skrip Aplikasi.
   6. Pada kolom ID Penyebaran, tempelkan ID penyebaran Head yang sebelumnya telah Anda salin.
   7. Di bawah Visibilitas, pilih Orang dan grup tertentu di domain Anda, dan masukkan email Anda.

4. Klik Simpan.

Aplikasi obrolan siap merespons pesan.

Menguji aplikasi Chat

Untuk menguji aplikasi Chat Anda, 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 Obrolan baru.
3. Di kolom Tambahkan 1 orang atau lebih, ketik nama aplikasi Obrolan Anda.

4. Pilih aplikasi obrolan Anda dari hasil pencarian. Sebuah pesan langsung terbuka.

5. Di pesan langsung baru dengan aplikasi, ketik The Eiffel Tower was completed in 1900 dan tekan enter.

   Aplikasi Chat membalas dengan respons sub-agen Kritik dan Reviser.

Untuk menambahkan penguji tepercaya dan mempelajari lebih lanjut tentang pengujian fitur interaktif, lihat Uji fitur interaktif untuk aplikasi Google Chat.

Memecahkan masalah

Ketika aplikasi Google Chat atau card mengembalikan kesalahan, antarmuka Chat menampilkan pesan yang mengatakan "Terjadi kesalahan." atau "Permintaan Anda tidak dapat diproses." Terkadang antarmuka pengguna obrolan tidak menampilkan pesan kesalahan apa pun, tetapi aplikasi atau kartu obrolan menghasilkan hasil yang tidak terduga; misalnya, pesan kartu mungkin tidak muncul.

Meskipun pesan kesalahan mungkin tidak ditampilkan di antarmuka pengguna Obrolan, pesan kesalahan deskriptif dan data log tersedia untuk membantu Anda memperbaiki kesalahan saat pencatatan kesalahan untuk aplikasi Obrolan diaktifkan. Untuk bantuan melihat, men-debug, dan memperbaiki kesalahan, lihat Memecahkan masalah dan memperbaiki kesalahan Google Chat.

Pembersihan

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

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

   Buka Resource Manager

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

Topik terkait

• Membangun aplikasi Google Chat dengan agen AI ADK yang diekspos oleh A2A
• Membangun aplikasi Google Chat dengan agen AI ADK yang diekspos oleh A2UI
• Memeriksa fakta pernyataan dengan agen AI ADK dan model Gemini
• Merencanakan perjalanan dengan agen AI yang dapat diakses di seluruh Google Workspace
• Mengintegrasikan konsep AI dasar 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