Merencanakan perjalanan dengan agen AI yang dapat diakses di seluruh Google Workspace

Tingkat pengkodean: Lanjutan
Durasi: 45 menit
Jenis proyek: Add-on Google Workspace yang memperluas Chat, Gmail, Kalender, Drive, Dokumen, Spreadsheet, dan Slide.

Tutorial ini menunjukkan kepada Anda cara menerbitkan agen AI ke Google Workspace sebagai add-on Google Workspace, menggunakan Apps Script atau titik akhir HTTP. Setelah Anda memublikasikan add-on, pengguna dapat berinteraksi dengan agen AI dalam alur kerja mereka.

Ringkasan

Dalam tutorial ini, Anda menerapkan contoh Travel Concierge dari Agent Development Kit (ADK). Travel Concierge adalah AI multi-agen percakapan yang menggunakan alat seperti Google Maps Platform Places API, Google Search Grounding, dan server Model Context Protocol (MCP).

ADK menyediakan antarmuka obrolan dan teks untuk pengembang secara default. Dalam tutorial ini,Anda akan menambahkan Antarmuka Pengguna Grafis (GUI) ke aplikasi Google Workspace yang dapat diakses pengguna Anda langsung di Chat, Gmail, Kalender, Drive, Dokumen, Spreadsheet, dan Slide.

• 

  Gambar 1. Menggunakan agen AI dari Chat untuk bertukar pikiran tentang ide perjalanan.

• 

  Gambar 2. Menggunakan agen AI dari Gmail untuk merencanakan perjalanan dari konteks di email yang dipilih.

Tujuan

• Siapkan lingkungan.
• Terapkan agen AI.
• Siapkan proyek.
• Deploy ke Gmail, Kalender, Drive, Dokumen, Spreadsheet, Slide.
• Deploy ke Chat.
• Uji solusinya.

Tentang solusi ini

Solusi ini mengandalkan teknologi inti berikut: ADK, Google Cloud & Google Workspace API, Vertex AI Agent Engine, dan framework Kartu.

GUI dirancang berbeda untuk aplikasi Chat dan non-Chat (Gmail, Kalender, Drive, Docs, Sheets, Slides) untuk mempertimbangkan fitur dan keterbatasan spesifiknya.

Fitur

Fitur-fitur berikut dari aplikasi Travel Concierge umum di semua aplikasi Google Workspace:

• Sesi pengguna persisten: Sesi dikelola oleh Vertex AI untuk persistensi. Setiap pengguna berbagi satu sesi di semua aplikasi Workspace. Pengguna dapat mengatur ulang sesi mereka secara manual untuk memulai percakapan baru.

• Pesan kaya: Pengguna mengirim pesan teks dan menerima respons dengan teks kaya dan widget kartu.

• Penanganan error: Error tak terduga ditangani dengan baik menggunakan coba lagi dan status yang dapat dikonfigurasi dalam respons.

Aplikasi Obrolan memiliki fitur tambahan berikut:

• Pesan pengguna multimoda: Pengguna dapat mengirim pesan dengan lampiran, termasuk audio dan video yang direkam langsung dari ruang Obrolan.

• Respons yang lebih canggih secara visual: Respons dapat dibuat dengan widget yang lebih canggih seperti carousel dengan gambar dengan mengandalkan fitur khusus Chat dari framework Kartu dan ruang rendering yang lebih besar.

Aplikasi lain memiliki fitur tambahan ini:

• Konteks profil Google: Pengguna dapat mengirim pesan dengan informasi profil mereka (terbatas pada tanggal lahir dalam contoh ini).

• Konteks Gmail: Pengguna dapat mengirim pesan dengan email (terbatas pada satu subjek dan isi dalam contoh ini).

• Akses ruang Chat agen: Pengguna dapat membuka ruang pesan langsung (DM) aplikasi Chat di tab baru dengan satu klik tombol.

Arsitektur

Aplikasi Travel Concierge menerima dan memproses peristiwa interaksi add-on Google Workspace dari aplikasi Google Workspace, menggunakan Vertex AI untuk meminta agen ADK AI dan mengelola sesi pengguna, serta mengandalkan Google Cloud dan Google Workspace API untuk mengumpulkan konteks dan menampilkan respons.

