หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Note
บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน
Important
นี่เป็นฟีเจอร์ตัวอย่าง
- Microsoft เผยแพร่ฟีเจอร์ตัวอย่างก่อนการเปิดตัวอย่างเป็นทางการเพื่อให้ลูกค้าสามารถเข้าถึงและให้ข้อเสนอแนะได้ก่อน
- ฟีเจอร์ตัวอย่างมีฟังก์ชันการทํางานที่จํากัดและไม่เหมาะสําหรับการใช้งานด้านการผลิต
- Microsoft อาจเปลี่ยนชื่อและพารามิเตอร์ของเครื่องมือ MCP รุ่นตัวอย่าง หลีกเลี่ยงการพึ่งพาแบบฮาร์ดโค้ด Microsoft ยังคงรองรับสถานการณ์การใช้งาน
- ฟีเจอร์ตัวอย่างจะขึ้นอยู่กับMicrosoft ข้อกําหนดการใช้เพิ่มเติม
Note
เครื่องมือ MCP Microsoft 365 เฉพาะสําหรับแอปพลิเคชัน (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User และ Word) มีไว้เพื่อความเข้ากันได้ย้อนหลังเท่านั้น และไม่ควรใช้ในสภาพแวดล้อมการผลิตหรือโครงการใหม่ สําหรับโครงการใหม่ที่ต้องการเข้าถึงทรัพยากร Microsoft 365 ให้ใช้ Work IQ MCP ร่วมกับ GitHub Copilot harness สําหรับข้อมูลเพิ่มเติม ดูที่ Work IQ MCP ใน Copilot Studio
Overview
| ID ของเซิร์ฟเวอร์ | URL ระดับผู้เช่า | ชื่อที่แสดง | คำอธิบาย |
|---|---|---|---|
mcp_OneDriveRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_OneDriveRemoteServer |
OneDrive | เครื่องมือสําหรับการดําเนินงาน OneDrive ใช้เซิร์ฟเวอร์นี้สําหรับการจัดการแฟ้มและโฟลเดอร์ใน OneDrive ส่วนบุคคลของผู้ใช้ การดําเนินการไฟล์ทั้งหมดจํากัดไว้ที่ ≤5MB |
เครื่องมือที่พร้อมใช้งาน
ดาวน์โหลด OneDrive
รับข้อมูลเกี่ยวกับ OneDrive ของผู้ใช้ รวมถึงเมตาดาต้าไดรฟ์ โควตา และข้อมูลเจ้าของ
ไม่จําเป็นต้องมีพารามิเตอร์
getFolderChildrenInMyOnedrive
ระบุไฟล์และโฟลเดอร์ 20 อันดับแรก (DriveItems) ที่อยู่ภายในโฟลเดอร์หลักที่ระบุใน OneDrive ของผู้ใช้
พารามิเตอร์ตัวเลือก:
- parentFolderId: ID ของโฟลเดอร์หลักที่มีแฟ้มและโฟลเดอร์ที่คุณต้องการแสดงรายการ (ค่าเริ่มต้น: 'root')
findFileOrFolderInMyOnedrive
ค้นหาไฟล์หรือโฟลเดอร์ (DriveItem) ใน OneDrive ของผู้ใช้ตามคิวรีการค้นหา วิธีนี้มีประสิทธิภาพมากกว่าการค้นหาไฟล์ที่สามารถเข้าถึงได้ทั้งหมดหากคุณทราบว่ารายการอยู่ใน OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- searchQuery: แบบสอบถามการค้นหา; การค้นหา อาจเป็นชื่อไฟล์ทั้งหมดหรือบางส่วน
getFileOrFolderMetadataInMyOnedrive
รับเมตาดาต้าของไฟล์หรือโฟลเดอร์ (DriveItem) จาก OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- fileOrFolderId: ของไฟล์หรือโฟลเดอร์ใน OneDrive ของผู้ใช้
getFileOrFolderMetadataByUrl
รับเมตาดาต้าของไฟล์หรือโฟลเดอร์ (DriveItem) จาก URL ที่ใช้ร่วมกัน เฉพาะผู้ใช้ที่มีสิทธิ์อย่างชัดเจนในการเข้าถึงไฟล์เท่านั้นที่สามารถรับเมตาดาต้าได้
พารามิเตอร์ที่จําเป็น:
- fileOrFolderUrl: URL ของไฟล์หรือโฟลเดอร์ URL ไม่ได้ถูกแลกใช้เพื่อแชร์กับผู้ใช้ พวกเขาต้องมีการเข้าถึงอย่างชัดเจน
readSmallTextFileFromMyOnedrive
อ่าน (ดาวน์โหลด) ไฟล์ข้อความจาก OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- fileId: ID ของไฟล์ (DriveItem) เพื่ออ่านหรือดาวน์โหลด
createSmallTextFileInMyOnedrive
สร้างหรืออัปโหลดไฟล์ข้อความที่มีขนาดเล็กกว่า 5 เมกะไบต์ไปยัง OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- ชื่อไฟล์: ชื่อของไฟล์ที่จะสร้าง
- เนื้อหาข้อความ: เนื้อหาข้อความของไฟล์
พารามิเตอร์ตัวเลือก:
- parentFolderId: ID ของโฟลเดอร์หลัก (ค่าเริ่มต้น: 'root')
createFolderInMyOnedrive
สร้างโฟลเดอร์ใหม่ (DriveItem) ใน OneDrive ของผู้ใช้เป็นรายการย่อยของโฟลเดอร์หลักที่ระบุ ถ้ามีโฟลเดอร์ที่มีชื่อเดียวกันอยู่แล้ว วิธีการ จะเพิ่มคําต่อท้ายตัวเลข (ตัวอย่างเช่น NewFolder (1))
พารามิเตอร์ที่จําเป็น:
- folderName: ชื่อของโฟลเดอร์ที่จะสร้าง
พารามิเตอร์ตัวเลือก:
- parentFolderId: ID ของโฟลเดอร์หลัก (ค่าเริ่มต้น: 'root')
เปลี่ยนชื่อ FileOrFolderInMyOnedrive
เปลี่ยนชื่อไฟล์หรือโฟลเดอร์ (DriveItem) ใน OneDrive ของผู้ใช้ ชื่อใหม่จะต้องสอดคล้องกับมาตรฐานการตั้งชื่อ
พารามิเตอร์ที่จําเป็น:
- fileOrFolderId: ID ของไฟล์หรือโฟลเดอร์ที่จะเปลี่ยนชื่อ
- newFileOrFolderName: ชื่อใหม่สําหรับไฟล์หรือโฟลเดอร์
พารามิเตอร์ตัวเลือก:
- etag: ค่า ETag สำหรับการควบคุมการทำงานพร้อมกัน การดําเนินการสําเร็จเฉพาะเมื่อ ETag ปัจจุบันของ DriveItem ตรงกัน
deleteFileOrFolderInMyOnedrive
ลบไฟล์หรือโฟลเดอร์ (DriveItem) จาก OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- fileOrFolderId: ID ของไฟล์หรือโฟลเดอร์ที่จะลบ
พารามิเตอร์ตัวเลือก:
- etag: ค่า ETag สำหรับการควบคุมการทำงานพร้อมกัน
แชร์ไฟล์หรือโฟลเดอร์ใน OneDrive ของฉัน
ส่งคําเชิญการแชร์เพื่อให้สิทธิ์ในการอ่านหรือการเขียนบนไฟล์หรือโฟลเดอร์ (DriveItem) ใน OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- fileOrFolderId: ID ของไฟล์หรือโฟลเดอร์ที่จะแชร์
- recipientEmails: อาร์เรย์ของที่อยู่อีเมลของผู้รับที่จะเชิญ
- บทบาท: อาร์เรย์ของบทบาทที่จะกําหนด ค่าที่ยอมรับ: 'อ่าน', 'เขียน' (เขียนอนุญาตให้ทั้งอ่านและเขียน)
พารามิเตอร์ตัวเลือก:
- ข้อความ: ข้อความแบบกําหนดเองที่จะรวมไว้ในอีเมลการเชิญ ค่าเริ่มต้น: 'นี่คือไฟล์ที่เรากําลังทํางานร่วมกัน'
- sendInvitation: จะส่งคําเชิญการแชร์หรือไม่ ค่าเริ่มต้น: จริง
ตั้งค่าป้ายชื่อระดับความลับบนไฟล์ใน OneDrive ของฉัน
ตั้งค่าป้ายชื่อระดับความลับของไฟล์ใน OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- fileId: ID ของไฟล์ (DriveItem)
- sensitivityLabelId: รหัสของป้ายชื่อระดับความลับที่จะกำหนด หรือสตริงว่างหากต้องการลบป้ายชื่อออก
พารามิเตอร์ตัวเลือก:
- assignmentMethod: วิธีการกําหนด: 'มาตรฐาน', 'สิทธิ์', 'อัตโนมัติ' หรือ 'unknownFutureValue' (ค่าเริ่มต้น: 'พิเศษ')
- justificationText: ข้อความเหตุผลสำหรับการตรวจสอบ; จำเป็นเมื่อมีการลดระดับหรือนำป้ายกำกับออก (ค่าเริ่มต้น: 'Changed by MCPServer')
สร้างไฟล์ไบนารีขนาดเล็กใน OneDrive ของฉัน
สร้างไฟล์ไบนารีที่มีขนาดน้อยกว่า 5 MB โดยการเข้ารหัสเนื้อหาไปยัง OneDrive ของผู้ใช้
พารามิเตอร์ที่จําเป็น:
- ชื่อไฟล์: ชื่อของไฟล์ที่จะสร้างรวมทั้งนามสกุลไฟล์
- base64Content: เนื้อหาไฟล์ไบนารีที่เข้ารหัสเป็นสตริง base64
พารามิเตอร์ตัวเลือก:
- parentFolderId: ID ของโฟลเดอร์หลัก (ค่าเริ่มต้น: 'root')
อ่านไฟล์ไบนารีขนาดเล็กจาก OneDrive ของฉัน
อ่านแฟ้มไบนารีที่เล็กกว่า 5 MB จาก OneDrive ของผู้ใช้ แสดงเนื้อหาไฟล์เป็นสตริงที่เข้ารหัส base64
พารามิเตอร์ที่จําเป็น:
- fileId: ID ของไฟล์ (DriveItem) เพื่ออ่านหรือดาวน์โหลด
คัดลอกไฟล์หรือโฟลเดอร์ใน OneDrive ของฉัน
คัดลอกไฟล์หรือโฟลเดอร์ (DriveItem) ไปยังโฟลเดอร์ปลายทางภายใน OneDrive ของผู้ใช้ การดําเนินการนี้เป็นแบบอะซิงโครนัส ใช้ checkOperationStatusInMyOnedrive เพื่อตรวจสอบความคืบหน้า
พารามิเตอร์ที่จําเป็น:
- sourcefileid: ID ของไฟล์ต้นทางหรือโฟลเดอร์ (DriveItem) ที่จะคัดลอก
- destfolderid: ID ของโฟลเดอร์ปลายทาง (ต้องมีอยู่ใน OneDrive ของผู้ใช้)
พารามิเตอร์ตัวเลือก:
- newfilename: ชื่อใหม่สําหรับรายการที่คัดลอก (ค่าเริ่มต้นเป็นชื่อเดิม)
moveFileOrFolderInMyOnedrive
ย้ายไฟล์หรือโฟลเดอร์ (DriveItem) ไปยังโฟลเดอร์ปลายทางภายใน OneDrive ของผู้ใช้ การดําเนินการนี้เป็นแบบอะซิงโครนัส ใช้ checkOperationStatusInMyOnedrive เพื่อตรวจสอบความคืบหน้า
พารามิเตอร์ที่จําเป็น:
- sourcefileid: ID ของแฟ้มต้นฉบับหรือโฟลเดอร์ (DriveItem) ที่จะย้าย
- destfolderid: ID ของโฟลเดอร์ปลายทาง (ต้องมีอยู่ใน OneDrive ของผู้ใช้)
พารามิเตอร์ตัวเลือก:
- newfilename: ชื่อใหม่สําหรับรายการที่ย้าย (ค่าเริ่มต้นคือชื่อเดิม)
checkOperationStatusInMyOnedrive
ตรวจสอบสถานะของการดําเนินการแบบอะซิงโครนัส เช่น คัดลอกหรือย้าย โดยใช้โทเค็นการดําเนินการที่ส่งกลับจากการดําเนินการเดิม ส่งกลับข้อมูลความคืบหน้าหากยังอยู่ระหว่างการดําเนินการ รายละเอียดข้อผิดพลาดถ้าล้มเหลว หรือเมตาดาต้าของไฟล์หรือโฟลเดอร์สุดท้ายถ้าเสร็จสมบูรณ์แล้ว
พารามิเตอร์ที่จําเป็น:
-
operationToken: โทเค็นการดําเนินการส่งกลับจากการดําเนินการแบบอะซิงโครนัส เช่น
copyFileOrFolderInMyOnedriveหรือmoveFileOrFolderInMyOnedrive
คุณลักษณะสำคัญ
การจัดการ OneDrive
- รับข้อมูล OneDrive เช่น โควตา และเจ้าของ
- เข้าถึง OneDrive ส่วนบุคคลของผู้ใช้
- การดําเนินการทั้งหมดกําหนดเป้าหมาย OneDrive ของผู้ใช้ที่ได้รับการรับรองความถูกต้อง
การค้นหาและการค้นพบไฟล์
- ค้นหาไฟล์และโฟลเดอร์ตามชื่อภายใน OneDrive ของผู้ใช้
- รับเมตาดาต้าของไฟล์หรือโฟลเดอร์ตาม ID หรือ URL การแชร์
- เรียกดูเนื้อหาในโฟลเดอร์ (สูงสุด 20 รายการ)
การดําเนินการของไฟล์
- สร้างไฟล์ข้อความและไบนารี (≤5 MB)
- อ่านข้อความและไฟล์ไบนารี (≤5 MB)
- ลบไฟล์ด้วยการควบคุมการทำงานพร้อมกัน
- เปลี่ยนชื่อไฟล์ด้วยการป้องกัน eTag
- คัดลอกและย้ายแฟ้มและโฟลเดอร์ต่าง ๆ แบบอะซิงโครนัส
การจัดการโฟลเดอร์
- สร้างโฟลเดอร์ด้วยเส้นทางพาเรนต์ที่เลือกได้
- เติมคําลงท้ายตัวเลขอัตโนมัติสําหรับชื่อโฟลเดอร์ที่ซ้ํากัน
- แสดงเนื้อหาของโฟลเดอร์ (สูงสุด 20 รายการ)
- รับเมตาดาต้าของโฟลเดอร์
- ลบโฟลเดอร์ด้วยการควบคุมการทำงานพร้อมกัน
- เปลี่ยนชื่อโฟลเดอร์ด้วยการป้องกัน eTag
การแชร์และสิทธิ์
- แชร์ไฟล์และโฟลเดอร์กับผู้ใช้
- การควบคุมการเข้าถึงตามบทบาท (อ่าน เขียน)
- อีเมลแจ้งเตือนเพื่อแชร์
- ข้อความที่กําหนดเองในคําเชิญ
การรักษาความปลอดภัยและการปฏิบัติตามกฎระเบียบ
- ใช้และเอาป้ายชื่อที่มีความสำคัญออก
- ใช้วิธีการกําหนดหลายวิธี รวมถึงมาตรฐาน มีสิทธิพิเศษ และอัตโนมัติ
- เหตุผลประกอบการตรวจสอบ
- ใช้การควบคุมการทำงานพร้อมกันด้วย eTags
หมายเหตุ
- การดำเนินการทั้งหมดมุ่งไปที่ OneDrive ส่วนบุคคลของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว
- การดําเนินการของไฟล์ถูกจํากัดไว้ที่ไฟล์ที่มีขนาด 5 เมกะไบต์หรือน้อยกว่าสําหรับการอัปโหลดและดาวน์โหลด
- การดำเนินการลบและการเปลี่ยนชื่อรองรับ eTags สำหรับการควบคุมการทำงานพร้อมกัน
- การแชร์จําเป็นต้องมีที่อยู่อีเมลที่ถูกต้องและสิทธิ์ที่เหมาะสม
- ป้ายชื่อระดับความลับจําเป็นต้องมีสิทธิ์การใช้งานและการกําหนดค่าที่เหมาะสม
- รายการโฟลเดอร์ส่งกลับสูงสุด 20 รายการตามค่าเริ่มต้น