總覽

透過 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 (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包括所有屬性,但主體、previewBody、附件和任何擴充屬性除外。
Mail.ReadBasic.All (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包括所有屬性,但主體、previewBody、附件和任何擴充屬性除外。
User.Read (委派) 允許資料存放區讀取已登入使用者的設定檔。
User.Read.All (應用程式) 允許資料存放區讀取貴機構中其他使用者的完整設定檔屬性、報表和管理員。
User.ReadBasic.All (應用程式) 允許資料存放區讀取貴機構中其他使用者的基本設定檔屬性。
動作 Mail.Send (已委派) 允許資料儲存庫以機構中的使用者身分傳送郵件。
Calendars.ReadWrite (已委派) 允許資料存放區在使用者日曆中建立、讀取、更新及刪除活動。
Contacts.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新及刪除使用者聯絡人。
User.Read (委派) 允許資料存放區讀取已登入使用者的設定檔。
檔案生產力 (Excel、Word、PowerPoint) Files.Read.All (已委派) 讀取 Excel 活頁簿 (列出、取得工作表、取得表格、取得列) 時,以及將 Word 或 PowerPoint 轉換為 PDF 時,需要這項權限。讀取使用者可存取的所有檔案,包括使用者可存取的 SharePoint 網站中儲存的檔案。
Files.ReadWrite.All (已委派) 寫入作業的必要條件:在使用者 OneDrive 中建立 Excel 工作表和表格、新增及更新 Excel 列、新增索引鍵欄,以及建立 Word 和 PowerPoint 文件。
User.Read (委派) 必須解析登入使用者的 OneDrive 位置,才能執行檔案作業。
工作 (Outlook 待辦事項清單和工作) Tasks.Read (已委派) 必須具備這項權限,才能對登入使用者的 Outlook 工作清單和工作執行讀取作業 (列出工作清單、列出工作、取得工作)。
Tasks.ReadWrite (已委派) 寫入作業需要此權限:在登入使用者的 Outlook 工作清單中建立、更新及刪除工作。
使用者和目錄 (委派列舉) User.ReadBasic.All (已委派) 適用於列舉或查詢機構中其他使用者設定檔的工具 (Get User、List Users,以及對其他使用者的信箱或日曆執行的工具)。

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

資料擷取作業的頻率限制

要求數量上限為每 10 分鐘 10,000 項 API 要求。如果您選擇使用擷取做為連線模式,這些速率限制只會套用至 Microsoft Outlook 資料儲存庫。

限制

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

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

  • Microsoft Outlook 資料儲存庫每個節點每秒可處理一筆交易,超過此限制的交易會遭到節流。

  • Microsoft Outlook 資料儲存庫能否在超出速率限制錯誤時重試,取決於是否從 Microsoft Graph API 收到 retry-after 值,而這項值只會提供給 Outlook 資料儲存庫。預設重試次數為三次。

  • Microsoft Graph 會限制 API 呼叫,因此 Microsoft Outlook 資料存放區的處理量會受到限制。限制適用於每個應用程式 ID 和信箱組合,也就是存取特定使用者或群組信箱的特定應用程式。如果某個信箱超出限制,應用程式仍可存取其他信箱。

後續步驟