Diagram berikut menunjukkan alur pengguna utama: mengirim pesan ke agen AI.

HTTP

• 

  Gambar 3. Aplikasi Chat melengkapi konteks dengan lampiran dari pesan pengguna, dan mengirim serangkaian pesan dengan histori interaksi sub-agen dan jawaban keseluruhan akhir dalam urutan kronologis.

• 

  Gambar 4. Aplikasi non-Chat melengkapi konteks dengan profil Google pengguna dan pilihan item, lalu menampilkan serangkaian bagian dengan riwayat interaksi sub-agen dan jawaban keseluruhan akhir dalam urutan kronologis terbalik.

Apps Script

• 

  Gambar 3. Aplikasi Obrolan melengkapi konteks dengan lampiran dari pesan pengguna, dan mengirimkan serangkaian pesan berisi riwayat interaksi sub-agen dan jawaban keseluruhan akhir dalam urutan kronologis.

• 

  Gambar 4. Aplikasi non-Chat melengkapi konteks dengan profil Google pengguna dan pilihan item, serta menampilkan serangkaian bagian dengan histori interaksi sub-agen dan jawaban keseluruhan terakhir dalam urutan kronologis terbalik.

Prasyarat

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

• Browser web dengan akses ke internet.

• Prasyarat khusus untuk agen Travel Concierge ADK AI

  • Python 3.10+: Untuk penginstalan, ikuti petunjuk di situs Python resmi.
  • uv: Untuk instalasi, ikuti petunjuk pada situs resmiuv situs web.
  • Google Cloud CLI: Untuk instalasi, ikuti petunjuk di situs web resmi Google Cloud.

Menyiapkan lingkungan

Bagian ini menunjukkan cara membuat dan mengonfigurasi proyek Google Cloud.

Membuat project Google Cloud

Konsol Google Cloud

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

   Buka Buat Proyek

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

   Opsional: Untuk mengedit ID Proyek, klik Edit. ID proyek tidak dapat diubah setelah proyek dibuat, jadi pilihlah ID yang memenuhi kebutuhan Anda selama masa proyek.

3. Di kolom Lokasi, klik Jelajah untuk menampilkan potensi lokasi untuk project Anda. Kemudian, klik Select.
   Perhatian: Tidak dapat menemukan organisasi Google Workspace Anda?
   Ini berarti Anda tidak masuk 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 menavigasi ke halaman Dasbor dan proyek Anda dibuat dalam beberapa menit.

gcloud CLI

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

• Cloud Shell: Untuk menggunakan terminal daring 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 Anda tidak dapat menautkan akun penagihan, Anda tidak memiliki izin yang diperlukan untuk membuat perubahan ini. Untuk informasi selengkapnya, lihat Izin yang diperlukan untuk mengaktifkan penagihan.

Konsol Google Cloud

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

   Buka Penagihan untuk Project Saya

2. Di Pilih organisasi, pilih organisasi yang terkait dengan project Google Cloud Anda.
3. Di baris proyek, 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. Hubungkan akun penagihan dengan proyek Google Cloud:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   Ganti kode berikut:

   • PROJECT_ID adalah ID Proyek untuk proyek Cloud yang ingin Anda aktifkan penagihannya.
   • BILLING_ACCOUNT_ID adalah ID akun penagihan yang akan ditautkan dengan project Google Cloud.

Mengaktifkan Google Cloud API

HTTP

1. Di konsol Google Cloud, aktifkan API add-on Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run, dan Google Workspace.

   Aktifkan API

2. Konfirmasikan bahwa Anda mengaktifkan API di proyek Cloud yang benar, lalu klik Berikutnya.

3. Konfirmasikan bahwa Anda mengaktifkan API yang benar, lalu klik Aktifkan.

Apps Script

1. Di Konsol Google Cloud, aktifkan Vertex AI, Places, People, dan Google Chat API.

   Aktifkan API

2. Konfirmasikan bahwa Anda mengaktifkan API di proyek Cloud yang benar, lalu klik Berikutnya.

3. Konfirmasikan bahwa Anda mengaktifkan API yang benar, lalu klik Aktifkan.

Dapatkan kunci API Google Maps Platform Places

1. Di konsol Google Cloud, buka halaman Google Maps Platform > Keys & Credentials.

   Buka Kunci & Kredensial

