Menambahkan tindakan Google Kalender dan Gmail

Halaman berikut menjelaskan cara menyiapkan tindakan asisten untuk Google Kalender dan Gmail.

Tindakan Google Kalender

Jika tindakan Google Kalender diaktifkan, pengguna akhir dapat meminta asisten membuat acara Google Kalender untuk mereka.

Misalnya, pengguna dapat memasukkan "jadwalkan rapat dengan [e-mail] pada pukul 15.00 besok". Asisten akan meminta detail tambahan jika diperlukan, lalu meminta pengguna untuk mengonfirmasi pembuatan acara.

Asisten dapat membaca dan mengedit kolom Google Kalender berikut melalui tindakan:

Kolom	Deskripsi
Tamu	Wajib. Daftar alamat email peserta. Pengguna yang meminta otomatis ditambahkan ke daftar.
Judul	Judul rapat.
Waktu mulai	Waktu mulai rapat.
Durasi	Durasi rapat. Defaultnya adalah 30 menit.
Zona waktu	Zona waktu untuk rapat. Jika tidak diberikan, zona waktu pengguna akan digunakan.
Deskripsi	Deskripsi rapat.

Menyiapkan autentikasi dan izin untuk Google Kalender

Sebelum mengaktifkan tindakan Google Kalender, administrator harus mengaktifkan Google Calendar API dan menyiapkan otorisasi sebagai berikut. Google Cloud

Mengaktifkan Google Calendar API

Di konsol Google Cloud , aktifkan API berikut:

• Google Calendar API: Aktifkan API.

• Google People API: Aktifkan API.

Membuat aplikasi OAuth dan menambahkan cakupan

Jika Anda tidak memiliki aplikasi OAuth, ikuti langkah-langkah berikut. Jika Anda sudah memiliki aplikasi OAuth, lanjutkan ke Buat kredensial klien OAuth.

1. Buka Google Auth Platform / Overview.

2. Klik Mulai.

3. Masukkan nama untuk aplikasi OAuth Anda.

4. Masukkan email dukungan pengguna.

5. Pilih Internal.

6. Masukkan informasi kontak developer.

7. Klik Buat.

Membuat kredensial klien OAuth

Prosedur ini menjelaskan cara membuat ID klien OAuth baru untuk Google Cloud tindakan. ID dan rahasia klien OAuth ini juga dapat digunakan untuk tindakan Google Cloud lainnya. Jika sudah memiliki Google Cloud ID klien OAuth untuk Google Cloud tindakan, Anda dapat menggunakan ID klien dan rahasia tersebut untuk tindakan Google Kalender, bukan membuat ID klien baru.

1. Buka Google Auth Platform / Clients.

2. Klik Buat klien.

3. Untuk Jenis aplikasi, pilih Aplikasi web.

4. Untuk Name, masukkan nama untuk ID klien Anda.

5. Di bagian URI pengalihan yang diberi otorisasi, klik Tambahkan URI dan masukkan URI berikut: https://vertexaisearch.cloud.google.com/oauth-redirect

6. Klik Buat dan salin informasi berikut:

   • ID Klien
   • Rahasia klien

Menambahkan tindakan Google Kalender

Ikuti langkah-langkah berikut untuk membuat tindakan Google Kalender menggunakan konsol atau API:

Sebelum memulai

Sebelum dapat menambahkan tindakan Google Kalender, pastikan Anda memiliki prasyarat yang diperlukan, termasuk aplikasi yang ada dan detail autentikasi.

• Administrator Google Cloud harus menyelesaikan langkah-langkah di bagian Menyiapkan autentikasi dan izin untuk Google Kalender terlebih dahulu dan memberi Anda ID klien dan rahasia klien sebelum Anda dapat menambahkan tindakan.

• Anda harus memiliki aplikasi Gemini Enterprise yang sudah ada dan terhubung ke penyimpanan data Google Kalender. Untuk membuat aplikasi baru, lihat Membuat aplikasi.

• Jika Anda baru saja mengaktifkan Discovery Engine API di Google Cloud project dan membuat aplikasi, tunggu minimal 15 menit hingga penyiapan aplikasi selesai sebelum Anda mengonfigurasi tindakan Google Kalender.

Mengonfigurasi tindakan Google Kalender

