Referensi untuk OneDrive (pratinjau)

Note

Artikel ini menjelaskan fitur yang digunakan oleh agen atau alur agen yang didukung oleh standard harness.

Important

Ini adalah fitur pratinjau.

• Microsoft merilis fitur pratinjau sebelum rilis resmi sehingga pelanggan bisa mendapatkan akses awal dan memberikan umpan balik.
• Fitur pratinjau memiliki fungsionalitas terbatas dan tidak dimaksudkan untuk penggunaan produksi.
• Microsoft mungkin mengubah nama dan parameter pratinjau untuk alat MCP. Hindari dependensi yang dikodekan secara permanen. Microsoft mempertahankan dukungan skenario.
• Fitur pratinjau tunduk pada ketentuan 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	OneDrive	Alat 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

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

Tidak diperlukan parameter.

getFolderChildrenInMyOnedrive

Menghitung 20 file dan folder teratas (DriveItems) yang terkandung 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 menurut kueri pencarian. Metode ini lebih efisien daripada mencari semua file yang dapat diakses jika Anda tahu item berada di OneDrive pengguna.

Parameter yang diperlukan:

• searchQuery: Kueri pencarian; dapat berupa seluruh atau sebagian nama file

Dapatkan metadata file atau folder di OneDrive saya

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

Parameter yang diperlukan:

• fileOrFolderId: ID file atau folder di OneDrive pengguna

getFileOrFolderMetadataByUrl

Mendapatkan metadata dari sebuah file atau folder (DriveItem) dari URL berbagi. Hanya pengguna dengan izin eksplisit yang ada untuk mengakses file yang bisa mendapatkan metadata.

Parameter yang diperlukan:

• fileOrFolderUrl: URL dari 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 yang diperlukan:

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

buat file teks kecil di OneDrive saya

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

Parameter yang diperlukan:

• Filename: Nama file yang akan dibuat
• kontenTeks: Isi teks dari file.

Parameter opsional:

• parentFolderId: ID dari folder induk (bawaan: 'root').

createFolderInMyOnedrive

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

Parameter yang diperlukan:

• folderName: Nama folder yang akan dibuat

Parameter opsional:

• parentFolderId: ID dari folder induk (bawaan: 'root').

ganti nama file atau folder di OneDrive saya

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

Parameter yang diperlukan:

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

Parameter opsional:

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

hapusFileAtauFolderDiOneDriveSaya

Menghapus file atau folder (DriveItem) dari OneDrive pengguna.

Parameter yang diperlukan:

• fileOrFolderId: ID file atau folder yang akan dihapus

Parameter opsional:

• etag: Nilai ETag untuk kontrol konkurensi

Bagikan file atau folder di OneDrive saya

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

Parameter yang diperlukan:

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

Parameter opsional:

• Pesan: Pesan kustom untuk disertakan dalam email undangan. Default: 'Ini berkas yang sedang kita kerjakan bersama.'
• sendInvitation: Apakah akan mengirim undangan berbagi. Bawaan: benar.

aturLabelSensitivitasPadaFileDiOneDriveSaya

Mengatur label sensitivitas file di OneDrive pengguna.

Parameter yang diperlukan:

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

Parameter opsional:

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

createSmallBinaryFileInMyOnedrive

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

Parameter yang diperlukan:

• Filename: Nama file yang akan dibuat termasuk ekstensi file
• base64Content: Konten file biner yang dikodekan sebagai string base64

Parameter opsional:

• parentFolderId: ID dari folder induk (bawaan: 'root').

membacaFileBinerKecilDariOneDriveSaya

Membaca file biner yang lebih kecil dari 5 MB dari OneDrive pengguna. Mengembalikan konten file sebagai string yang dikodekan base64.

Parameter yang diperlukan:

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

Salin file atau folder di OneDrive Saya

Menyalin file atau folder (DriveItem) ke folder tujuan dalam OneDrive pengguna. Operasi ini asinkron. Gunakan checkOperationStatusInMyOnedrive untuk memantau kemajuan.

Parameter yang diperlukan:

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

Parameter opsional:

• newfilename: Nama baru untuk item yang disalin (default ke nama asli)

Memindahkan file atau folder di OneDrive saya

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

Parameter yang diperlukan:

• sourcefileid: ID file atau folder sumber (DriveItem) untuk dipindahkan
• destfolderid: ID folder tujuan (harus ada di OneDrive pengguna)

Parameter opsional:

• newfilename: Nama baru untuk item yang dipindahkan (default ke nama asli)

periksa status operasi di OneDrive saya

Memeriksa status operasi asinkron, seperti menyalin atau memindahkan, dengan menggunakan token operasi yang dikembalikan dari operasi asli. Mengembalikan informasi kemajuan jika masih dalam proses, detail kesalahan jika gagal, atau metadata file atau folder akhir jika berhasil diselesaikan.

Parameter yang diperlukan:

• operationToken: Token operasi 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 ditujukan ke OneDrive milik pengguna yang terautentikasi

Pencarian dan penemuan file

• Mencari file dan folder berdasarkan nama dalam OneDrive pengguna
• Dapatkan metadata file atau folder menurut ID atau URL berbagi
• Telusuri isi folder (hingga 20 item).

Operasi file

• Membuat file teks dan biner (≤5 MB)
• Membaca teks dan file biner (≤5 MB)
• Menghapus file dengan kontrol konkurensi
• Mengganti nama file dengan perlindungan eTag
• Menyalin dan memindahkan file dan folder secara asinkron

Manajemen folder

• Membuat folder dengan jalur induk opsional
• Akhiran numerik otomatis untuk nama folder duplikat.
• Mencantumkan isi folder (hingga 20 item)
• Mendapatkan metadata folder
• Hapus folder dengan pengendalian konkurensi
• Mengganti nama folder dengan perlindungan eTag

Berbagi dan izin

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

Keamanan dan kepatuhan

• Terapkan dan hapus label sensitivitas.
• Gunakan beberapa metode penugasan, termasuk standar, istimewa, dan otomatis.
• Dukungan justifikasi audit.
• Gunakan kontrol konkurensi dengan eTags.

Notes

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