2. Dialog Memulai di Google Maps Platform menampilkan kunci API yang baru Anda buat, berupa string alfanumerik. Anda akan memerlukan string ini di bagian berikutnya.

Catatan: Jika Anda sudah memiliki kunci API yang sesuai, daftar kunci API akan ditampilkan, bukan dialog Mulai Menggunakan Google Maps Platform. Pilih Tampilkan kunci untuk menampilkan kunci.

Membuat 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 > IAM & Admin > Service Accounts.

   Buka Akun Layanan

2. Klik Create service account.
3. Isi detail akun layanan, lalu klik Buat dan lanjutkan.
   Catatan: Secara default, Google membuat ID akun layanan yang unik. Jika Anda ingin mengubah ID, ubah ID di kolom ID akun layanan.
4. Opsional: Tetapkan peran ke akun layanan Anda untuk memberikan akses ke sumber daya proyek Google Cloud Anda. Untuk mengetahui detail selengkapnya, lihat Memberikan, mengubah, dan mencabut akses ke resource.
5. Klik Continue.
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 Done. 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. Berikutnya, buat kunci pribadi untuk akun layanan.

Buat kunci pribadi

Peringatan: Contoh ini menggunakan kunci akun layanan yang diekspor agar lebih mudah. Mengekspor kunci pribadi tidak direkomendasikan dalam produksi karena kunci tersebut tidak boleh disimpan di lokasi yang tidak aman, seperti kontrol sumber.

Untuk mempelajari lebih lanjut penerapan akun layanan yang aman dan praktik terbaik, lihat Memilih waktu penggunaan akun layanan.

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

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

   Buka Akun Layanan

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

   Pasangan kunci publik/pribadi baru Anda dibuat dan diunduh ke komputer Anda sebagai berkas baru. Simpan file JSON yang didownload sebagai credentials.json di direktori kerja Anda. Berkas 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.

Mengonfigurasi layar izin OAuth

Add-on Google Workspace memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth add-on Anda menentukan konten yang ditampilkan Google kepada pengguna.

1. Di konsol Google Cloud, buka Menu > Google Auth platform > Branding.

   Buka Branding

2. Jika Anda sudah mengonfigurasi Google Auth platform, Anda dapat mengonfigurasi pengaturan Layar Persetujuan OAuth berikut diMerek dagang, Hadirin, DanAkses Data. Jika Anda melihat pesan yang mengatakan Google Auth platform belum dikonfigurasi, klik Mulai:
1. Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
2. Di 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 Continue.
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 Mengonfigurasi izin OAuth selengkapnya.

Men-deploy Agen AI ADK Travel Concierge

1. Jika belum melakukannya, lakukan autentikasi dengan akun Google Cloud Anda dan konfigurasi Google Cloud CLI untuk menggunakan project Google Cloud Anda.

   gcloud auth application-default login
   gcloud config set project PROJECT_ID
   gcloud auth application-default set-quota-project PROJECT_ID

   Ganti PROJECT_ID dengan ID project Cloud yang Anda buat.

2. Download repositori GitHub ini

   Download

3. Di lingkungan pengembangan lokal pilihan Anda, ekstrak file arsip yang didownload dan buka direktori adk-samples/python/agents/travel-concierge.

   unzip adk-samples-main.zip
   cd adk-samples-main/python/agents/travel-concierge

4. Buat bucket Cloud Storage baru yang dikhususkan untuk agen AI ADK.

   gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

   Ganti kode berikut:

   1. CLOUD_STORAGE_BUCKET_NAME dengan nama bucket unik yang ingin Anda gunakan.
   2. PROJECT_ID dengan ID project Cloud yang Anda buat.
   3. PROJECT_LOCATION dengan lokasi project Cloud yang Anda buat.

5. Tetapkan variabel lingkungan berikut:

   export GOOGLE_GENAI_USE_VERTEXAI=1
   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
   export GOOGLE_PLACES_API_KEY=PLACES_API_KEY
   export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME
   export TRAVEL_CONCIERGE_SCENARIO=travel_concierge/profiles/itinerary_empty_default.json

   Ganti kode berikut:

   1. PROJECT_ID dengan ID proyek Cloud yang Anda buat.
   2. PROJECT_LOCATION dengan lokasi project Cloud yang Anda buat.
   3. PLACES_API_KEY dengan string kunci API yang Anda buat.
   4. CLOUD_STORAGE_BUCKET_NAME dengan nama bucket yang Anda buat.