Konsol

Untuk menambahkan tindakan ke aplikasi menggunakan konsol, lakukan hal berikut:

1. Di Gemini Enterprise, buka halaman Gemini Enterprise.
2. Pilih aplikasi Gemini Enterprise Anda.
3. Di menu navigasi, klik Tindakan.

4. Tambahkan tindakan:

   • Jika ini adalah tindakan pertama Anda, klik Tambahkan tindakan.

   • Jika Anda telah membuat tindakan sebelumnya, klik Buat.

5. Untuk Google Kalender, klik Hubungkan.

6. Masukkan nama untuk konektor tindakan Anda.

7. Masukkan informasi otorisasi untuk konektor tindakan Anda:

   1. Untuk Client ID baru dan Rahasia klien baru, masukkan client ID dan rahasia klien yang dibuat oleh administrator Anda di bagian Buat kredensial klien OAuth.
   2. Klik Verify Auth dan berikan akses aplikasi Gemini Enterprise ke Google Kalender Anda.

8. Pilih tindakan yang akan diaktifkan.

9. Klik Finish Setup. Tindakan Anda ditampilkan di halaman Tindakan.

REST

Untuk menambahkan tindakan ke aplikasi menggunakan API, lakukan hal berikut.

1. Buat konektor tindakan untuk tindakan Google Kalender.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-GFE-SSL: yes" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
   -d '{
     "collection_id":"CONNECTOR_ID",
     "collection_display_name":"CONNECTOR_DISPLAY_NAME",
     "data_connector":{
         "data_source":"google_calendar",
         "action_config":{
           "is_action_configured":true,
           "action_params":{
               "client_id":"CLIENT_ID",
               "client_secret":"CLIENT_SECRET"
           }
         },
         "connector_modes": ["ACTIONS"]
     }
   }'
   

   • PROJECT_ID: ID project tempat Anda ingin membuat konektor tindakan Google Kalender.
   • LOCATION: multi-region konektor tindakan Google Kalender Anda: global, us, atau eu.
   • CONNECTOR_ID: ID konektor yang ingin Anda buat. ID ini hanya boleh berisi huruf kecil, digit, garis bawah, dan tanda hubung.
   • CONNECTOR_DISPLAY_NAME: nama tampilan konektor yang ingin Anda buat.
   • CLIENT_ID: client ID yang dibuat oleh administrator Anda, di Create OAuth client credentials.
   • CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di Buat kredensial klien OAuth.

2. Tautkan konektor tindakan Google Kalender yang Anda buat ke aplikasi yang ada.

   Catatan: Jika tindakan sudah dikonfigurasi untuk aplikasi Anda, menjalankan perintah berikut akan membatalkan tautannya. Untuk mempertahankan tindakan yang ada dan menautkan tindakan Google Kalender, Anda harus menyertakan detail tindakan yang ada dalam permintaan API. Untuk mengetahui informasi selengkapnya, lihat Menautkan tindakan Google Kalender dan Gmail ke aplikasi.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
   -d '{
     "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
     "enabled_tools": {
       "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
         "tool_info": [
           {
             "tool_name": "create_calendar_event",
             "tool_display_name": "Create Calendar Event"
           }
         ]
       }
     }
   }'
   

   • PROJECT_ID: ID project tempat aplikasi dan konektor tindakan Google Kalender Anda berada.
   • LOCATION: multi-region aplikasi dan konektor tindakan Anda: global, us, atau eu.
   • APP_ID: ID aplikasi yang ingin Anda lampirkan tindakan.
   • CONNECTOR_ID: ID konektor tindakan Google Kalender yang dibuat pada langkah sebelumnya.

Setelah Anda menambahkan tindakan, asisten dapat melakukan tindakan tersebut atas nama pengguna akhir Anda di aplikasi. Saat pengguna pertama kali meminta asisten untuk melakukan tindakan Google Kalender, mereka akan diminta untuk mengizinkan akses ke akun Google Kalender mereka.

Tindakan Gmail

Jika tindakan Gmail diaktifkan, pengguna akhir dapat meminta asisten untuk mengirim email bagi mereka.

