Referensi OneDrive Work IQ (pratinjau)

Penting

Ini adalah fitur pratinjau.

• Microsoft merilis ditur pratinjau sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.
• Fitur pratinjau memiliki fungsionalitas yang dibatasi dan tidak dibuat untuk penggunaan produksi.
• Microsoft mungkin mengubah nama dan parameter alat MCP pratinjau. Hindari dependensi yang dikodekan secara permanen. Microsoft mempertahankan dukungan skenario.
• Fitur pratinjau bergantung pada Persyaratan penggunaan tambahan Microsoft.

Ikhtisar

ID Server	URL tingkat Penyewa	Nama tampilan	Deskripsi
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	Work IQ OneDrive	Server MCP untuk operasi OneDrive. Gunakan server ini untuk mengelola file dan folder di OneDrive pribadi pengguna. Semua operasi file dibatasi hingga ≤5MB.

Alat yang tersedia

getOnedrive

Mengambil informasi tentang OneDrive pengguna, termasuk metadata drive, kuota, dan informasi pemilik.

Parameter tidak diperlukan.

getFolderChildrenInMyOnedrive

Menampilkan hingga 20 file dan folder (DriveItems) yang terdapat dalam folder induk tertentu di OneDrive pengguna.

Parameter opsional:

• parentFolderId: ID folder induk yang file dan foldernya ingin Anda cantumkan (default: 'root')

findFileOrFolderInMyOnedrive

Menemukan file atau folder (DriveItem) di OneDrive pengguna berdasarkan kueri pencarian. Metode ini lebih efisien daripada mencari semua file yang dapat diakses jika Anda mengetahui item tersebut ada di OneDrive pengguna.

Parameter wajib:

• Kueri pencarian: dapat berupa nama file seluruhnya atau sebagian

getFileOrFolderMetadataInMyOnedrive

Mendapatkan metadata file atau folder (DriveItem) dari OneDrive pengguna.

Parameter wajib:

• fileOrFolderId: ID file atau folder di OneDrive pengguna

getFileOrFolderMetadataByUrl

Mendapatkan metadata file atau folder (DriveItem) dari URL berbagi. Hanya pengguna yang sudah memiliki izin eksplisit untuk mengakses file yang dapat memperoleh metadata.

Parameter wajib:

• fileOrFolderUrl: URL file atau folder. URL tidak ditukarkan untuk membagikannya dengan pengguna; mereka harus sudah memiliki akses eksplisit.

readSmallTextFileFromMyOnedrive

Membaca (mengunduh) file teks dari OneDrive pengguna.

Parameter wajib:

• fileId: ID file (DriveItem) untuk dibaca atau diunduh

createSmallTextFileInMyOnedrive

Membuat atau mengunggah file teks yang lebih kecil dari 5 MB ke OneDrive pengguna.

Parameter wajib:

• filename: Nama file yang akan dibuat
• contentText: Isi teks dari file

Parameter opsional:

• parentFolderId: ID folder induk (default: 'root')

createFolderInMyOnedrive

Membuat folder baru (DriveItem) di OneDrive pengguna sebagai folder turunan dari folder induk yang ditentukan. Jika folder dengan nama yang sama sudah ada, metode ini akan menambahkan akhiran numerik (misalnya, NewFolder (1)).

Parameter wajib:

• folderName: Nama folder yang akan dibuat

Parameter opsional:

• parentFolderId: ID folder induk (default: 'root')

renameFileOrFolderInMyOnedrive

Mengganti nama file atau folder (DriveItem) di OneDrive pengguna. Nama baru harus sesuai dengan konvensi penamaan.

Parameter wajib:

• fileOrFolderId: ID file atau folder yang akan diubah namanya
• newFileOrFolderName: Nama baru untuk file atau folder

Parameter opsional:

• etag: Nilai ETag untuk kontrol konkurensi. Operasi berhasil hanya jika ETag DriveItem saat ini sama

deleteFileOrFolderInMyOnedrive

Menghapus file atau folder (DriveItem) dari OneDrive pengguna.

Parameter wajib:

• fileOrFolderId: ID file atau folder yang akan dihapus

Parameter opsional:

• etag: Nilai ETag untuk kontrol konkurensi

shareFileOrFolderInMyOnedrive

Mengirim undangan berbagi untuk memberikan izin baca atau tulis pada file atau folder (DriveItem) di OneDrive pengguna.

Parameter wajib:

• fileOrFolderId: ID file atau folder yang akan dibagikan
• recipientEmails: Array berisi alamat email penerima yang akan diundang
• roles: Array peran yang akan ditetapkan. Nilai yang diterima: 'baca', 'tulis' (tulis memberikan izin baca dan tulis)

Parameter opsional:

• message: Pesan khusus untuk disertakan dalam email undangan. Default: 'Berikut file yang sedang kita kerjakan bersama.'
• sendInvitation: Apakah akan mengirim undangan untuk berbagi: Default: true.

setSensitivityLabelOnFileInMyOnedrive

