新增 Outlook 行事曆和電子郵件動作

下頁說明如何設定 Outlook 電子郵件和 Outlook 行事曆的動作。

新增 Outlook 電子郵件動作

啟用 Outlook 電子郵件動作後，使用者可以要求助理代為傳送電子郵件。

舉例來說，使用者可以輸入「send an email to userA@example.com with title 'Today's meeting' and content 'What's the agenda?'」(傳送電子郵件給 userA@example.com，主旨為「今天的會議」，內容為「議程是什麼？」)。如果需要其他詳細資料，Google 助理會詢問，然後要求使用者確認是否要傳送電子郵件。

助理可透過動作讀取及編輯下列 Outlook 欄位：

欄位 說明
收件者 這是必要旗標，收件者電子郵件地址清單。
主旨 這是必要旗標，電子郵件主旨
內容 這是必要旗標，電子郵件內容 (Markdown 格式)。
CC 電子郵件的副本清單。
密件副本 電子郵件的密件副本清單。

設定 Outlook 電子郵件的驗證和權限

管理員必須先設定 Outlook 的驗證和權限，才能啟用 Outlook 動作。

下列程序適用於 Outlook 電子郵件和 Outlook 行事曆動作。 如要同時使用電子郵件和日曆動作，請在啟用範圍的程序中，同時啟用這兩者的範圍。

建立 OAuth 應用程式並新增範圍

  1. 登入 https://portal.azure.com/，然後前往「App registrations」(應用程式註冊) 頁面。

  2. 按一下 [新增註冊]。

    1. 為應用程式命名。
    2. 重新導向 URI：
      • 選取「網站」做為平台類型。
      • 新增下列重新導向 URI： https://vertexaisearch.cloud.google.com/oauth-redirect

  3. 在「憑證和密鑰」下方，建立新的用戶端密鑰。請記下用戶端密鑰。且只會在建立後立即顯示。

如要啟用必要範圍，請按照下列步驟操作：

  1. 前往 Azure 應用程式的「API Permissions」設定頁面。
  2. 按一下「新增權限」。
  3. 選取「Microsoft Graph」。
  4. 選取「委派權限」。
  5. 新增下列範圍：
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (如需日曆動作)
    4. Mail.Send (如果需要電子郵件動作)

視 Azure 中的機構設定類型而定，最後啟用範圍的步驟可能會省略。

設定 Outlook 電子郵件動作

開始之前，請確認 Google Cloud 管理員已完成「設定 Outlook 電子郵件的驗證和權限」一文中的步驟，並提供下列資訊：

  • 用戶端 ID
  • 用戶端密鑰
  • 租戶 ID (在 API 中稱為執行個體 ID)

使用 API 設定 Outlook 電子郵件動作

如要使用 API 在應用程式中新增動作，請按照下列步驟操作。

您可以使用下列操作說明設定 Outlook 電子郵件和日曆動作。如果您已設定 Outlook 行事曆動作，就不需要再次執行這些步驟。

  1. 如果尚未將 Outlook 資料連結至 Gemini Enterprise，請建立 Outlook 連接器。如果已有 Outlook 連接器，請前往下一個步驟。

    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",
  }
}'

    更改下列內容：

    • PROJECT_NUMBER：您的 Google Cloud 專案編號。
    • COLLECTION_ID：集合的 ID。
    • COLLECTION_DISPLAY_NAME：集合的顯示名稱。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。

  2. 在 Outlook 連接器中加入動作設定：

    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",
      }
    }
  }'

    更改下列內容：

    • PROJECT_NUMBER：您的 Google Cloud 專案編號。
    • COLLECTION_ID：集合的 ID。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。

  3. 為 Google 助理啟用 Outlook 動作。如果只需要電子郵件動作，請省略日曆的項目。

    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"
          }
        ]
      }
    }
  }'

    更改下列內容：

    • PROJECT_ID：應用程式和 Outlook 連接器所在的專案 ID。
    • LOCATION：應用程式和連接器的多重區域：global、us 或 eu。
    • APP_ID：要附加動作的應用程式 ID。
    • COLLECTION_ID：在上一步中建立的 Outlook 連接器 ID。

新增動作後，Google 助理就能在應用程式中代表使用者執行這些動作。使用者首次要求 Google 助理執行 Outlook 動作時，系統會要求他們授權存取 Outlook 帳戶。如要使用助理，使用者必須擁有 Gemini Enterprise Enterprise Plus 授權。

