อ้างอิง OneDrive (ตัวอย่าง)

หมายเหตุ

บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน

สำคัญ

คุณลักษณะนี้เป็นคุณลักษณะพรีวิว

  • Microsoft เผยแพร่ฟีเจอร์ตัวอย่างก่อนการเปิดตัวอย่างเป็นทางการเพื่อให้ลูกค้าสามารถเข้าถึงและให้ข้อเสนอแนะได้ก่อน
  • ฟีเจอร์ตัวอย่างมีฟังก์ชันการทํางานที่จํากัดและไม่เหมาะสําหรับการใช้งานด้านการผลิต
  • Microsoft อาจเปลี่ยนชื่อและพารามิเตอร์ของเครื่องมือ MCP รุ่นตัวอย่าง หลีกเลี่ยงการพึ่งพาแบบฮาร์ดโค้ด Microsoft ยังคงรองรับสถานการณ์การใช้งาน
  • ฟีเจอร์ตัวอย่างจะขึ้นอยู่กับMicrosoft ข้อกําหนดการใช้เพิ่มเติม

หมายเหตุ

เครื่องมือ MCP Microsoft 365 เฉพาะสําหรับแอปพลิเคชัน (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User และ Word) มีไว้เพื่อความเข้ากันได้ย้อนหลังเท่านั้น และไม่ควรใช้ในสภาพแวดล้อมการผลิตหรือโครงการใหม่ สําหรับโครงการใหม่ที่ต้องการเข้าถึงทรัพยากร Microsoft 365 ให้ใช้ Work IQ MCP ร่วมกับฮาร์เนส Microsoft Copilot สําหรับข้อมูลเพิ่มเติม ดูที่ 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: รหัสของไฟล์ (DriveItem) ที่ต้องการอ่านหรือดาวน์โหลด

createSmallTextFileInMyOnedrive

สร้างหรืออัปโหลดไฟล์ข้อความที่มีขนาดเล็กกว่า 5 เมกะไบต์ไปยัง OneDrive ของผู้ใช้

พารามิเตอร์ที่จําเป็น:

  • ชื่อไฟล์: ชื่อไฟล์ที่ต้องการสร้าง
  • contentText: เนื้อหาข้อความของไฟล์

พารามิเตอร์ตัวเลือก:

  • parentFolderId: ID ของโฟลเดอร์แม่ (ค่าเริ่มต้น: 'root').

createFolderInMyOnedrive

สร้างโฟลเดอร์ใหม่ (DriveItem) ใน OneDrive ของผู้ใช้เป็นรายการย่อยของโฟลเดอร์หลักที่ระบุ ถ้ามีโฟลเดอร์ที่มีชื่อเดียวกันอยู่แล้ว วิธีการ จะเพิ่มคําต่อท้ายตัวเลข (ตัวอย่างเช่น NewFolder (1))

พารามิเตอร์ที่จําเป็น:

  • folderName: ชื่อโฟลเดอร์ที่จะสร้าง

พารามิเตอร์ตัวเลือก:

  • parentFolderId: ID ของโฟลเดอร์แม่ (ค่าเริ่มต้น: 'root')

เปลี่ยนชื่อ FileOrFolderInMyOnedrive

เปลี่ยนชื่อไฟล์หรือโฟลเดอร์ (DriveItem) ใน OneDrive ของผู้ใช้ ชื่อใหม่จะต้องสอดคล้องกับมาตรฐานการตั้งชื่อ

พารามิเตอร์ที่จําเป็น:

  • fileOrFolderId: รหัสของไฟล์หรือโฟลเดอร์ที่ต้องการเปลี่ยนชื่อ
  • newFileOrFolderName: ชื่อใหม่สําหรับไฟล์หรือโฟลเดอร์

พารามิเตอร์ตัวเลือก:

  • etag: ค่า ETag สำหรับการควบคุมความพร้อมกัน การดําเนินการสําเร็จเฉพาะเมื่อ ETag ปัจจุบันของ DriveItem ตรงกัน

deleteFileOrFolderInMyOnedrive

ลบไฟล์หรือโฟลเดอร์ (DriveItem) จาก OneDrive ของผู้ใช้

พารามิเตอร์ที่จําเป็น:

  • fileOrFolderId: รหัสของไฟล์หรือโฟลเดอร์ที่ต้องการลบ