6. Instal dan terapkan agen ADK AI.

   uv sync --group deployment
   uv run python deployment/deploy.py --create

7. Ambil nomor project dan ID mesin dari log terakhir yang dicetak sebagai PROJECT_NUMBER dan ENGINE_ID, Anda akan memerlukan keduanya nanti untuk mengonfigurasi project.

   Created remote agent: projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/ENGINE_ID

Meninjau kode contoh

Secara opsional, sebelum menyiapkan proyek, luangkan waktu untuk meninjau dan membiasakan diri dengan contoh kode yang dihosting di GitHub.

Python

Lihat di GitHub

Apps Script

Lihat di GitHub

Membuat dan mengonfigurasi proyek

Python

1. Unduh repositori GitHub ini

   Download

2. Di lingkungan pengembangan lokal pilihan Anda, ekstrak file arsip yang diunduh dan buka direktori add-ons-samples/python/travel-adk-ai-agent.

   unzip add-ons-samples-main.zip
   cd add-ons-samples-main/python/travel-adk-ai-agent

3. Pindahkan file kunci JSON credentials.json dari akun layanan yang diunduh pada langkah sebelumnya ke direktori proyek.

4. Di konsol Google Cloud, buka Cloud Run:

   Buka Cloud Run

5. Klik Tulis fungsi.

6. Di halaman Create service, siapkan fungsi Anda:

   1. Di kolom Nama layanan, masukkan travel-concierge-app.
   2. Di daftar Region, pilih lokasi project Cloud yang Anda buat, PROJECT_LOCATION.
   3. Di bawah URL Titik Akhir, klik .
   4. Dalam daftar Runtime, pilih versi Python terbaru.
   5. Di bagian Autentikasi, pilih Izinkan akses publik.
   6. Di bagian Kontainer, Volume, Jaringan, Keamanan, di bawah Sumber Daya:
      1. Di bidang Memori, pilih 1 GiB.
      2. Di kolom CPU, pilih 2.
   7. Klik Buat, dan tunggu hingga Cloud Run membuat layanan. Konsol akan mengalihkan Anda ke tab Sumber.

7. Di lingkungan pengembangan lokal pilihan Anda, deploy sumber project:

   gcloud run deploy travel-concierge-app --quiet --source . \
       --region PROJECT_LOCATION  \
       --function adk_ai_agent  \
       --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

   Ganti kode berikut:

   1. PROJECT_LOCATION dengan lokasi fungsi Cloud Run yang sebelumnya Anda buat.
   2. LOCATION dengan lokasi proyek Google Cloud yang dibuat pada langkah sebelumnya, PROJECT_LOCATION.
   3. PROJECT_NUMBER dengan nomor project Agen AI Travel Concierge ADK yang di-deploy pada langkah sebelumnya.
   4. ENGINE_ID dengan ID mesin Travel Concierge ADK AI Agent yang di-deploy pada langkah sebelumnya.
   5. BASE_URL dengan URL Titik Akhir yang sebelumnya Anda salin.

Apps Script

Untuk membuat project Apps Script dan mengonfigurasinya agar menggunakan agen AI ADK Travel Concierge yang di-deploy:

1. Klik tombol berikut untuk membuka proyek Apps Script Travel Concierge ADK AI Agent.
   Membuka project

2. Klik Ringkasan, lalu Buat salinan.

3. Beri nama salinan proyek Apps Script Anda:

   1. Klik Salinan Agen Travel Concierge ADK AI.
   2. Di Project title, ketik Travel Concierge ADK AI Agent.
   3. Klik Ganti nama.

4. Dalam proyek Apps Script Anda, klik Editor dan pindahkan file VertexAi.gs ke atas hingga berada di atas file AgentHandler.gs dengan menggunakan tindakan file Pindahkan file ke atas.

5. Di proyek Apps Script Anda, klik Pengaturan Proyek, klik Edit properti skrip, lalu klik Tambahkan properti skrip untuk menambahkan properti skrip berikut:

6. ENGINE_ID dengan ID mesin Agen AI Travel Concierge ADK yang diterapkan pada langkah sebelumnya, ENGINE_ID.

