Halaman ini diterjemahkan oleh Cloud Translation API.

Menambahkan tindakan email dan kalender Outlook

Halaman berikut menjelaskan cara menyiapkan tindakan untuk email Outlook dan kalender Outlook.

Menambahkan tindakan email Outlook

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

Misalnya, pengguna dapat memasukkan "kirim email ke userA@example.com dengan judul 'Rapat hari ini' dan isi 'Apa agendanya?'". Asisten akan meminta detail tambahan jika diperlukan, lalu meminta pengguna untuk mengonfirmasi pengiriman email.

Asisten dapat membaca dan mengedit kolom Outlook 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 email Outlook

Sebelum mengaktifkan tindakan Outlook, administrator harus menyiapkan autentikasi dan izin untuk Outlook.

Prosedur berikut berlaku untuk tindakan email Outlook dan kalender Outlook. Jika Anda berencana menggunakan tindakan email dan kalender, aktifkan cakupan untuk keduanya selama prosedur pengaktifan cakupan.

Membuat aplikasi OAuth dan menambahkan cakupan

Login ke https://portal.azure.com/ dan buka halaman App registrations.
Klik New registration.
1. Beri nama aplikasi Anda.
2. Untuk URI pengalihan:
  - Untuk jenis platform, pilih Web.
  - Tambahkan URI pengalihan berikut: https://vertexaisearch.cloud.google.com/oauth-redirect
Di bagian Certificates & Secrets, buat rahasia klien baru. Catat rahasia klien. ID ini hanya ditampilkan segera setelah pembuatan.

Untuk mengaktifkan cakupan yang diperlukan:

Buka halaman setelan Izin API di Aplikasi Azure Anda.
Klik Tambahkan izin.
Pilih Microsoft Graph.
Pilih Izin yang Didelegasikan.
Tambahkan cakupan berikut:
1. offline_access
2. User.Read
3. Calendars.ReadWrite (jika tindakan kalender diperlukan)
4. Mail.Send (jika tindakan email diperlukan)

Bergantung pada jenis Setelan organisasi di Azure Anda, langkah terakhir untuk mengaktifkan cakupan ini dapat dihilangkan.

Mengonfigurasi tindakan email Outlook

Sebelum memulai, pastikan administrator telah menyelesaikan langkah-langkah di Menyiapkan autentikasi dan izin untuk email Outlook dan memberi Anda hal berikut: Google Cloud

ID Klien
Rahasia klien
ID Tenant (disebut ID Instance di API)

Mengonfigurasi tindakan email Outlook menggunakan API

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

Petunjuk berikut dapat digunakan untuk mengonfigurasi tindakan email dan kalender Outlook. Jika sudah mengonfigurasi tindakan kalender Outlook, Anda tidak perlu melakukan langkah-langkah ini lagi.

Jika Anda belum menghubungkan data Outlook dengan Gemini Enterprise, buat konektor Outlook. Jika Anda sudah memiliki konektor Outlook, lanjutkan ke langkah berikutnya.

SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

Ganti kode berikut:

PROJECT_NUMBER: jumlah project Google Cloud Anda.
COLLECTION_ID: ID untuk koleksi.
COLLECTION_DISPLAY_NAME: nama tampilan untuk koleksi.
CLIENT_ID: client ID yang dibuat oleh administrator Anda, di bagian Membuat aplikasi OAuth dan menambahkan cakupan.
CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di bagian Buat aplikasi OAuth dan tambahkan cakupan.

Sertakan konfigurasi tindakan di konektor Outlook Anda:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

Ganti kode berikut:

PROJECT_NUMBER: jumlah project Google Cloud Anda.
COLLECTION_ID: ID untuk koleksi.
CLIENT_ID: client ID yang dibuat oleh administrator Anda, di bagian Membuat aplikasi OAuth dan menambahkan cakupan.
CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di bagian Buat aplikasi OAuth dan tambahkan cakupan.

Aktifkan tindakan Outlook untuk asisten Anda. Jangan sertakan entri untuk kalender jika Anda hanya memerlukan tindakan email.

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

Ganti kode berikut:

PROJECT_ID: ID project tempat aplikasi dan konektor Outlook Anda berada.
LOCATION: multi-region aplikasi dan konektor Anda: global, us, atau eu.
APP_ID: ID aplikasi yang ingin Anda lampirkan tindakan.
COLLECTION_ID: ID konektor Outlook 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 Outlook, mereka akan diminta untuk mengizinkan akses ke akun Outlook mereka. Untuk menggunakan asisten, pengguna harus memiliki lisensi Gemini Enterprise Enterprise Plus.

Menambahkan tindakan kalender Outlook

