總覽

Gemini Enterprise 的 Microsoft Outlook 資料儲存庫可讓您搜尋及執行電子郵件、日曆、聯絡人和 Microsoft 365 檔案 (Excel 活頁簿、Word 文件和 PowerPoint 簡報) 的動作，這些檔案儲存在 OneDrive 和 SharePoint 中。

支援的 Microsoft Outlook 版本

Microsoft Outlook 資料儲存庫支援 Microsoft Graph API 1.0 版，並可與 IDP 整合。

支援的動作

啟用 Microsoft Outlook 資料儲存庫後，使用者就能在 Gemini Enterprise 中使用自然語言指令執行下列操作。

動作 說明
建立聯絡人 在 Microsoft Outlook 中建立新聯絡人。
建立事件 建立新活動。
下載附件 下載 Microsoft Outlook 電子郵件訊息的附件。
傳送郵件 傳送電子郵件訊息。包括傳送含有附件的電子郵件。
新增連結 為現有的草稿電子郵件訊息新增一或多個附件。
建立訊息 在已登入使用者的信箱中，建立新的電子郵件草稿。
轉寄郵件 將現有電子郵件訊息轉寄給一或多位收件者。
移動郵件 將電子郵件訊息移至已登入使用者信箱中的其他郵件資料夾。
回覆訊息 回覆已登入使用者信箱中的現有電子郵件訊息。
更新訊息 更新已登入使用者信箱中的現有電子郵件訊息草稿。
更新聯絡人 更新 Microsoft Outlook 中的現有聯絡人。
更新活動 更新現有事件。
讀取 Excel 資料 列出活頁簿，並讀取儲存在 OneDrive 或 SharePoint 的 Excel (.xlsx) 檔案中的工作表、表格和資料列。
編輯 Excel 資料 在儲存於 OneDrive 或 SharePoint 的 Excel (.xlsx) 檔案中，新增及更新資料列、建立工作表和表格，以及新增索引鍵資料欄。
建立 Word 文件 在使用者 OneDrive 中建立新的 Word (.docx) 文件。
將 Word 文件轉換為 PDF 將儲存在 OneDrive 或 SharePoint 的 Word (.docx) 文件轉換成 PDF。
建立 PowerPoint 簡報 在使用者的 OneDrive 中建立新的 PowerPoint (.pptx) 簡報。
將 PowerPoint 轉換為 PDF 將儲存在 OneDrive 或 SharePoint 的 PowerPoint (.pptx) 簡報轉換成 PDF。
建立日曆 為已登入的使用者建立新日曆。
更新日曆 為已登入的使用者更新現有日曆。
敬請回覆活動邀請 回覆 (接受、拒絕或暫定接受) 日曆活動邀請。

所需權限

下表列出 Microsoft Outlook 搜尋和動作所需的權限。