7. LOCATION dengan lokasi proyek Google Cloud yang dibuat pada langkah sebelumnya, PROJECT_LOCATION.

8. PROJECT_NUMBER dengan nomor project Agen AI ADK Travel Concierge yang di-deploy pada langkah sebelumnya, PROJECT_NUMBER.

9. SERVICE_ACCOUNT_KEY dengan kunci JSON dari akun layanan yang diunduh pada langkah sebelumnya seperti { ... }.

10. Klik Simpan properti skrip

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

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

13. Di GCP project number, tempelkan nomor project Travel Concierge ADK AI Agent yang di-deploy pada langkah sebelumnya, PROJECT_NUMBER.

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

Men-deploy ke Gmail, Kalender, Drive, Dokumen, Spreadsheet, Slide

Python

Gunakan penerapan add-on Google Workspace untuk menginstal proyek contoh ke semua aplikasi Google Workspace (kecuali Google Chat) untuk mengaktifkan pengujian.

1. Di lingkungan pengembangan lokal pilihan Anda, buka file deployment.json dari sumber kode proyek dan ganti semua kemunculan $BASE_URL dengan nilai BASE_URL, URL Titik Akhir yang Anda salin di langkah sebelumnya.

2. Buat penerapan add-on Google Workspace bernama travel-concierge-addon:

   gcloud workspace-add-ons deployments create travel-concierge-addon \
       --deployment-file=deployment.json

3. Instal deployment add-on Google Workspace:

   gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

Instal proyek Apps Script ke semua aplikasi Google Workspace (kecuali Google Chat) untuk mengaktifkan pengujian.

1. Dalam proyek Apps Script Anda, klik Terapkan > Uji penerapan, lalu Instal.

Add-on kini dapat diakses dari sidebar aplikasi Google Workspace.

Men-deploy ke Chat

Python

Instal proyek contoh ke Chat menggunakan URL Titik Akhir untuk mengaktifkan pengujian.

1. Di konsol, cari Google Chat API, klik Google Chat API, lalu Kelola, dan Konfigurasi.

   Buka halaman Konfigurasi Google Chat API

2. Siapkan aplikasi Obrolan:

   1. Di kolom Nama aplikasi, masukkan Travel ADK AI Agent.
   2. Di kolom Avatar URL, masukkan https://goo.gle/3SfMkjb.
   3. Di kolom Description, masukkan Travel ADK AI Agent.
   4. Di bagian Connection settings, pilih HTTP endpoint URL.
   5. Di bawah Pemicu, pilih Gunakan URL titik akhir HTTP umum untuk semua pemicu.
   6. Di kolom URL titik akhir HTTP, tempel URL titik akhir yang sebelumnya Anda salin, BASE_URL.
   7. Daftarkan perintah Cepat yang digunakan oleh aplikasi Obrolan yang diimplementasikan sepenuhnya:
      1. Di bagian Commands, klik Add a command.
      2. Di Command ID, ketik 1.
      3. Di Deskripsi, ketik Reset session.
      4. Di bawah Jenis perintah, pilih Perintah cepat.
      5. Di Name, ketik Reset session.
      6. Klik Done. Perintah cepat didaftarkan dan dicantumkan.
   8. Di bawah Visibilitas, pilih Jadikan aplikasi Obrolan ini tersedia untuk orang dan grup tertentu di Domain Ruang Kerja Anda dan masukkan alamat email Anda.
   9. Di bagian Logs, pilih Log errors to Logging.
   10. Klik Simpan.

Apps Script

Instal proyek Apps Script ke Chat menggunakan Head Deployment ID untuk mengaktifkan pengujian.

1. Di proyek Apps Script Anda, klik Terapkan > Uji penerapan, lalu Salin di bawah ID Penerapan Utama.

2. Di konsol, cari Google Chat API, klik Google Chat API, lalu Kelola, dan Konfigurasi.

   Buka halaman Konfigurasi Google Chat API