พารามิเตอร์ตัวเลือก:

  • etag: ค่า ETag สําหรับการควบคุมความพร้อมกัน

แชร์ไฟล์หรือโฟลเดอร์ใน OneDrive ของฉัน

ส่งคําเชิญการแชร์เพื่อให้สิทธิ์ในการอ่านหรือการเขียนบนไฟล์หรือโฟลเดอร์ (DriveItem) ใน OneDrive ของผู้ใช้

พารามิเตอร์ที่จําเป็น:

  • fileOrFolderId: รหัสของไฟล์หรือโฟลเดอร์ที่ต้องการแชร์
  • อีเมลผู้รับ: อาร์เรจของที่อยู่อีเมลของผู้รับที่ต้องการเชิญ
  • บทบาท: อาร์เรจของบทบาทที่จะมอบหมาย ค่าที่ยอมรับ: 'อ่าน', 'เขียน' (เขียนอนุญาตให้ทั้งอ่านและเขียน)

พารามิเตอร์ตัวเลือก:

  • ข้อความ: ข้อความที่กําหนดเองสําหรับใส่ในอีเมลเชิญ ค่าเริ่มต้น: 'นี่คือไฟล์ที่เรากําลังทํางานร่วมกัน'
  • ส่งคําเชิญ: ว่าจะส่งคําเชิญแชร์หรือไม่ ค่าเริ่มต้น: จริง

ตั้งค่าป้ายชื่อระดับความลับบนไฟล์ใน OneDrive ของฉัน

ตั้งค่าป้ายชื่อระดับความลับของไฟล์ใน OneDrive ของผู้ใช้

พารามิเตอร์ที่จําเป็น:

  • fileId: รหัสของไฟล์ (DriveItem)
  • sensitivityLabelId: ID ของป้ายกำกับความไวที่ต้องการกำหนด หรือสตริงว่างเพื่อนำออก

พารามิเตอร์ตัวเลือก:

  • วิธีการมอบหมาย: วิธีการกําหนด: 'standard', 'privileged', 'auto' หรือ 'unknownFutureValue' (ค่าเริ่มต้น: 'privileged')
  • ข้อความเหตุผล: ข้อความเหตุผลเพื่อวัตถุประสงค์ในการตรวจสอบ; จำเป็นเมื่อดาวน์เกรดหรือลบป้ายกำกับ (ค่าเริ่มต้น: 'Changed by MCPServer')

สร้างไฟล์ไบนารีขนาดเล็กใน OneDrive ของฉัน

สร้างไฟล์ไบนารีที่มีขนาดน้อยกว่า 5 MB โดยการเข้ารหัสเนื้อหาไปยัง OneDrive ของผู้ใช้

พารามิเตอร์ที่จําเป็น:

  • ชื่อไฟล์: ชื่อไฟล์ที่จะสร้างพร้อมนามสกุลไฟล์
  • base64Content: เนื้อหาไฟล์ไบนารีที่เข้ารหัสเป็นสตริง base64

พารามิเตอร์ตัวเลือก:

  • parentFolderId: ID ของโฟลเดอร์แม่ (ค่าเริ่มต้น: 'root')

อ่านไฟล์ไบนารีขนาดเล็กจาก OneDrive ของฉัน

อ่านแฟ้มไบนารีที่เล็กกว่า 5 MB จาก OneDrive ของผู้ใช้ แสดงเนื้อหาไฟล์เป็นสตริงที่เข้ารหัส base64

พารามิเตอร์ที่จําเป็น:

  • fileId: รหัสของไฟล์ (DriveItem) ที่ต้องการอ่านหรือดาวน์โหลด

คัดลอกไฟล์หรือโฟลเดอร์ใน OneDrive ของฉัน

คัดลอกไฟล์หรือโฟลเดอร์ (DriveItem) ไปยังโฟลเดอร์ปลายทางภายใน OneDrive ของผู้ใช้ การดําเนินการนี้เป็นแบบอะซิงโครนัส ใช้ checkOperationStatusInMyOnedrive เพื่อตรวจสอบความคืบหน้า

พารามิเตอร์ที่จําเป็น:

  • sourcefileid: รหัสของไฟล์หรือโฟลเดอร์ต้นทาง (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 รายการตามค่าเริ่มต้น