連線模式 權限 Purpose
聯合搜尋 Mail.Read
Mail.Read.Shared
Calendars.Read
Contacts.Read		 (委派) 允許資料儲存庫讀取已登入使用者的信箱、共用信箱中的電子郵件、日曆活動和聯絡人。
資料擷取 Calendars.Read (應用程式) 允許資料儲存庫讀取所有日曆的活動。
Calendars.ReadBasic.All (應用程式) 允許資料儲存庫讀取所有日曆的事件，但內文、附件和擴充功能等屬性除外。
Contacts.Read (應用程式) 允許資料儲存庫讀取所有信箱中的所有聯絡人。
Mail.Read (應用程式) 允許資料儲存庫讀取所有信箱中的郵件。
Mail.ReadBasic (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包含除了 body、previewBody、attachments 和任何擴充屬性以外的所有屬性。
Mail.ReadBasic.All (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包含除了 body、previewBody、attachments 和任何擴充屬性以外的所有屬性。
User.Read (委派) 允許資料儲存庫讀取已登入使用者的設定檔。
User.Read.All (應用程式) 允許資料儲存庫讀取貴機構中其他使用者的完整設定檔屬性、報表和管理員。
User.ReadBasic.All (應用程式) 允許資料儲存庫讀取貴機構其他使用者的基本設定檔屬性。
動作 Mail.Send (委派) 允許資料儲存庫以組織使用者的身分傳送郵件。
Mail.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新、移動及刪除訊息，以及在訊息中新增附件。執行「新增附件」、「建立郵件」、「更新郵件」和「移動郵件」動作時，必須提供這項資訊。
Calendars.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新及刪除使用者日曆中的活動。
Contacts.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新及刪除使用者聯絡人。
User.Read (委派) 允許資料儲存庫讀取已登入使用者的設定檔。
檔案工作效率 (Excel、Word、PowerPoint) Files.Read.All (委派) 僅適用於讀取檔案中繼資料或下載檔案內容的工具：列出 Excel 活頁簿、讀取 Excel 活頁簿中繼資料，以及將 Word (.docx) 或 PowerPoint (.pptx) 文件轉換為 PDF。讀取使用者可存取的所有檔案，包括儲存在使用者可存取的 SharePoint 網站中的檔案。不足以執行 Excel 活頁簿內容作業 (請參閱下一列)。
Files.ReadWrite.All (委派) 所有 Excel 活頁簿內容作業 (讀取和寫入) 都需要這項權限，包括取得工作表、取得表格、取得資料列、取得資料列、建立工作表和表格、新增和更新資料列，以及新增索引鍵資料欄。根據這些端點 (例如 worksheet-list、table-list、tablerow-list) 的 Microsoft Graph API 參考資料，接受的委派權限為 Files.ReadWrite。Files.ReadWrite.All 會在使用者可存取的所有雲端硬碟 (個人 OneDrive 和使用者有權存取的任何 SharePoint 文件庫) 中，授予相同功能。在使用者 OneDrive 中建立 Word 和 PowerPoint 文件時，也需要這項權限。
User.Read (委派) 必須解析已登入使用者的 OneDrive 位置，才能執行檔案作業。
工作 (Outlook 待辦事項清單和工作) Tasks.Read (委派) 必須具備此權限，才能對已登入使用者的 Outlook 工作清單和工作執行讀取作業 (列出工作清單、列出工作、取得工作)。
Tasks.ReadWrite (委派) 寫入作業的必要權限：在已登入使用者的 Outlook 工作清單中建立、更新及刪除工作。
使用者和目錄 (委派列舉) User.ReadBasic.All (委派) 適用於列舉或查詢組織中其他使用者設定檔的工具 (取得使用者、列出使用者，以及在其他使用者的信箱或日曆上運作的工具)。

如要瞭解如何新增 Microsoft Outlook 權限，請參閱「設定 Microsoft Outlook 並設定必要權限」。

資料擷取頻率限制

要求量上限為每 10 分鐘 10,000 項 API 要求。如果選擇使用擷取做為連線模式，這些頻率限制僅適用於 Microsoft Outlook 資料儲存庫。

限制

本節概述可能影響您使用 Microsoft Outlook 資料儲存庫的已知問題和限制。

  • 建立新應用程式或將資料儲存庫新增至現有應用程式時，建議只將一個資料儲存庫與屬於單一連接器類型的動作建立關聯。
  • 不支援對現有 Microsoft Outlook 資料儲存庫強制執行 VPC Service Controls perimeter。如要強制執行 VPC Service Controls，請刪除並重新建立資料儲存庫。如要進一步瞭解 VPC Service Controls，以及如何在啟用 VPC Service Controls 後使用動作，請參閱「使用 VPC Service Controls 保護應用程式」。
  • Microsoft Outlook 資料儲存庫僅支援 global、us 和 eu 位置。

  • Microsoft Outlook 資料儲存庫每秒可處理一筆交易 (以節點為單位)，超過這個限制的交易都會受到節流。

  • Microsoft Outlook 資料儲存庫能否在發生「超出頻率限制」錯誤時重試，取決於是否收到 Microsoft Graph API 的 retry-after 值，而這個值僅適用於 Outlook 資料儲存庫。預設重試次數為三次。

  • Microsoft Outlook 資料儲存庫的處理量，受限於 Microsoft Graph 施加的 API 呼叫限制。限制適用於每個應用程式 ID 和信箱組合，也就是特定應用程式存取特定使用者或群組信箱。超過一個信箱的限制，不會影響應用程式存取其他信箱的能力。

  • Microsoft Outlook 資料儲存庫與單一 Azure 租用戶 ID 是一對一對應。無法跨越多租戶組織 (MTO) 內多個獨立的 Microsoft 365 租戶。您必須為每個租戶建立專屬的資料儲存庫。

  • 信箱必須完整遷移至 Exchange Online。在混合式 Exchange 環境中，Microsoft Graph API 無法存取託管於地端部署的信箱。如果嘗試查詢這些信箱或跨租戶信箱，可能會發生 MailboxNotEnabledForRESTAPI 錯誤。

  • Microsoft Outlook 資料儲存庫每秒可處理一筆交易，超過這個限制的交易都會受到節流。

後續步驟