Untuk mengedit properti dokumen secara massal, berikan agen AI standar dan folder, dan biarkan ia membaca, menulis, serta memverifikasi melalui GroupDocs.Metadata.Mcp yang berjalan secara lokal. Satu prompt sudah cukup untuk memulai:

Untuk setiap dokumen di folder saya, setel Company menjadi “Acme Ltd” dan Author menjadi “Research Team”, kemudian beri tahu saya file mana yang Anda ubah.

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara memperbaiki properti dokumen secara massal dengan agen AI.

Mengapa standar metadata menyimpang pada awalnya?

Template meninggalkan perusahaan sebelumnya di setiap file baru. Penggantian nama tim meninggalkan nama lama di bidang author. Migrasi meninggalkan timestamp yang tidak masuk akal. Tidak ada yang mengedit properti secara manual pada 200 file, sehingga penyimpangan tetap ada. Agen dengan loop adalah alat yang tepat untuk itu, tetapi hanya jika penyuntingan dilakukan oleh mesin: model bahasa yang “menulis ulang” dokumen untuk mengubah penulisnya menghasilkan kembali konten, sementara write_metadata mengubah satu bidang dan membiarkan isi tetap.

Apa alur kerja?

Alur kerja memiliki empat langkah, dan masing‑masing memiliki satu prompt. Jalankan di Claude Desktop, Claude Code, Cursor, GitHub Copilot, atau klien lain yang memiliki server terdaftar.

  1. Periksa lisensi. Tanyakan: “Apa status lisensi server metadata?” Agen memanggil get_license_status. Lakukan ini sebelum menjalankan bulk, bukan setelahnya.
  2. Baca nilai saat ini. Tanyakan: “Pertama, daftar Author dan Company saat ini untuk setiap file.” Agen memanggil search_metadata dengan nameContains, yang mengembalikan hanya properti yang cocok.
  3. Tulis hanya yang salah. Tanyakan: “Ubah hanya yang salah.” Agen memanggil write_metadata untuk setiap file dan setiap properti.
  4. Verifikasi. Tanyakan: “Baca kembali Author dan Company pada file baru dan daftarkan yang masih berbeda, beserta alasannya.” Minta kegagalan sebagai daftar, bukan hitungan.

Siapa yang memutuskan apa: agen atau mesin?

Keputusan Dibuat oleh
File mana yang termasuk dalam cakupan, dan nilai mana yang salah Agen, dari standar Anda
Nama properti mana yang dipetakan ke bidang mana dalam PDF, DOCX, atau JPEG Mesin: write_metadata memetakan nama ramah per format
Apakah properti ada dalam format Mesin: penulisan yang tidak berlaku melaporkan 0 perubahan atau gagal dengan pesan, tidak pernah sukses diam‑diam
Apa yang disimpan dan di mana Alat: mengembalikan pesan jalur tersimpan dan jumlah bidang yang diubah
Apakah keadaan akhir sesuai dengan standar Agen, dengan membaca kembali

write_metadata menerima property sebagai salah satu Author, Title, Subject, Keywords, Comments, Copyright, Company, atau Manager. mode adalah set (ganti, default) atau add (tambahkan, untuk bidang daftar seperti Keywords).

Apa aturan yang menjaga setiap penyuntingan?

write_metadata mengatur satu properti per panggilan dan menyimpan file baru. Dua properti pada satu dokumen berarti dua panggilan, dan panggilan kedua harus diterapkan pada hasil panggilan pertama. Jika panggilan kedua dimulai dari file asli, penyuntingan pertama menghilang. Ketika agen melaporkan bahwa kedua properti telah diatur tetapi hanya satu yang bertahan, inilah alasannya. Nyatakan aturan tersebut dalam prompt:

Terapkan perubahan kedua pada file yang dihasilkan oleh perubahan pertama, bukan pada file asli.

Contoh sesi (disingkat)

Anda:    Setel Company menjadi "Acme Ltd" pada setiap .docx di folder. Daftar nilai saat ini terlebih dahulu.
Agen:  [calls search_metadata: nameContains = "Company", per file]
Agen:  proposal-q1.docx   Company = "Contoso GmbH"   -> akan diubah
        handbook.docx      Company = "Acme Ltd"       -> sudah benar
        notes.docx         (no Company property)      -> akan ditambahkan
Anda:    Lanjutkan. Nama setiap file yang Anda hasilkan.
Agen:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agen:  2 file diubah, 1 tidak diubah. Setiap salinan yang disimpan dinamai dalam balasan alat.

Ini adalah ilustrasi alur, bukan tangkapan layar.

Mengapa tidak memperbaiki seluruh folder dalam satu kali proses?

Penulisan massal buta dapat menggantikan nilai yang baik dengan nilai yang lebih buruk, sehingga langkah baca adalah percobaan kering. Ini memerlukan satu panggilan ekstra per file. Di bawah lisensi bermeter, setiap panggilan dikenakan biaya penggunaan, dan penyapuan dua properti pada 200 file berarti 400 panggilan tulis ditambah baca, jadi filter dulu dan tulis kemudian.

Format berbeda. Properti yang tidak memiliki tempat dalam format dilaporkan sebagai 0 perubahan atau gagal dengan pesan alih‑alih berpura‑pura berhasil, yang merupakan perilaku yang tepat tetapi berarti folder campuran dapat memberikan hasil parsial. Minta kegagalan sebagai daftar.

Apa batasan dalam mode evaluasi?

Dalam mode evaluasi hanya 5 properti dokumen pertama yang dapat dibaca, dan XMP serta EXIF sebagian tidak tersedia. Penulisan dibatasi dengan cara yang sama. Alur kerja “periksa, lalu tulis” dalam evaluasi memeriksa daftar yang dipotong, sehingga dapat melewatkan properti yang ingin Anda perbaiki. Konfirmasikan dengan get_license_status dan terapkan file lisensi atau kunci bermeter sebelum mengandalkan hasilnya. Lisensi sementara gratis selama 30 hari tersedia.

Pertanyaan yang sering diajukan

Apakah saya dapat mengubah author pada 100 dokumen Word sekaligus?
Ya, dengan prompt yang menyebutkan folder dan nilai. Agen membuat satu panggilan write_metadata per file untuk properti Author, jadi 100 file berarti 100 panggilan tulis.

Apakah agen menimpa file asli saya?
Alat menyimpan file baru dan mengembalikan jalurnya, sehingga file asli bukan outputnya. Minta agen untuk menamai setiap file yang dihasilkannya, dan simpan file asli sampai Anda memverifikasi salinannya.

Dapatkah agen mengatur properti khusus yang tidak ada dalam daftar?
Nilai property yang didokumentasikan adalah Author, Title, Subject, Keywords, Comments, Copyright, Company, dan Manager. Apa pun yang lain berada di luar apa yang dijelaskan alat.

Selami lebih dalam