Om documenteigenschappen in bulk te bewerken, geef een AI‑agent een standaard en een map, en laat hem lezen, schrijven en verifiëren via GroupDocs.Metadata.Mcp die lokaal draait. Eén prompt is voldoende om te beginnen:

Voor elk document in mijn map, stel Company in op “Acme Ltd” en Author op “Research Team”, en vertel me vervolgens welke bestanden je hebt gewijzigd.

De stap‑voor‑stap versie met configuratie en probleemoplossing staat in de documentatie: Hoe documenteigenschappen in bulk te corrigeren met een AI‑agent.

Waarom wijken metadata‑standaarden in eerste instantie af?

Templates laten het vorige bedrijf in elk nieuw bestand staan. Een teamhernoeming laat de oude naam in het auteur‑veld staan. Een migratie laat tijdstempels achter die geen zin hebben. Niemand bewerkt eigenschappen handmatig in 200 bestanden, dus de afwijking blijft bestaan. Een agent met een lus is het juiste hulpmiddel, maar alleen als de bewerking wordt uitgevoerd door een engine: een taalmodel dat een document “herschrijft” om de auteur te wijzigen, genereert inhoud opnieuw, terwijl write_metadata één veld wijzigt en de inhoud ongemoeid laat.

Wat is de workflow?

De workflow bestaat uit vier stappen, en elke stap heeft één prompt. Voer het uit in Claude Desktop, Claude Code, Cursor, GitHub Copilot of een andere client die de server heeft geregistreerd.

  1. Controleer de licentie. Vraag: “Wat is de licentiestatus van de metadata‑server?” De agent roept get_license_status aan. Doe dit vóór een bulk‑run, niet erna.
  2. Lees de huidige waarden. Vraag: “Geef eerst de huidige Author en Company voor elk bestand weer.” De agent roept search_metadata aan met nameContains, wat alleen de overeenkomende eigenschappen retourneert.
  3. Schrijf alleen wat fout is. Vraag: “Verander alleen de eigenschappen die onjuist zijn.” De agent roept write_metadata aan voor elk bestand en elke eigenschap.
  4. Verifieer. Vraag: “Lees de Author en Company opnieuw op de nieuwe bestanden en lijst alle bestanden op die nog verschillen, met de reden.” Vraag om mislukkingen als een lijst in plaats van een telling.

Wie beslist wat: de agent of de engine?

Beslissing Uitgevoerd door
Welke bestanden vallen binnen de scope, en welke waarden zijn onjuist De agent, volgens uw standaard
Welke eigenschapsnaam naar welk veld in een PDF, een DOCX of een JPEG wordt gemapt De engine: write_metadata mappt de vriendelijke naam per formaat
Of een eigenschap bestaat in een formaat De engine: een schrijfactie die niet van toepassing is rapporteert 0 gewijzigd of faalt met een bericht, nooit een stilzwijgende succes
Wat er is opgeslagen en waar Het hulpmiddel: het retourneert een bericht met het opgeslagen pad en het aantal gewijzigde velden
Of de uiteindelijke staat overeenkomt met de standaard De agent, door terug te lezen

write_metadata accepteert property als een van Author, Title, Subject, Keywords, Comments, Copyright, Company of Manager. mode is set (vervangen, de standaard) of add (toevoegen, voor lijstvelden zoals Keywords).

Wat is de regel die elke bewerking behoudt?

write_metadata stelt één eigenschap per oproep in en slaat een nieuw bestand op. Twee eigenschappen in één document zijn twee oproepen, en de tweede moet worden toegepast op het resultaat van de eerste. Als de tweede oproep vanaf het origineel start, verdwijnt de eerste bewerking. Wanneer een agent meldt dat beide eigenschappen zijn ingesteld en slechts één is blijven staan, is dit de reden. Formuleer de regel in de prompt:

Pas de tweede wijziging toe op het bestand dat door de eerste is geproduceerd, niet op het origineel.

Voorbeeldsessie (verkort)

Jij:    Stel Company in op "Acme Ltd" voor elk .docx‑bestand in de map. Geef eerst de huidige waarden weer.
Agent:  [calls search_metadata: nameContains = "Company", per file]
Agent:  proposal-q1.docx   Company = "Contoso GmbH"   -> zal worden gewijzigd
        handbook.docx      Company = "Acme Ltd"       -> al correct
        notes.docx         (geen Company‑eigenschap)      -> zal worden toegevoegd
Jij:    Ga door. Noem elk bestand dat je hebt geproduceerd.
Agent:  [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent:  2 bestanden gewijzigd, 1 ongewijzigd. Elke opgeslagen kopie wordt genoemd in de tool‑reactie.

Dit is een illustratie van de stroom, geen vastgelegde schermafbeelding.

Waarom de hele map niet in één keer corrigeren?

Een blinde bulk‑schrijfactie kan goede waarden vervangen door slechtere, dus de leesstap is een droogrun. Het kost één extra oproep per bestand. Bij meter‑gebaseerde licenties wordt elke oproep als gebruik gefactureerd, en een twee‑eigenschappen‑sweep over 200 bestanden is 400 schrijf‑oproepen plus de lees‑oproepen, dus eerst filteren en daarna schrijven.

Formaten verschillen. Een eigenschap waarvoor een formaat geen plaats heeft, wordt gerapporteerd als 0 gewijzigd of faalt met een bericht in plaats van te doen alsof het geslaagd is, wat het juiste gedrag is maar betekent dat een gemengde map een gedeeltelijk resultaat kan opleveren. Vraag om de mislukkingen als een lijst.

Wat zijn de limieten in evaluatiemodus?

In evaluatiemodus zijn alleen de eerste 5 documenteigenschappen leesbaar, en XMP en EXIF zijn gedeeltelijk niet beschikbaar. Schrijven is op dezelfde manier beperkt. Een “check, then write”‑workflow in evaluatie controleert een ingekorte lijst, waardoor de eigenschap die u wilt corrigeren gemist kan worden. Bevestig met get_license_status en pas een licentiebestand of meter‑sleutels toe voordat u op het resultaat vertrouwt. Een gratis tijdelijke licentie van 30 dagen is beschikbaar.

Veelgestelde vragen

Kan ik de auteur van 100 Word‑documenten in één keer wijzigen?
Ja, met een prompt die de map en de waarde benoemt. De agent maakt één write_metadata‑oproep per bestand voor de Author‑eigenschap, dus 100 bestanden betekent 100 schrijf‑oproepen.

Overschrijft de agent mijn originele bestanden?
Het hulpmiddel slaat een nieuw bestand op en retourneert het pad, dus het origineel is niet de output. Vraag de agent om elk bestand dat hij heeft geproduceerd te benoemen, en bewaar de originelen totdat u de kopieën heeft geverifieerd.

Kan de agent een aangepaste eigenschap instellen die niet in de lijst staat?
De gedocumenteerde property‑waarden zijn Author, Title, Subject, Keywords, Comments, Copyright, Company en Manager. Alles anders valt buiten wat het hulpmiddel beschrijft.

Dieper duiken