Mengatur label sensitivitas file di OneDrive pengguna.

Parameter wajib:

• fileId: ID file (DriveItem)
• sensitivityLabelId: ID label sensitivitas yang akan ditetapkan, atau string kosong untuk dihapus

Parameter opsional:

• assignmentMethod: Metode penugasan: 'standard', 'privileged', 'auto', atau 'unknownFutureValue' (default: 'privileged')
• Teks pembenaran: Teks pembenaran untuk tujuan audit; diperlukan saat menurunkan atau menghapus label (default: 'Diubah oleh MCPServer')

createSmallBinaryFileInMyOnedrive

Membuat file biner berukuran kurang dari 5 MB dengan mengodekan base64 kontennya ke OneDrive pengguna.

Parameter wajib:

• filename: Nama file yang akan dibuat termasuk ekstensi file
• base64Content: Konten file biner yang dikodekan sebagai string Base64

Parameter opsional:

• parentFolderId: ID folder induk (default: 'root')

readSmallBinaryFileFromMyOnedrive

Membaca file biner berukuran kurang dari 5 MB dari OneDrive pengguna. Mengembalikan konten file sebagai string yang dikodekan Base64.

Parameter wajib:

• fileId: ID file (DriveItem) untuk dibaca atau diunduh

copyFileOrFolderInMyOnedrive

Menyalin file atau folder (DriveItem) ke folder tujuan di OneDrive milik pengguna. Operasi ini asinkron. Gunakan checkOperationStatusInMyOnedrive untuk memantau progres.

Parameter wajib:

• sourcefileid: ID file atau folder sumber (DriveItem) yang akan disalin
• destfolderid: ID folder tujuan (harus ada di OneDrive pengguna)

Parameter opsional:

• newfilename: Nama baru untuk item yang disalin (secara default menggunakan nama aslinya)

moveFileOrFolderInMyOnedrive

Memindahkan file atau folder (DriveItem) ke folder tujuan di dalam OneDrive milik pengguna. Operasi ini asinkron. Gunakan checkOperationStatusInMyOnedrive untuk memantau progres.

Parameter wajib:

• sourcefileid: ID file atau folder asal (DriveItem) yang akan dipindahkan
• destfolderid: ID folder tujuan (harus ada di OneDrive pengguna)

Parameter opsional:

• newfilename: Nama baru untuk item yang dipindahkan (secara default menggunakan nama aslinya)

checkOperationStatusInMyOnedrive

Memeriksa status operasi asinkron, seperti menyalin atau memindahkan, dengan menggunakan token operasi yang diperoleh dari operasi awal. Mengembalikan informasi kemajuan jika masih berlangsung, rincian kesalahan jika gagal, atau metadata file atau folder jika berhasil diselesaikan.

Parameter wajib:

• operationToken: Token operasi yang dikembalikan dari operasi asinkron seperti copyFileOrFolderInMyOnedrive atau moveFileOrFolderInMyOnedrive

Fitur utama

Manajemen OneDrive

• Mendapatkan informasi OneDrive, seperti kuota dan pemilik
• Mengakses OneDrive pribadi pengguna
• Semua operasi hanya berlaku pada OneDrive pengguna terautentikasi

Pencarian dan penemuan file

• Cari file dan folder berdasarkan nama di OneDrive pengguna
• Dapatkan metadata file atau folder melalui ID atau URL berbagi
• Menelusuri konten folder (hingga 20 item)

Operasi file

• Membuat file teks dan biner (≤5 MB)
• Membaca file teks dan biner (≤5 MB)
• Menghapus file dengan kontrol konkurensi
• Ganti nama file dengan perlindungan eTag
• Salin dan pindahkan file dan folder secara asinkron

Manajemen folder

• Membuat folder dengan jalur induk opsional
• Akhiran numerik otomatis untuk nama folder duplikat
• Daftar konten folder (hingga 20 item)
• Mendapatkan metadata folder
• Menghapus folder dengan kontrol konkurensi
• Ganti nama folder dengan perlindungan eTag

Berbagi dan izin

• Berbagi file dan folder dengan pengguna
• Kontrol akses berbasis peran (baca, tulis)
• Notifikasi email untuk berbagi
• Pesan kustom dalam undangan

Keamanan dan kepatuhan

• Terapkan dan hapus label sensitivitas.
• Gunakan beberapa metode penetapan, termasuk standar, hak istimewa, dan otomatis.
• Mendukung justifikasi audit.
• Gunakan pengendalian konkurensi dengan eTags.

Catatan

• Semua operasi menargetkan OneDrive pribadi pengguna yang diautentikasi.
• Operasi file terbatas pada file yang berukuran 5 MB atau kurang untuk diunggah dan diunduh.
• Operasi hapus dan ganti nama mendukung eTags untuk pengendalian konkurensi.
• Berbagi memerlukan alamat email yang valid dan izin yang sesuai.
• Label sensitivitas memerlukan lisensi dan konfigurasi yang tepat.
• Penelusuran folder secara default mengembalikan maksimum 20 item.