Aby masowo edytować właściwości dokumentów, podaj agentowi AI standard i folder, i pozwól mu odczytywać, zapisywać i weryfikować za pomocą GroupDocs.Metadata.Mcp działającego lokalnie. Jeden prompt wystarczy, aby rozpocząć:

Dla każdego dokumentu w moim folderze ustaw Company na „Acme Ltd” i Author na „Research Team”, a następnie powiedz mi, które pliki zostały zmienione.

Wersja krok po kroku z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: Jak poprawić właściwości dokumentów masowo przy użyciu agenta AI.

Dlaczego standardy metadanych odchodzą od pierwotnych wartości?

Szablony pozostawiają poprzednią firmę w każdym nowym pliku. Zmiana nazwy zespołu pozostawia starą nazwę w polu autora. Migracja pozostawia znaczniki czasu, które nie mają sensu. Nikt nie edytuje właściwości ręcznie w 200 plikach, więc odchylenie pozostaje. Agent z pętlą jest odpowiednim narzędziem, ale tylko wtedy, gdy edycja jest wykonywana przez silnik: model językowy, który „przepisuje” dokument, aby zmienić autora, generuje nową treść, podczas gdy write_metadata zmienia jedno pole i pozostawia ciało dokumentu niezmienione.

Jaki jest przebieg pracy?

Przepływ pracy składa się z czterech kroków, a każdy ma jeden prompt. Uruchom go w Claude Desktop, Claude Code, Cursor, GitHub Copilot lub dowolnym innym kliencie, który ma zarejestrowany serwer.

  1. Sprawdź licencję. Zapytaj: „Jaki jest status licencji serwera metadanych?” Agent wywołuje get_license_status. Zrób to przed masowym uruchomieniem, nie po.
  2. Odczytaj bieżące wartości. Zapytaj: „Najpierw wypisz bieżącego Autora i Firmę dla każdego pliku.” Agent wywołuje search_metadata z nameContains, które zwraca tylko pasujące właściwości.
  3. Zapisz tylko to, co jest nieprawidłowe. Zapytaj: „Zmień tylko te, które są nieprawidłowe.” Agent wywołuje write_metadata dla każdego pliku i każdej właściwości.
  4. Zweryfikuj. Zapytaj: „Ponownie odczytaj Autora i Firmę w nowych plikach i wypisz te, które nadal się różnią, podając przyczynę.” Poproś o niepowodzenia w formie listy, a nie liczby.

Kto decyduje o czym: agent czy silnik?

Decyzja Dokonuje
Które pliki są w zakresie, a które wartości są nieprawidłowe Agent, na podstawie twojego standardu
Jak nazwa właściwości mapuje się na pole w PDF, DOCX lub JPEG Silnik: write_metadata mapuje przyjazną nazwę w zależności od formatu
Czy właściwość istnieje w danym formacie Silnik: zapis, który nie ma zastosowania, zgłasza 0 zmian lub zwraca błąd, nigdy ciche powodzenie
Co zostało zapisane i gdzie Narzędzie: zwraca komunikat ze ścieżką zapisanego pliku i liczbę zmienionych pól
Czy ostateczny stan odpowiada standardowi Agent, poprzez odczyt zwrotny

write_metadata akceptuje property jako jedną z: Author, Title, Subject, Keywords, Comments, Copyright, Company lub Manager. mode to set (zastąp, domyślnie) lub add (dodaj, dla pól listowych takich jak Keywords).

Jaka jest zasada, która zapewnia każdą edycję?

write_metadata ustawia jedną właściwość na wywołanie i zapisuje nowy plik. Dwie właściwości w jednym dokumencie to dwa wywołania, a drugie musi być zastosowane do wyniku pierwszego. Jeśli drugie wywołanie zaczyna się od oryginału, pierwsza edycja znika. Gdy agent zgłasza, że obie właściwości zostały ustawione, a tylko jedna się utrzymała, to jest przyczyna. Podaj zasadę w promptcie:

Zastosuj drugą zmianę do pliku wygenerowanego przez pierwszą, a nie do oryginału.

Przykładowa sesja (skrótowo)

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.

To ilustracja przepływu, a nie zrzut ekranu.

Dlaczego nie naprawić całego folderu w jednym przebiegu?

Ślepe masowe zapisy mogą zastąpić dobre wartości gorszymi, więc krok odczytu jest suchym przebiegiem. Kosztuje to jedno dodatkowe wywołanie na plik. W modelu licencjonowania z naliczaniem opłat każde wywołanie jest rozliczane, a przegląd dwóch właściwości w 200 plikach to 400 wywołań zapisu plus odczyty, więc najpierw filtruj, potem zapisuj.

Formaty się różnią. Właściwość, dla której format nie ma miejsca, jest zgłaszana jako 0 zmian lub zwraca błąd zamiast udawać sukces, co jest prawidłowe, ale oznacza, że mieszany folder może dawać częściowy wynik. Poproś o niepowodzenia w formie listy.

Jakie są limity w trybie ewaluacji?

W trybie ewaluacji odczytywalne są tylko pierwsze 5 właściwości dokumentu, a XMP i EXIF są częściowo niedostępne. Zapisy są ograniczone w ten sam sposób. Przepływ pracy „sprawdź, a potem zapisz” w trybie ewaluacji sprawdza skróconą listę, więc może pominąć właściwość, którą próbujesz skorygować. Potwierdź za pomocą get_license_status i zastosuj plik licencyjny lub klucze z naliczaniem przed poleganiem na wyniku. Dostępna jest darmowa 30‑dniowa licencja tymczasowa.

Najczęściej zadawane pytania

Czy mogę zmienić autora w 100 dokumentach Word jednocześnie?
Tak, przy użyciu promptu, który podaje folder i wartość. Agent wykonuje jedno wywołanie write_metadata na plik dla właściwości Author, więc 100 plików oznacza 100 wywołań zapisu.

Czy agent nadpisuje moje oryginalne pliki?
Narzędzie zapisuje nowy plik i zwraca jego ścieżkę, więc oryginał nie jest wynikiem. Poproś agenta, aby nazwał każdy wygenerowany plik i zachowaj oryginały, dopóki nie zweryfikujesz kopii.

Czy agent może ustawić własną właściwość, której nie ma na liście?
Udokumentowane wartości property to Author, Title, Subject, Keywords, Comments, Copyright, Company i Manager. Wszystko inne wykracza poza to, co opisuje narzędzie.

Zagłęb się