3. Siapkan aplikasi Obrolan:

   1. Di kolom Nama aplikasi, masukkan Travel ADK AI Agent.
   2. Di kolom Avatar URL, masukkan https://goo.gle/3SfMkjb.
   3. Di kolom Description, masukkan Travel ADK AI Agent.
   4. Di bagian Connection settings, pilih Apps Script.
   5. Di kolom Deployment ID, tempel Head deployment ID yang sebelumnya Anda salin.
   6. Daftarkan perintah Cepat yang digunakan oleh aplikasi Obrolan yang diimplementasikan sepenuhnya:
      1. Di bawah Perintah, klik Tambahkan perintah.
      2. Di Command ID, ketik 1.
      3. Di Deskripsi, ketik Reset session.
      4. Di bawah Jenis perintah, pilih Perintah cepat.
      5. Di Name, ketik Reset session.
      6. Klik Done. Perintah cepat didaftarkan dan dicantumkan.
   7. Di bawah Visibilitas, pilih Jadikan aplikasi Obrolan ini tersedia untuk orang dan grup tertentu di Domain Ruang Kerja Anda dan masukkan alamat email Anda.
   8. Di bagian Logs, pilih Log errors to Logging.
   9. Klik Simpan.

Aplikasi ini sekarang dapat diakses dari Google Chat.

1. Buka Google Chat.

   Buka Google Chat

2. Buat ruang Chat DM:

   1. Klik Obrolan Baru.
   2. Ketik dan pilih aplikasi Travel ADK AI Agent dalam pencarian.
   3. Dalam dialog Install app, klik Instal aplikasi.
   4. Dialog Install app ditutup dan ruang Chat DM yang baru dibuat dipilih.

Aplikasi Chat siap merespons pesan.

Uji agennya

1. Buka Gmail.

   Buka Gmail

2. Kirimkan email berikut kepada diri Anda sendiri:

   • Subjek: You need to travel to Paris
   • Badan: Please be there between 11/25/2025 and 11/30/2025!

3. Buka add-on Travel ADK AI Agent dari sidebar.

4. Klik Berikan izin untuk menyelesaikan pengaturan add-on.

5. Klik Kirim setelah mengonfigurasi permintaan berikut ke agen:

   • Pesan: Please help me plan this travel!
   • Konteks: pilih Email saat ini

   Sidebar diperbarui dengan respons agen.

   

6. Klik Buka Obrolan untuk diarahkan ke ruang DM Obrolan.

7. Klik + > Setel ulang sesi.

   Anda menerima pesan baru yang mengonfirmasi bahwa prosesnya telah selesai: OK, let's start from the beginning, what can I help you with?

8. Kirim pesan Give me ideas.

   Anda menerima pesan baru dengan respons agen.

   

9. Kirim pesan I want to go there! setelah mengunggah gambar lokasi mana pun seperti Menara Eiffel.

   Anda menerima pesan baru dengan respons agen.

   

Catatan: Itu Agen AI ADK Perjalanan Add-on ini juga dapat dibuka dari bilah sisi di Kalender, Drive, Dokumen, Spreadsheet, dan Slide, mirip dengan cara yang dilakukan di Gmail.

Batasan

HTTP

Di aplikasi Google Workspace selain Chat, agen AI memiliki batasan berikut:

• Sinkron: Bilah sisi hanya dapat diperbarui sebagai respons terhadap interaksi pengguna, sehingga respons agen AI hanya ditampilkan setelah penyelesaian penuh (tanpa streaming).

• Dapat habis waktunya: Pembaruan bilah sisi akan habis waktunya apabila memerlukan waktu lebih dari beberapa menit untuk selesai.

Batasan ini tidak ada di Chat.

Apps Script

Di semua aplikasi Google Workspace, agen AI memanggil Vertex AI REST API menggunakan UrlFetchApp, yang menyebabkan batasan berikut:

• Sinkron: Respons agen AI dikembalikan hanya setelah penyelesaian penuh (tanpa streaming).

• Dapat habis waktunya: Agen AI meminta waktu habis ketika mereka membutuhkan waktu sekitar lebih dari satu menit untuk menyelesaikannya.

Penyesuaian

Solusi ini mendukung agen AI ADK yang dihosting di Vertex AI Agent Engine, bagian dari UI aplikasi Google Workspace, dan rendering respons yang khusus untuk respons sampel Travel Concierge. Solusinya menggunakan kerangka kerja yang dapat diperluas, sehingga Anda dapat menyesuaikannya dengan memodifikasi file berikut:

Python

