Для масового редагування властивостей документів надайте AI‑агенту стандарт і папку, і дозвольте йому читати, записувати та перевіряти через GroupDocs.Metadata.Mcp, що працює локально. Достатньо одного запиту, щоб розпочати:

Для кожного документа у моїй папці встановити Company на “Acme Ltd” і Author на “Research Team”, а потім повідомити мені, які файли були змінені.

Версія крок за кроком з налаштуваннями та усуненням проблем знаходиться в документації: How to correct document properties in bulk with an AI agent.

Чому стандарти метаданих спочатку відхиляються?

Шаблони залишають попередню компанію у кожному новому файлі. Перейменування команди залишає стару назву у полі автора. Міграція залишає часові мітки, які не мають сенсу. Ніхто не редагує властивості вручну у 200 файлах, тому відхилення залишаються. Агент з циклом — правильний інструмент, але лише якщо редагування виконує движок: мовна модель, яка «переписує» документ, щоб змінити автора, генерує новий вміст, тоді як write_metadata змінює лише одне поле і залишає тіло документа без змін.

Який робочий процес?

Робочий процес складається з чотирьох кроків, і кожен має один запит. Запустіть його в Claude Desktop, Claude Code, Cursor, GitHub Copilot або будь‑якому іншому клієнті, який має зареєстрований сервер.

  1. Перевірте ліцензію. Запитайте: «Який статус ліцензії у сервера метаданих?» Агент викликає get_license_status. Зробіть це перед масовим запуском, а не після.
  2. Прочитайте поточні значення. Запитайте: «Спочатку перелічіть поточних Author і Company для кожного файлу». Агент викликає search_metadata з параметром nameContains, який повертає лише відповідні властивості.
  3. Запишіть лише те, що неправильне. Запитайте: «Змініть лише ті, що неправильні». Агент викликає write_metadata для кожного файлу та кожної властивості.
  4. Перевірте. Запитайте: «Прочитайте Author і Company знову у нових файлах і перелічіть ті, що все ще відрізняються, з причиною». Попросіть про помилки у вигляді списку, а не кількості.

Хто вирішує, що: агент чи движок?

Decision Made by
Які файли входять у область, і які значення неправильні Агент, згідно вашого стандарту
Яке ім’я властивості відповідає якому полю у PDF, DOCX або JPEG Движок: write_metadata відображає дружню назву для кожного формату
Чи існує властивість у форматі Движок: запис, який не застосовується, повідомляє 0 змін або повертає помилку, ніколи не успішний без повідомлення
Що було збережено і де Інструмент: повертає повідомлення про шлях збереження та кількість змінених полів
Чи відповідає кінцевий стан стандарту Агент, шляхом повторного читання

write_metadata приймає property як одну з Author, Title, Subject, Keywords, Comments, Copyright, Company або Manager. mode — це set (замінити, за замовчуванням) або add (додати, для полів‑списків, таких як Keywords).

Яке правило зберігає кожне редагування?

write_metadata встановлює одну властивість за виклик і зберігає новий файл. Дві властивості в одному документі — це два виклики, і другий має застосовуватись до результату першого. Якщо другий виклик починається з оригіналу, перше редагування зникає. Коли агент повідомляє, що обидві властивості встановлені, а лише одна залишилася, це причина. Вкажіть правило у запиті:

Застосуйте друге змінення до файлу, створеного першим, а не до оригіналу.

Приклад сеансу (скорочений)

You:    Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> will change
        handbook.docx      Company = "Acme Ltd"       -> already correct
        notes.docx         (no Company property)      -> will add
You:    Go ahead. Name each file you produced.
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 files changed, 1 unchanged. Each saved copy is named in the tool reply.

Це ілюстрація процесу, а не захоплений скріншот.

Чому не виправляти всю папку за один прохід?

Сліпа масова запис може замінити правильні значення на гірші, тому крок читання — це сухий запуск. Це вимагає одного додаткового виклику на файл. За метричним ліцензуванням кожен виклик оплачується, і обробка двох властивостей у 200 файлах становить 400 записів плюс читання, тому спочатку фільтруйте, а потім записуйте.

Формати різняться. Властивість, для якої у форматі немає місця, повідомляється як 0 змін або повертає повідомлення про помилку замість імітації успіху, що є правильним поведінкою, але означає, що змішана папка може дати частковий результат. Попросіть про помилки у вигляді списку.

Які обмеження в режимі оцінки?

У режимі оцінки читаються лише перші 5 властивостей документу, а XMP і EXIF частково недоступні. Запис обмежений так само. Робочий процес «перевірити, потім записати» в режимі оцінки перевіряє скорочений список, тому може пропустити саме ту властивість, яку ви намагаєтеся виправити. Підтвердіть за допомогою get_license_status і застосуйте файл ліцензії або метричні ключі перед тим, як покладатися на результат. Доступна безкоштовна тимчасова ліцензія на 30 днів.

Часто задавані питання

Чи можу я змінити автора у 100 документах Word одночасно?
Так, за допомогою запиту, який вказує папку та значення. Агент робить один виклик write_metadata на файл для властивості Author, тому 100 файлів означає 100 записів.

Чи перезаписує агент мої оригінальні файли?
Інструмент зберігає новий файл і повертає його шлях, тому оригінал не є результатом. Попросіть агента називати кожен створений файл і зберігайте оригінали, доки не перевірите копії.

Чи може агент встановити користувацьку властивість, якої немає у списку?
Документовані значення property — це Author, Title, Subject, Keywords, Comments, Copyright, Company та Manager. Будь‑що інше виходить за межі того, що описує інструмент.

Поглибити