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

Для каждого документа в моей папке установить Company в «Acme Ltd» и Author в «Research Team», затем сообщить, какие файлы были изменены.

Пошаговая версия с конфигурацией и устранением неполадок находится в документации: Как массово исправлять свойства документов с помощью AI‑агента.

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

Шаблоны оставляют прежнюю компанию в каждом новом файле. Переименование команды оставляет старое имя в поле автора. Миграция оставляет временные метки, которые не имеют смысла. Никто не редактирует свойства вручную в 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 в новых файлах и перечислите любые, которые всё ещё отличаются, с указанием причины.» Запрашивайте не количество, а список ошибок.

Кто решает, что делать: агент или движок?

Решение Кто принимает
Какие файлы включены в область, и какие значения неверны Агент, исходя из вашего стандарта
Какое имя свойства сопоставляется с каким полем в 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. Всё остальное выходит за рамки того, что описывает инструмент.

Подробнее