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

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

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

Ringkasan

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

ADK menyediakan antarmuka chat dan teks untuk developer 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.

  • Menggunakan agen AI dari Chat untuk mendiskusikan ide perjalanan.
    Gambar 1. Menggunakan agen AI dari Chat untuk mendiskusikan ide perjalanan.
  • Menggunakan agen AI dari Gmail untuk merencanakan perjalanan dari konteks di email yang dipilih.
    Gambar 2. Menggunakan agen AI dari Gmail untuk merencanakan perjalanan dari konteks dalam email yang dipilih.

Tujuan

  • Siapkan lingkungan.
  • Deploy agen AI.
  • Siapkan project.
  • Deploy ke Gmail, Kalender, Drive, Dokumen, Spreadsheet, Slide.
  • Deploy ke Chat.
  • Uji solusi.

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, Dokumen, Spreadsheet, Slide) untuk memperhitungkan fitur dan batasan spesifiknya.

Fitur

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

  • Sesi pengguna persisten: Sesi dikelola oleh Vertex AI agar tetap persisten. Setiap pengguna membagikan satu sesi di semua aplikasi Workspace. Pengguna dapat mereset sesi mereka secara manual untuk memulai percakapan baru.

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

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

Aplikasi Chat memiliki fitur tambahan berikut:

  • Pengiriman pesan multimodal oleh pengguna: Pengguna dapat mengirim pesan dengan lampiran, termasuk audio dan video yang direkam langsung dari ruang Chat.

  • 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 berikut:

  • 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 memicu agen AI ADK 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

  • Diagram arsitektur untuk aplikasi Chat.
    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.
  • Diagram arsitektur untuk aplikasi non-Chat.
    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 akhir dalam urutan kronologis terbalik.

Apps Script

  • Diagram arsitektur untuk aplikasi Chat.
    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.
  • Diagram arsitektur untuk aplikasi non-Chat.
    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 akhir dalam urutan kronologis terbalik.

Prasyarat

Menyiapkan lingkungan

Bagian ini menunjukkan cara membuat dan mengonfigurasi project Google Cloud.

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.
  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

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 Google Cloud API

HTTP

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

    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.

Apps Script

  1. Di Konsol Google Cloud, aktifkan Vertex AI, Places, People, dan Google Chat 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.

Mendapatkan kunci API Places Google Maps Platform

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

    Buka Keys & Credentials

  2. Dialog Mulai Menggunakan Google Maps Platform akan menampilkan kunci API yang baru dibuat, yaitu string alfanumerik. Anda akan memerlukan string ini di bagian berikutnya.

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.
  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. Selanjutnya, buat kunci pribadi untuk 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 > 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.

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 telah mengonfigurasi Google Auth platform, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang bertuliskan 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 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.

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 project 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 deploy agen AI ADK.

    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

Atau, sebelum menyiapkan project, luangkan waktu untuk meninjau dan memahami kode contoh yang dihosting di GitHub.

Python

Lihat di GitHub

Apps Script

Lihat di GitHub

Buat dan konfigurasi project

Python

  1. Download repositori GitHub ini

    Download

  2. Di lingkungan pengembangan lokal pilihan Anda, ekstrak file arsip yang didownload 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 didownload pada langkah sebelumnya ke direktori project.

  4. Di konsol Google Cloud, buka Cloud Run:

    Buka Cloud Run

  5. Klik Write a function.

  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 bagian Endpoint URL, klik Ikon untuk membuat salinan.
    4. Dalam daftar Runtime, pilih versi Python terbaru.
    5. Di bagian Authentication, pilih Allow public access.
    6. Di bagian Containers, Volumes, Networking, Security, di bagian Resources:
      1. Di kolom Memory, 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 Anda buat sebelumnya.
    2. LOCATION dengan lokasi project 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 Endpoint URL 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 project Apps Script Travel Concierge ADK AI Agent.
    Membuka project

  2. Klik Ringkasan, lalu Ikon untuk membuat salinan Buat salinan.

  3. Beri nama salinan project Apps Script Anda:

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

  4. Di project Apps Script Anda, klik Ikon untuk setelan project Editor dan pindahkan file VertexAi.gs ke atas hingga berada di atas file AgentHandler.gs menggunakan tindakan file Pindahkan file ke atas.

  5. Di project Apps Script Anda, klik Ikon untuk setelan project Project Settings, klik Edit script properties, lalu klik Add script property untuk menambahkan properti skrip berikut:

  6. ENGINE_ID dengan ID mesin Travel Concierge ADK AI Agent yang di-deploy pada langkah sebelumnya, ENGINE_ID.

  7. LOCATION dengan lokasi project 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 didownload pada langkah sebelumnya, seperti { ... }.

  10. Klik Simpan properti skrip

  11. Di project Apps Script Anda, klik Ikon untuk setelan project 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 deployment add-on Google Workspace untuk menginstal project 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 project dan ganti semua kemunculan $BASE_URL dengan nilai BASE_URL, yaitu URL Endpoint yang Anda salin di langkah sebelumnya.

  2. Buat deployment 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 project Apps Script ke semua aplikasi Google Workspace (kecuali Google Chat) untuk mengaktifkan pengujian.

  1. Di project Apps Script Anda, klik Deploy > Test deployments, lalu Install.

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