Misalnya, pengguna dapat memasukkan "kirim email ke [e-mail] dengan judul 'Halo' dan konten 'apa kabar?'". Asisten akan meminta detail tambahan jika diperlukan, lalu meminta pengguna untuk mengonfirmasi pengiriman email.

Asisten dapat membaca dan mengedit kolom Gmail berikut melalui tindakan:

Kolom	Deskripsi
Ke	Wajib. Daftar email penerima.
Subjek	Wajib. Subjek email
Konten	Wajib. Isi email dalam format Markdown.
CC	Daftar CC email.
BCC	Daftar BCC email.

Menyiapkan autentikasi dan izin untuk Gmail

Sebelum mengaktifkan tindakan Gmail, administrator harus mengaktifkan Gmail API dan menyiapkan otorisasi. Google Cloud

Mengaktifkan Gmail API

Di konsol Google Cloud , aktifkan API berikut:

• Gmail API: Aktifkan API.

• Google People API: Aktifkan API.

Membuat aplikasi OAuth dan menambahkan cakupan

Jika Anda tidak memiliki aplikasi OAuth, ikuti langkah-langkah berikut. Jika Anda sudah memiliki aplikasi OAuth, lanjutkan ke Buat kredensial klien OAuth.

1. Buka Google Auth Platform / Overview.

2. Klik Mulai.

3. Masukkan nama untuk aplikasi OAuth Anda.

4. Masukkan email dukungan pengguna.

5. Pilih Internal.

6. Masukkan informasi kontak developer.

7. Klik Buat.

Membuat kredensial klien OAuth

Prosedur ini menjelaskan cara membuat ID klien OAuth baru untuk Google Cloud tindakan. ID dan rahasia klien OAuth ini juga dapat digunakan untuk tindakan Google Cloud lainnya. Jika sudah memiliki Google Cloud ID klien OAuth untuk Google Cloud tindakan, Anda dapat menggunakan ID klien dan rahasia tersebut untuk tindakan Google Kalender, bukan membuat ID klien baru.

1. Buka Google Auth Platform / Clients.

2. Klik Buat klien.

3. Untuk Jenis aplikasi, pilih Aplikasi web.

4. Untuk Name, masukkan nama untuk ID klien Anda.

5. Di bagian URI pengalihan yang diberi otorisasi, klik Tambahkan URI dan masukkan URI berikut: https://vertexaisearch.cloud.google.com/oauth-redirect

6. Klik Buat dan salin informasi berikut:

   • ID Klien
   • Rahasia klien

Menambahkan tindakan Gmail

Ikuti langkah-langkah berikut untuk membuat tindakan Gmail menggunakan konsol atau API:

Sebelum memulai

Sebelum dapat menambahkan tindakan Gmail, pastikan Anda telah memenuhi prasyarat yang diperlukan, termasuk aplikasi yang ada dan detail autentikasi.

• Administrator Google Cloud harus menyelesaikan langkah-langkah di bagian Menyiapkan autentikasi dan izin untuk Gmail terlebih dahulu dan memberi Anda ID klien dan rahasia klien sebelum Anda dapat menambahkan tindakan.

• Anda harus memiliki aplikasi Gemini Enterprise yang sudah ada dan terhubung ke penyimpanan data Gmail. Untuk membuat aplikasi baru, lihat Membuat aplikasi.

• Jika Anda baru saja mengaktifkan Discovery Engine API di Google Cloud project dan membuat aplikasi, tunggu minimal 15 menit hingga penyiapan aplikasi selesai sebelum Anda mengonfigurasi tindakan Gmail.

Mengonfigurasi tindakan Gmail

Konsol

Untuk menambahkan tindakan ke aplikasi menggunakan konsol, lakukan hal berikut:

1. Di Gemini Enterprise, buka halaman Gemini Enterprise.
2. Pilih aplikasi Gemini Enterprise Anda.
3. Di menu navigasi, klik Tindakan.

4. Tambahkan tindakan:

   • Jika ini adalah tindakan pertama Anda, klik Tambahkan tindakan.

   • Jika Anda telah membuat tindakan sebelumnya, klik Buat.

5. Untuk Gmail, klik Hubungkan.

6. Masukkan nama untuk konektor tindakan Anda.

