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

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

新增 Outlook 電子郵件動作

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

舉例來說，使用者可以輸入「傳送電子郵件給 userA@example.com，主旨為『今天的會議』，內容為『議程是什麼？』」。視需要提供其他詳細資料，然後確認是否要傳送電子郵件。

助理可透過動作讀取及編輯下列 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://ENDPOINT_LOCATION-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/LOCATION: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",
  }
}'

    更改下列內容：

    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • PROJECT_NUMBER： Google Cloud 專案的編號。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • COLLECTION_ID：集合的 ID。
    • COLLECTION_DISPLAY_NAME：集合的顯示名稱。
    • INSTANCE_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的租戶 ID。
    • 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://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/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 專案的編號。
    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • COLLECTION_ID：集合的 ID。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。
    • INSTANCE_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的租戶 ID。

  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" \
  "ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/LOCATION/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    更改下列內容：

    • PROJECT_NUMBER： Google Cloud 專案的編號。
    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • 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://ENDPOINT_LOCATION-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" \
"ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION: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",
  }
}'

    更改下列內容：

    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • PROJECT_NUMBER： Google Cloud 專案的編號。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • COLLECTION_ID：集合的 ID。
    • COLLECTION_DISPLAY_NAME：集合的顯示名稱。
    • INSTANCE_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的租戶 ID。
    • 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://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

    更改下列內容：

    • PROJECT_NUMBER： Google Cloud 專案的編號。
    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • COLLECTION_ID：集合的 ID。
    • CLIENT_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端 ID。
    • CLIENT_SECRET：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的用戶端密鑰。
    • INSTANCE_ID：管理員在「建立 OAuth 應用程式並新增範圍」一節中建立的租戶 ID。

  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" \
  "ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/LOCATION/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    更改下列內容：

    • PROJECT_NUMBER： Google Cloud 專案的編號。
    • ENDPOINT_LOCATION：API 要求的適用多區域。指派下列其中一個值：
      • 美國多區域：us-
      • eu- 適用於歐盟多區域
      • global- 全球位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION： 資料存放區的地理位置，例如 global。 詳情請參閱「位置」。
    • APP_ID：要附加動作的應用程式 ID。
    • COLLECTION_ID：在上一個步驟中建立的 Outlook 連接器 ID。

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