Note
本文中的功能由 標準線束驅動，該線束使用標準線束所描述的授權服務 人員帳單選項。 學習如何在 Access 標準代理與代理流程中存取標準功能。
Important
這是預覽功能。
- Microsoft 會在正式發行前釋出預覽功能，讓客戶能搶先體驗並提供回饋。
- 預覽功能功能有限，且不適合生產環境使用。
- Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
- 預覽功能須遵守Microsoft補充使用條款。
Overview
| 伺服器識別碼 | 租戶層級 URL | 顯示名稱 | Description |
|---|---|---|---|
mcp_OneDriveRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_OneDriveRemoteServer |
OneDrive | OneDrive 操作工具。 使用這台伺服器來管理使用者個人 OneDrive 中的檔案和資料夾。 所有檔案操作限制在 ≤5MB。 |
可用工具
getOnedrive
取得使用者 OneDrive 的資訊，包括硬碟元資料、配額及擁有者資訊。
不需要任何參數。
getFolderChildrenInMyOneDrive
列舉使用者 OneDrive 指定父資料夾內的前 20 個檔案與資料夾（DriveItems）。
選擇性參數：
- parentFolderId： 你想列出的檔案和資料夾的父資料夾 ID（預設：'root'）
在我的 OneDrive 中尋找檔案或資料夾
透過搜尋查詢，在使用者的 OneDrive 中找到檔案或資料夾（DriveItem）。 如果你知道物品在使用者的 OneDrive 裡，這種方法比搜尋所有可存取檔案更有效率。
必要參數：
- 搜尋查詢： 搜尋查詢;可以是整個或部分檔案名稱
取得我在 OneDrive 中的檔案或資料夾中繼資料
從使用者的 OneDrive 取得檔案或資料夾（DriveItem）的元資料。
必要參數：
- fileOrFolderId： 使用者OneDrive中檔案或資料夾的 ID
获取文件或資料夾的元數據透過URL
從分享網址取得檔案或資料夾（DriveItem）的元資料。 只有擁有明確存取檔案權限的使用者才能取得中繼資料。
必要參數：
- fileOrFolderUrl： 檔案或資料夾的網址。 網址不會被兌換來分享給使用者;他們必須已經有明確的存取權限。
從我的 OneDrive 讀取小型文字檔案
讀取（下載）使用者 OneDrive 的文字檔。
必要參數：
- fileID： 檔案的 ID（DriveItem）用於讀取或下載
在我的 OneDrive 中建立小型文字檔案
建立或上傳小於 5 MB 的文字檔到使用者的 OneDrive。
必要參數：
- 檔名： 要建立的檔案名稱
- 內容正文： 檔案內容。
選擇性參數：
- parentFolderId： 父資料夾的 ID（預設為「root」）。
createFolderInMyOnedrive
在使用者的 OneDrive 中建立一個新資料夾（DriveItem），作為指定的父資料夾的子資料夾。 如果已有同名資料夾存在，該方法會加上數字後綴（例如 NewFolder （1））。
必要參數：
- 資料夾名稱： 要建立資料夾名稱
選擇性參數：
- parentFolderId： 父資料夾的 ID（預設為「root」）。
重新命名我在 OneDrive 中的檔案或資料夾
在使用者的 OneDrive 中重新命名一個檔案或資料夾（DriveItem）。 新名稱必須遵守命名慣例。
必要參數：
- fileOrFolderID： 要重新命名的檔案或資料夾的 ID
- newFileOrFolderName： 檔案或資料夾的新名稱
選擇性參數：
- ETAG： ETag 用於並行控制的價值。 只有當驅動項目目前的 ETag 相符時，操作才會成功
刪除我 OneDrive 中的檔案或資料夾
從使用者的 OneDrive 刪除檔案或資料夾（DriveItem）。
必要參數：
- fileOrFolderID： 要刪除的檔案或資料夾的 ID
選擇性參數：
- ETAG： ETag 用於並發控制的值
在我的 OneDrive 中共用檔案或資料夾
發送分享邀請，授予使用者 OneDrive 中檔案或資料夾（DriveItem）的讀寫權限。
必要參數：
- fileOrFolderID： 要分享的檔案或資料夾的 ID
- 收件人電子郵件： 邀請收件人的電子郵件地址陣列
- 角色： 要指派的角色陣列。 可接受的值：`read`、`write`（`write` 同時包含 `read` 和 `write` 權限）
選擇性參數：
- 訊息： 請在邀請信中附上自訂訊息。 預設：「這是我們正在合作的檔案。」
- 發送邀請： 是否要發送分享邀請。 預設值：true。
在我的 OneDrive 中的檔案上設定敏感度標籤
在使用者的 OneDrive 中設定檔案的敏感度標籤。
必要參數：
- fileID： 檔案識別碼（DriveItem）
- sensitivityLabelId: 要指派的敏感度標籤 ID，若要移除則為空字串
選擇性參數：
- assignmentMethod： 指派方法：『標準』、『特權』、『自動』或『未知未來值』（預設為『特權』）
- 理由正文： 審計用途的說明文字;降級或移除標籤時必須（預設：「由 MCPServer 更改」）
在我的 OneDrive 中建立小型二進位檔案
透過 base64 編碼，將內容建立小於 5 MB 的二進位檔案，並儲存在使用者的 OneDrive 上。
必要參數：
- 檔名： 要建立的檔案名稱，包含副檔名
- base64內容： 二進位檔案內容以 base64 字串編碼
選擇性參數：
- parentFolderId： 父資料夾的 ID（預設為「root」）。
從我的 OneDrive 讀取小型二進位檔案
從使用者的 OneDrive 讀取小於 5 MB 的二進位檔案。 回傳檔案內容為 base64 編碼的字串。
必要參數：
- fileID： 檔案的 ID（DriveItem）用於讀取或下載
在我的 OneDrive 中複製檔案或資料夾
將檔案或資料夾（DriveItem）複製到使用者 OneDrive 中的目標資料夾。 此操作為非同步。 用 checkOperationStatusInMyOnedrive 來監測進度。
必要參數：
- 資料來源fileid： 要複製的來源檔案或資料夾（DriveItem）的 ID
- destfolderid： 目標資料夾的 ID（必須存在於使用者的OneDrive中）
選擇性參數：
- 新檔名： 複製項目的新名稱（預設為原始名稱）
在我的OneDrive中移動檔案或資料夾
將檔案或資料夾（DriveItem）移至使用者 OneDrive 中的目的地資料夾。 此操作為非同步。 用 checkOperationStatusInMyOnedrive 來監測進度。
必要參數：
- sourcefileid: 要移動的來源檔案或資料夾 (DriveItem) 的識別碼
- destfolderid： 目標資料夾的 ID（必須存在於使用者的OneDrive中）
選擇性參數：
- 新檔名： 移動物品的新名稱（預設為原名）
檢查我在 OneDrive 中的作業狀態
透過使用原始操作回傳的操作標記來檢查非同步操作（如複製或移動）的狀態。 若仍在進行中，則回傳進度資訊;失敗時回傳錯誤細節;成功完成則回傳最終檔案或資料夾中繼資料。
必要參數：
-
operationToken: 從非同步作業（例如
copyFileOrFolderInMyOnedrive或moveFileOrFolderInMyOnedrive）傳回的作業權杖
重點功能
OneDrive 管理
- 取得 OneDrive 資訊，例如配額和擁有者
- 存取使用者的個人 OneDrive
- 所有操作都以已驗證的使用者 OneDrive 為對象
檔案搜尋與發現
- 在使用者的 OneDrive 中依名稱搜尋檔案和資料夾
- 依 ID 或共用網址取得檔案或資料夾中繼資料
- 瀏覽資料夾內容（最多20個項目）。
檔案操作
- 建立文字與二進位檔案（≤5 MB）
- 閱讀文字與二進位檔案（≤5 MB）
- 刪除帶有並行控制的檔案
- 用 eTag 保護重新命名檔案
- 非同步複製與移動檔案與資料夾
資料夾管理
- 建立帶有可選父路徑的資料夾
- 重複資料夾名稱自動加上數字後綴。
- 清單資料夾內容（最多20個項目）
- 取得資料夾中繼資料
- 刪除帶有並發控制的資料夾
- 重新命名受 eTag 保護的資料夾
共用和權限
- 與使用者分享檔案與資料夾
- 基於角色的存取控制（讀寫）
- 電子郵件通知以供分享。
- 邀請函中的自訂訊息。
安全性與合規性
- 貼上和移除敏感標籤。
- 使用多種指派方法，包括標準、特權和自動。
- 支持審計的合理性。
- 使用 ETag 進行並行存取控制。
Notes
- 所有操作都針對已認證使用者的個人 OneDrive。
- 檔案操作僅限於上傳與下載時大小不超過 5 MB 的檔案。
- 刪除與重命名操作支援 eTag 以進行並行控制。
- 分享需要有效的電子郵件地址和適當的權限。
- 敏感標籤需要適當的授權與設定。
- 資料夾列表預設最多回傳 20 個項目。