7. Masukkan informasi otorisasi untuk konektor tindakan Anda:

   1. Untuk Client ID baru dan Rahasia klien baru, masukkan client ID dan rahasia klien yang dibuat oleh administrator Anda di bagian Buat kredensial klien OAuth.
   2. Klik Verifikasi Auth dan berikan akses aplikasi Gemini Enterprise ke Gmail Anda.

8. Pilih tindakan yang akan diaktifkan.

9. Klik Finish Setup. Tindakan Anda ditampilkan di halaman Tindakan.

REST

Untuk menambahkan tindakan ke aplikasi menggunakan API, lakukan hal berikut.

1. Buat konektor tindakan untuk tindakan Gmail.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-GFE-SSL: yes" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
   -d '{
     "collection_id":"CONNECTOR_ID",
     "collection_display_name":"CONNECTOR_DISPLAY_NAME",
     "data_connector":{
         "data_source":"gmail",
         "action_config":{
           "is_action_configured":true,
           "action_params":{
               "client_id":"CLIENT_ID",
               "client_secret":"CLIENT_SECRET"
           }
         },
         "connector_modes": ["ACTIONS"]
     }
   }'
   

   • PROJECT_ID: ID project tempat Anda ingin membuat konektor tindakan Gmail.
   • LOCATION: multi-region konektor tindakan Gmail Anda: global, us, atau eu.
   • CONNECTOR_ID: ID konektor yang ingin Anda buat. ID ini hanya boleh berisi huruf kecil, digit, garis bawah, dan tanda hubung.
   • CONNECTOR_DISPLAY_NAME: nama tampilan konektor yang ingin Anda buat.
   • CLIENT_ID: client ID yang dibuat oleh administrator Anda, di Create OAuth client credentials.
   • CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di Buat kredensial klien OAuth.

2. Tautkan konektor tindakan Gmail yang Anda buat ke aplikasi yang sudah ada.

   Catatan: Jika tindakan sudah dikonfigurasi untuk aplikasi Anda, menjalankan perintah berikut akan membatalkan tautannya. Untuk mempertahankan tindakan yang ada dan menautkan tindakan Gmail, Anda harus menyertakan detail tindakan yang ada dalam permintaan API. Untuk mengetahui informasi selengkapnya, lihat Menautkan tindakan Google Kalender dan Gmail ke aplikasi.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
   -d '{
     "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
     "enabled_tools": {
       "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
         "tool_info": [
           {
             "tool_name": "send_email",
             "tool_display_name": "Send Email"
           }
         ]
       }
     }
   }'
   

   • PROJECT_ID: ID project tempat konektor tindakan Gmail dan aplikasi Anda berada.
   • LOCATION: multi-region aplikasi dan konektor Anda: global, us, atau eu.
   • APP_ID: ID aplikasi yang ingin Anda lampirkan tindakan.
   • CONNECTOR_ID: ID konektor tindakan Gmail yang dibuat pada langkah sebelumnya.

Setelah Anda menambahkan tindakan, asisten dapat melakukan tindakan tersebut atas nama pengguna akhir Anda di aplikasi. Saat pengguna pertama kali meminta asisten untuk melakukan tindakan Gmail, mereka akan diminta untuk mengizinkan akses ke akun Gmail mereka.

Menautkan tindakan Google Kalender dan Gmail ke aplikasi

Permintaan API berikut menunjukkan cara menautkan tindakan Google Kalender dan Gmail ke aplikasi yang ada.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'

• PROJECT_ID: ID project tempat aplikasi Anda dan konektor tindakan Google Kalender dan Gmail berada.
• LOCATION: multi-region aplikasi dan konektor Anda: global, us, atau eu.
• APP_ID: ID aplikasi yang ingin Anda lampirkan tindakan.
• CALENDAR_CONNECTOR_ID: ID konektor tindakan Google Kalender yang dibuat pada langkah sebelumnya.
• GMAIL_CONNECTOR_ID: ID konektor tindakan Gmail yang dibuat pada langkah sebelumnya.

Setelah Anda menambahkan tindakan, asisten dapat melakukan tindakan tersebut atas nama pengguna akhir Anda di aplikasi. Saat pengguna pertama kali meminta asisten untuk melakukan tindakan Google Kalender atau Gmail, mereka akan diminta untuk mengizinkan akses ke akun mereka.