Jika tindakan kalender Outlook diaktifkan, pengguna akhir dapat meminta asisten membuat acara kalender untuk mereka.

Misalnya, pengguna dapat memasukkan "jadwalkan rapat dengan userA@example.com pada pukul 11.00 pada hari Jumat, 4 November". Asisten akan meminta detail tambahan jika diperlukan, lalu meminta pengguna untuk mengonfirmasi pembuatan acara.

Asisten dapat membaca dan mengedit kolom kalender Outlook berikut melalui tindakan:

Kolom	Deskripsi
Tamu	Wajib. Daftar alamat email peserta. Pengguna yang meminta secara 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 kalender Outlook

Sebelum mengaktifkan tindakan Outlook, administrator harus menyiapkan autentikasi dan izin untuk Outlook.

Membuat aplikasi OAuth dan menambahkan cakupan

Login ke https://portal.azure.com/ dan buka halaman App registrations.
Klik New registration.
1. Beri nama aplikasi Anda.
2. Untuk URI pengalihan:
  - Untuk jenis platform, pilih Web.
  - Tambahkan URI pengalihan berikut: https://vertexaisearch.cloud.google.com/oauth-redirect
Di bagian Certificates & Secrets, buat rahasia klien baru. Catat rahasia klien. ID ini hanya ditampilkan segera setelah pembuatan.

Untuk mengaktifkan cakupan yang diperlukan:

Buka halaman setelan Izin API di Aplikasi Azure Anda.
Klik Tambahkan izin.
Pilih Microsoft Graph.
Pilih Izin yang Didelegasikan.
Tambahkan cakupan berikut:
1. offline_access
2. User.Read
3. Calendars.ReadWrite (jika tindakan kalender diperlukan)
4. Mail.Send (jika tindakan email diperlukan)

Bergantung pada jenis Setelan organisasi di Azure Anda, langkah terakhir untuk mengaktifkan cakupan ini dapat dihilangkan.

Mengonfigurasi tindakan kalender Outlook

Sebelum memulai, pastikan administrator Microsoft Outlook telah menyelesaikan langkah-langkah di Menyiapkan autentikasi dan izin untuk kalender Outlook dan memberi Anda hal berikut:

ID Klien
Rahasia klien
ID Tenant (disebut ID Instance di API)

Mengonfigurasi tindakan kalender Outlook menggunakan API

Petunjuk berikut dapat digunakan untuk mengonfigurasi tindakan email dan kalender Outlook. Jika sudah mengonfigurasi tindakan email Outlook, Anda tidak perlu melakukan langkah-langkah ini lagi.

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

Jika Anda belum menghubungkan data Outlook dengan Gemini Enterprise, buat konektor Outlook. Jika Anda sudah memiliki konektor Outlook, lanjutkan ke langkah berikutnya.

SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

Ganti kode berikut:

PROJECT_NUMBER: jumlah project Google Cloud Anda.
COLLECTION_ID: ID untuk koleksi.
COLLECTION_DISPLAY_NAME: nama tampilan untuk koleksi.
CLIENT_ID: client ID yang dibuat oleh administrator Anda, di bagian Membuat aplikasi OAuth dan menambahkan cakupan.
CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di bagian Buat aplikasi OAuth dan tambahkan cakupan.

Sertakan konfigurasi tindakan di konektor Outlook Anda:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

Ganti kode berikut:

PROJECT_NUMBER: jumlah project Google Cloud Anda.
COLLECTION_ID: ID untuk koleksi.
CLIENT_ID: client ID yang dibuat oleh administrator Anda, di bagian Membuat aplikasi OAuth dan menambahkan cakupan.
CLIENT_SECRET: rahasia klien yang dibuat oleh administrator Anda, di bagian Buat aplikasi OAuth dan tambahkan cakupan.

Aktifkan tindakan Outlook untuk asisten Anda.

Anda dapat mengaitkan konektor data baru dengan asisten Anda di UI. Anda memerlukan perintah API berikut untuk mengaktifkan tindakan Outlook:

SERVER=https://discoveryengine.googleapis.com
PROJECT_NUMBER={YOUR PROJECT_NUMBER}
ENGINE_ID="{YOUR ENGINE ID}"
CONNECTOR_ID="{THE CONNECTOR'S COLLECTION ID YOU GENERATED IN PREVIOUS STEP}"

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

Ganti kode berikut:

PROJECT_ID: ID project tempat aplikasi dan konektor Outlook Anda berada.
APP_ID: ID aplikasi yang ingin Anda lampirkan tindakan.
COLLECTION_ID: ID konektor Outlook yang dibuat pada langkah sebelumnya.