新增 Outlook 行事曆動作

啟用 Outlook 行事曆動作後，使用者就能要求助理為自己建立行事曆活動。

舉例來說，使用者可以輸入「在 11 月 4 日星期五上午 11 點與 userA@example.com 安排會議」。如有需要，Google 助理會要求提供其他詳細資料，然後請使用者確認是否要建立活動。

助理可透過動作讀取及編輯下列 Outlook 行事曆欄位：

欄位 說明
與會者 這是必要旗標，與會者的電子郵件地址清單。系統會自動將要求者加入清單。
標題 會議標題。
開始時間 會議開始時間。
時間長度 會議時間長度。預設值為 30 分鐘。
時區 會議時區。如未提供，系統會使用使用者的時區。
說明 會議說明。

設定 Outlook 行事曆的驗證和權限

管理員必須先設定 Outlook 的驗證和權限，才能啟用 Outlook 動作。

下列程序適用於 Outlook 電子郵件和 Outlook 行事曆動作。 如要同時使用電子郵件和日曆動作，請在啟用範圍的程序中，同時啟用這兩者的範圍。

建立 OAuth 應用程式並新增範圍

  1. 登入 https://portal.azure.com/，然後前往「App registrations」(應用程式註冊) 頁面。

  2. 按一下 [新增註冊]。

    1. 為應用程式命名。
    2. 重新導向 URI：
      • 選取「網站」做為平台類型。
      • 新增下列重新導向 URI： https://vertexaisearch.cloud.google.com/oauth-redirect

  3. 在「憑證和密鑰」下方，建立新的用戶端密鑰。請記下用戶端密鑰。且只會在建立後立即顯示。

如要啟用必要範圍，請按照下列步驟操作：

  1. 前往 Azure 應用程式的「API Permissions」設定頁面。
  2. 按一下「新增權限」。
  3. 選取「Microsoft Graph」。
  4. 選取「委派權限」。
  5. 新增下列範圍：
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (如需日曆動作)
    4. Mail.Send (如果需要電子郵件動作)

視 Azure 中的機構設定類型而定，最後啟用範圍的步驟可能會省略。

設定 Outlook 行事曆動作

開始前，請確認 Microsoft Outlook 管理員已完成「設定 Outlook 行事曆的驗證和權限」一文中的步驟，並提供下列資訊：

  • 用戶端 ID
  • 用戶端密鑰
  • 租戶 ID (在 API 中稱為執行個體 ID)

使用 API 設定 Outlook 行事曆動作

您可以使用下列操作說明設定 Outlook 電子郵件和日曆動作。如果您已設定 Outlook 電子郵件動作，就不需要再次執行這些步驟。

如要使用 API 在應用程式中新增動作，請按照下列步驟操作。

  1. 如果尚未將 Outlook 資料連結至 Gemini Enterprise，請建立 Outlook 連接器。如果已有 Outlook 連接器，請前往下一個步驟。

    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",
  }
}'

    更改下列內容：

    • PROJECT_NUMBER：您的 Google Cloud 專案編號。
    • COLLECTION_ID：集合的 ID。
    • COLLECTION_DISPLAY_NAME：集合的顯示名稱。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。

  2. 在 Outlook 連接器中加入動作設定：

    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",
      }
    }
  }'

    更改下列內容：

    • PROJECT_NUMBER：您的 Google Cloud 專案編號。
    • COLLECTION_ID：集合的 ID。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。

  3. 為 Google 助理啟用 Outlook 動作。

    您可以在 UI 上將新的資料連接器與助理建立關聯。您需要下列 API 指令來啟用 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"
          }
        ]
      }
    }
  }'

    更改下列內容：

    • PROJECT_ID：應用程式和 Outlook 連接器所在的專案 ID。
    • APP_ID：要附加動作的應用程式 ID。
    • COLLECTION_ID：在上一步中建立的 Outlook 連接器 ID。

新增動作後，Google 助理就能在應用程式中代表使用者執行這些動作。使用者首次要求 Google 助理執行 Outlook 動作時，系統會要求他們授權存取 Outlook 帳戶。如要使用助理，使用者必須擁有 Gemini Enterprise Enterprise Plus 授權。