Note
本文描述由 標準線束驅動的代理或代理流程中使用的功能。
Important
這是預覽功能。
- Microsoft 會在正式發行前釋出預覽功能,讓客戶能搶先體驗並提供回饋。
- 預覽功能功能有限,且不適合生產環境使用。
- Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
- 預覽功能須遵守Microsoft補充使用條款。
概觀
| 伺服器識別碼 | 租戶層級 URL | 顯示名稱 | 說明 |
|---|---|---|---|
mcp_WordServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_WordServer |
Word (文書處理程式) | 處理 Microsoft Word 文件的工具 |
可用工具
WordCreateNewDocument
在使用者 OneDrive 根目錄建立新的 Word 文件。 提供所需的檔案名稱(可為空)以及 HTML 或純文字內容以填充文件主體。 若 fileName 為空,則產生類似 Document_yyyyMMdd_HHmms.docx 名稱。 回傳從 Microsoft Graph 建立的 DriveItem JSON。
必要參數:
- 檔案名稱: 想要的檔名(自動產生名稱可為空)
- 內容在HTML中: 文件正文的 HTML 或純文字內容
WordGetDocumentContent
根據其 SharePoint 共用 URL,從 OneDrive 或 SharePoint 擷取原始 Word 文件(DOCX)內容。 回傳一個 JSON 承載資料,其中包含檔名、大小、driveId、documentId、純文字內容,以及該文件中的所有註解。 輸入必須是分享連結(SharePoint 或 OneDrive URL)。
必要參數:
- 網址: SharePoint 或 OneDrive 分享文件的 URL
Word建立新註解
在 Word 文件中新增註解。 請提供 driveId、 documentId,以及評論文字。
必要參數:
- driveId: 文件的磁碟ID
- documentId: 文件識別碼
- 新評論: 新增評論文字
文字回覆留言
回覆 Word 文件中的留言。 提供 commentId、 driveId、 documentId,以及回覆文字。
必要參數:
- commentId: 回覆留言的識別碼
- driveId: 文件的磁碟ID
- documentId: 文件識別碼
- 新評論: 回覆文字
主要特徵
文件建立
- 直接在 OneDrive 建立 Word 文件。
- 支援 HTML 與純文字內容。
- 自動產生的檔案名稱為
timestamp。 - 回傳 Microsoft Graph
DriveItem元資料。
文件檢索
- 透過使用 SharePoint 或 OneDrive URL 擷取文件內容。
- 從 DOCX 檔案中擷取純文字內容。
- 檢索所有文件註解。
- 取得文件元資料,例如檔名、大小和 ID。
留言管理
- 在文件中新增註解。
- 回覆現有留言。
- 支援完整的留言串。
Notes
- 在使用者 OneDrive 的根目錄建立文件。
- 透過使用 SharePoint 或 OneDrive 共享網址來取得文件。
- 使用從文件擷取取得的 driveId 和
documentId執行註解作業。 - 支援 HTML 內容以實現豐富的文件格式化。
- 使用遵循以下格式的自動產生檔案名稱:
Document_yyyyMMdd_HHmms.docx。