• main.py: Menentukan UI utama dan logika interaksi pengguna (penanganan peristiwa Google Workspace). Ekstensi umum adalah mengaktifkan dokumen Drive sebagai fitur konteks untuk aplikasi Drive, mirip dengan yang dilakukan pada pesan Gmail untuk aplikasi Gmail.

• vertex_ai.py: Mengelola sesi, respons, error agen AI, dan menentukan antarmuka khusus Vertex AI yang akan diterapkan untuk mendukung interaksi dan rendering respons agen. Ekstensi yang umum adalah menambahkan dukungan untuk multi-sesi untuk percakapan pengguna terpisah, dan platform manajemen agen AI lainnya.

• agent_handler.py: Menerapkan antarmuka khusus Vertex AI yang ditentukan dalam vertex_ai.py dalam kasus khusus aplikasi Chat dan non-Chat. Ekstensi tipikal adalah menambahkan tombol bagi pengguna untuk mengirimkan masukan tentang respons agen AI.

• google_workspace.py: Menerapkan interaksi platform pengelolaan agen non-AI menggunakan panggilan API. Hanya Google Workspace API yang digunakan dalam contoh ini untuk mengumpulkan detail konteks dan melakukan tindakan. Ekstensi umum adalah menambahkan fungsi untuk mengambil data bisnis dari Google Kalender atau Pengelolaan Hubungan Pelanggan (CRM).

• travel_agent_ui_render.gs: Menerapkan rendering respons khusus Travel Concierge untuk sub-agen dan aplikasi Workspace. Ekstensi tipikal adalah menambahkan dukungan untuk rendering respons baru untuk menampilkan opsi penerbangan secara grafis, dan agen AI lainnya.

Apps Script

• Code.gs: Menentukan UI utama dan logika interaksi pengguna (penanganan peristiwa Google Workspace). Ekstensi yang lazim adalah mengaktifkan dokumen Drive sebagai fitur konteks untuk aplikasi Drive, mirip dengan apa yang dilakukan dengan pesan Gmail untuk aplikasi Gmail.

• VertexAi.gs: Mengelola sesi, respons, error agen AI, dan menentukan antarmuka khusus Vertex AI yang akan diterapkan untuk mendukung interaksi agen dan rendering respons. Ekstensi umum adalah menambahkan dukungan untuk multi-sesi untuk percakapan pengguna yang terpisah, dan platform pengelolaan agen AI lainnya.

• AgentHandler.gs: Menerapkan antarmuka spesifik Vertex AI yang didefinisikan dalam VertexAi.gs dalam kasus spesifik aplikasi Chat dan non-Chat. Ekstensi umum adalah menambahkan tombol bagi pengguna untuk mengirim masukan tentang respons agen AI.

• GoogleWorkspace.gs: Menerapkan interaksi platform pengelolaan agen non-AI menggunakan panggilan API. Hanya Google Workspace API yang digunakan dalam contoh ini untuk mengumpulkan detail konteks dan melakukan tindakan. Ekstensi umum adalah menambahkan fungsi untuk mengambil data bisnis dari Google Kalender atau Pengelolaan Hubungan Pelanggan (CRM).

• TravelAgentUiRender.gs: Menerapkan rendering respons khusus Travel Concierge untuk sub-agen dan aplikasi Workspace. Ekstensi tipikal adalah menambahkan dukungan untuk rendering respons baru untuk menampilkan opsi penerbangan secara grafis, dan agen AI lainnya.

Pembersihan

Untuk menghindari timbulnya biaya pada akun Google Cloud Anda untuk sumber daya yang digunakan dalam tutorial ini, kami sarankan Anda menghapus proyek Cloud.

Perhatian: Menghapus proyek memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan proyek yang sudah ada untuk tutorial ini, saat Anda menghapusnya, Anda juga menghapus pekerjaan lain yang telah Anda lakukan dalam proyek 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 proyek, pilih proyek yang ingin Anda hapus lalu klik Hapus .
3. Dalam dialog, ketik ID proyek lalu klik Matikan untuk menghapus proyek.

Topik terkait

• Memeriksa fakta pernyataan dengan agen AI ADK dan model Gemini
• Integrasikan konsep AI fundamental dalam aplikasi Chat
• Membuat aplikasi Chat sebagai add-on Google Workspace dengan Apps Script