Referensi Word (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_WordServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/
servers/mcp_WordServer
Microsoft Word Alat untuk bekerja dengan dokumen Microsoft Word

Alat yang tersedia

Word Buat Dokumen Baru

Membuat dokumen Word baru di akar OneDrive pengguna. Berikan nama file yang diinginkan (dapat kosong) dan HTML atau konten teks biasa untuk mengisi isi dokumen. Jika fileName kosong, nama seperti Document_yyyyMMdd_HHmms.docx akan dibuat. Mengembalikan JSON DriveItem yang dibuat dari Microsoft Graph.

Parameter yang diperlukan:

  • Filename: Nama file yang diinginkan (dapat kosong untuk nama yang dibuat secara otomatis)
  • contentInHtml: HTML atau konten teks biasa untuk isi dokumen

WordGetDocumentContent

Mengambil konten mentah dokumen Word (DOCX) dari OneDrive atau SharePoint berdasarkan URL berbagi SharePoint yang diberikan. Mengembalikan payload JSON dengan nama file, ukuran, driveId, documentId, konten teks biasa, dan semua komentar dalam dokumen tersebut. Input harus berupa tautan berbagi (SHAREPoint atau URL OneDrive).

Parameter yang diperlukan:

  • url: URL berbagi SharePoint atau OneDrive dari dokumen

WordCreateNewComment

Menambahkan komentar baru di dokumen Word. Berikan driveId, documentId, dan teks komentar.

Parameter yang diperlukan:

  • driveId: ID Drive dokumen
  • documentId: ID Dokumen
  • newComment: Teks komentar untuk ditambahkan

WordBalasKomentar

Membalas komentar dalam dokumen Word. Berikan commentId, driveId, documentId, dan teks balasan.

Parameter yang diperlukan:

  • commentId: ID komentar yang akan di balas
  • driveId: ID Drive dokumen
  • documentId: ID Dokumen
  • newComment: Teks balasan

Fitur Utama

Pembuatan dokumen

  • Buat dokumen Word langsung di OneDrive.
  • Dukungan untuk HTML dan konten teks biasa.
  • Nama file yang dibuat secara otomatis dengan timestamp.
  • Mengembalikan metadata Microsoft Graph DriveItem.

Pengambilan dokumen

  • Ambil konten dokumen dengan menggunakan URL SharePoint atau OneDrive.
  • Ekstrak konten teks biasa dari file DOCX.
  • Ambil semua komentar dokumen.
  • Dapatkan metadata dokumen, seperti nama file, ukuran, dan ID.

Manajemen komentar

  • Tambahkan komentar baru ke dokumen.
  • Balas komentar yang sudah ada.
  • Dukungan utas komentar penuh.

Notes

  • Buat dokumen di akar OneDrive pengguna.
  • Ambil dokumen dengan menggunakan URL berbagi SharePoint atau OneDrive.
  • Jalankan operasi komentar menggunakan driveId dan documentId dari proses pengambilan dokumen.
  • Mendukung konten HTML untuk pemformatan dokumen kaya.
  • Gunakan nama file yang dibuat secara otomatis yang mengikuti format ini: Document_yyyyMMdd_HHmms.docx.