Men-deploy ke Chat

Python

Instal project contoh ke Chat menggunakan URL Endpoint 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. Menyiapkan aplikasi Chat:

    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 bagian Pemicu, pilih Gunakan URL endpoint HTTP umum untuk semua pemicu.
    6. Di kolom HTTP endpoint URL, tempel Endpoint URL yang sebelumnya Anda salin, BASE_URL.
    7. Daftarkan Perintah cepat yang digunakan oleh aplikasi Chat 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 bagian Jenis perintah, pilih Perintah cepat.
      5. Di Name, ketik Reset session.
      6. Klik Selesai. Perintah cepat didaftarkan dan dicantumkan.
    8. Di bagian Visibilitas, pilih Jadikan aplikasi Chat ini tersedia untuk orang dan grup tertentu di Domain Workspace Anda, lalu masukkan alamat email Anda.
    9. Di bagian Logs, pilih Log errors to Logging.
    10. Klik Simpan.

Apps Script

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

  1. Di project Apps Script Anda, klik Deploy > Test deployments, lalu Ikon untuk penyalinan ID Deployment Utama Copy di bagian Head Deployment ID.

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

    Buka halaman Konfigurasi Google Chat API

  3. Menyiapkan aplikasi Chat:

    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, tempelkan Head deployment ID yang sebelumnya Anda salin.
    6. Daftarkan Perintah cepat yang digunakan oleh aplikasi Chat 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 bagian Jenis perintah, pilih Perintah cepat.
      5. Di Name, ketik Reset session.
      6. Klik Selesai. Perintah cepat didaftarkan dan dicantumkan.
    7. Di bagian Visibilitas, pilih Jadikan aplikasi Chat ini tersedia untuk orang dan grup tertentu di Domain Workspace Anda, lalu masukkan alamat email Anda.
    8. Di bagian Logs, pilih Log errors to Logging.
    9. Klik Simpan.

Aplikasi kini dapat diakses dari Google Chat.

  1. Buka Google Chat.

    Buka Google Chat

  2. Buat ruang DM Chat:

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

Aplikasi Chat siap merespons pesan.

Menguji agen

  1. Buka Gmail.

    Buka Gmail

  2. Kirim email berikut kepada Anda sendiri:

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

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

  4. Klik Beri izin untuk menyelesaikan penyiapan 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.

    Merencanakan perjalanan dari Gmail

  6. Klik Buka Chat untuk dialihkan ke ruang DM Chat.

  7. Klik + > Reset 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.

    Berdiskusi dari Chat

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

    Anda menerima pesan baru dengan respons agen.

    Mendapatkan detail lokasi dari lampiran Chat

Batasan

HTTP

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

  • Sinkron: Sidebar hanya dapat diperbarui sebagai respons terhadap interaksi pengguna, sehingga respons agen AI hanya ditampilkan setelah selesai sepenuhnya (tidak ada streaming).

  • Dapat mengalami waktu tunggu: Pembaruan sidebar akan mengalami waktu tunggu jika 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 hanya ditampilkan setelah selesai sepenuhnya (tidak ada streaming).

  • Dapat mengalami waktu tunggu habis: Agen AI akan mengalami waktu tunggu habis jika memerlukan waktu lebih dari satu menit untuk menyelesaikan permintaan.

Penyesuaian

Solusi ini mendukung agen AI ADK yang dihosting di Vertex AI Agent Engine, subset UI aplikasi Google Workspace, dan rendering respons yang khusus untuk respons contoh Travel Concierge. Solusi ini menggunakan framework yang dapat di-extend, sehingga Anda dapat menyesuaikannya dengan mengubah file berikut:

Python

  • main.py: Menentukan logika interaksi pengguna dan UI utama (handler 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 umum adalah menambahkan dukungan untuk multi-sesi untuk percakapan pengguna yang terpisah, dan platform pengelolaan 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 umum 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 umum adalah menambahkan dukungan untuk rendering respons baru guna menampilkan opsi penerbangan secara grafis, dan agen AI lainnya.

Apps Script

  • Code.gs: Menentukan logika interaksi pengguna dan UI utama (handler 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.

  • 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 khusus Vertex AI yang ditentukan dalam VertexAi.gs dalam kasus khusus aplikasi Chat dan non-Chat. Ekstensi umum adalah menambahkan tombol bagi pengguna untuk mengirimkan 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 umum adalah menambahkan dukungan untuk rendering respons baru guna menampilkan opsi penerbangan secara grafis, dan agen AI lainnya.

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 > 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.