總覽

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

支援的 Microsoft Outlook 版本

Microsoft Outlook 資料儲存庫支援 Microsoft Graph API v1.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 資料儲存庫每秒可處理一筆交易,超過這個限制的交易都會受到節流。

排解 Microsoft Outlook 資料儲存庫搜尋結果問題

身分不符 (資料擷取模式):如果您在使用 Google Identity 的資料擷取模式時,遇到電子郵件、日曆活動或搜尋結果遺失的問題,請確認每位使用者的 Google 電子郵件地址與 Microsoft 電子郵件地址相符。不相符時,Gemini Enterprise 就無法傳回搜尋結果。

後續步驟