Per modificare in blocco le proprietà dei documenti, fornisci a un agente IA uno standard e una cartella, e lascia che legga, scriva e verifichi tramite GroupDocs.Metadata.Mcp in esecuzione locale. Un solo prompt è sufficiente per iniziare:

Per ogni documento nella mia cartella, imposta Company su “Acme Ltd” e Author su “Research Team”, poi dimmi quali file hai modificato.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: How to correct document properties in bulk with an AI agent.

Perché gli standard dei metadati si discostano in primo luogo?

I modelli lasciano la società precedente in ogni nuovo file. Una rinomina del team lascia il vecchio nome nel campo autore. Una migrazione lascia timestamp che non hanno senso. Nessuno modifica manualmente le proprietà su 200 file, quindi il discostamento persiste. Un agente con un ciclo è lo strumento giusto, ma solo se la modifica è eseguita da un motore: un modello linguistico che “riscrive” un documento per cambiare l’autore rigenera il contenuto, mentre write_metadata cambia un solo campo e lascia intatto il corpo.

Qual è il flusso di lavoro?

Il flusso di lavoro ha quattro passaggi, ognuno dei quali richiede un prompt. Eseguilo in Claude Desktop, Claude Code, Cursor, GitHub Copilot o qualsiasi altro client che abbia il server registrato.

  1. Verifica la licenza. Chiedi: “Qual è lo stato della licenza del server metadata?” L’agente chiama get_license_status. Fallo prima di un’esecuzione in blocco, non dopo.
  2. Leggi i valori attuali. Chiedi: “Elenca prima l’attuale Author e Company per ogni file.” L’agente chiama search_metadata con nameContains, che restituisce solo le proprietà corrispondenti.
  3. Scrivi solo ciò che è errato. Chiedi: “Modifica solo quelle che sono sbagliate.” L’agente chiama write_metadata per ogni file e per ogni proprietà.
  4. Verifica. Chiedi: “Leggi nuovamente Author e Company sui nuovi file e elenca quelli che differiscono ancora, con il motivo.” Richiedi i fallimenti come elenco anziché come conteggio.

Chi decide cosa: l’agente o il motore?

Decisione Responsabile
Quali file sono in ambito e quali valori sono errati L’agente, in base al tuo standard
Quale nome di proprietà corrisponde a quale campo in PDF, DOCX o JPEG Il motore: write_metadata mappa il nome amichevole per formato
Se una proprietà esiste in un formato Il motore: una scrittura non applicabile segnala 0 modificati o fallisce con un messaggio, mai un successo silenzioso
Cosa è stato salvato e dove Lo strumento: restituisce un messaggio con il percorso salvato e il numero di campi modificati
Se lo stato finale corrisponde allo standard L’agente, leggendo indietro

write_metadata accetta property come una tra Author, Title, Subject, Keywords, Comments, Copyright, Company o Manager. mode è set (sostituisci, predefinito) o add (aggiungi, per campi elenco come Keywords).

Qual è la regola che mantiene ogni modifica?

write_metadata imposta una proprietà per chiamata e salva un nuovo file. Due proprietà su lo stesso documento richiedono due chiamate, e la seconda deve essere applicata al risultato della prima. Se la seconda chiamata parte dal file originale, la prima modifica scompare. Quando un agente segnala che entrambe le proprietà sono state impostate ma ne è rimasta valida solo una, questa è la ragione. Inserisci la regola nel prompt:

Applica la seconda modifica al file prodotto dalla prima, non all’originale.

Sessione di esempio (abbreviata)

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.

Questa è un’illustrazione del flusso, non uno screenshot catturato.

Perché non correggere l’intera cartella in un solo passaggio?

Una scrittura in blocco cieca può sostituire valori corretti con valori peggiori, quindi il passaggio di lettura è una “dry run”. Richiede una chiamata extra per file. Con licenza a consumo ogni chiamata è fatturata, e una scansione di due proprietà su 200 file comporta 400 chiamate di scrittura più le letture, quindi filtra prima e scrivi dopo.

I formati differiscono. Una proprietà per la quale un formato non prevede uno spazio viene segnalata come 0 modificati o fallisce con un messaggio, invece di fingere un successo; questo è il comportamento corretto, ma significa che una cartella mista può dare un risultato parziale. Richiedi i fallimenti come elenco.

Quali sono i limiti in modalità valutazione?

In modalità valutazione solo le prime 5 proprietà del documento sono leggibili, e XMP ed EXIF sono parzialmente non disponibili. La scrittura è limitata allo stesso modo. Un flusso “controlla, poi scrivi” in valutazione verifica un elenco troncato, quindi può non rilevare la proprietà che stai cercando di correggere. Conferma con get_license_status e applica un file di licenza o chiavi a consumo prima di fare affidamento sul risultato. È disponibile una licenza temporanea gratuita di 30 giorni.

Domande frequenti

Posso cambiare l’autore su 100 documenti Word contemporaneamente?
Sì, con un prompt che indica la cartella e il valore. L’agente effettua una chiamata write_metadata per file per la proprietà Author, quindi 100 file equivalgono a 100 chiamate di scrittura.

L’agente sovrascrive i miei file originali?
Lo strumento salva un nuovo file e restituisce il suo percorso, quindi l’originale non è l’output. Chiedi all’agente di nominare ogni file prodotto e conserva gli originali finché non hai verificato le copie.

L’agente può impostare una proprietà personalizzata non presente nell’elenco?
I valori di property documentati sono Author, Title, Subject, Keywords, Comments, Copyright, Company e Manager. Qualsiasi altra voce è al di fuori di quanto descrive lo strumento.

Approfondisci