透過 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.ReadMail.Read.Shared |
(已委派) 允許資料存放區讀取已登入使用者的信箱、共用信箱中的電子郵件、日曆活動和聯絡人。 |
| 資料擷取 | 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 資料儲存庫僅支援
global、us和eu位置。
Microsoft Outlook 資料儲存庫每個節點每秒可處理一筆交易,超過此限制的交易會遭到節流。
Microsoft Outlook 資料儲存庫能否在超出速率限制錯誤時重試,取決於是否從 Microsoft Graph API 收到 retry-after 值,而這項值只會提供給 Outlook 資料儲存庫。預設重試次數為三次。
Microsoft Graph 會限制 API 呼叫,因此 Microsoft Outlook 資料存放區的處理量會受到限制。限制適用於每個應用程式 ID 和信箱組合,也就是存取特定使用者或群組信箱的特定應用程式。如果某個信箱超出限制,應用程式仍可存取其他信箱。
後續步驟
- 如要使用 Microsoft Outlook 建立及設定資料儲存庫,請參閱「設定 Microsoft Outlook 資料儲存庫」。