Puoi aggiungere una filigrana a una cartella di documenti con un unico prompt: un agente IA elenca i file, chiama lo strumento di filigrana una volta per file e riporta ciò che ha prodotto, tutto localmente senza caricamenti. In Claude Desktop, Claude Code, Cursor o Windsurf la richiesta è:

Aggiungi una filigrana diagonale DRAFT a tutti i PDF nella mia cartella dei documenti, poi elenca i file che hai prodotto.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: How to batch-watermark a folder of documents with an AI agent.

Perché applicare il timbro per fase del ciclo di vita invece di una sola volta?

Un pacchetto di proposta raramente viene marcato una sola volta. Inizia come DRAFT, diventa FOR REVIEW quando viene inviato a un collega, e perde il timbro quando viene approvato. Eseguire questa operazione manualmente su trenta file è il tipo di lavoro che si evita quando c’è una scadenza. Con GroupDocs.Watermark.Mcp ogni fase è una frase, e l’agente fornisce il ciclo che altrimenti dovresti scrivere come script. Il motore gestisce il formato, così lo stesso prompt copre PDF, Word, Excel, PowerPoint e file immagine in una cartella.

Fase 1: Come aggiungere una filigrana DRAFT a tutti i file?

Imposta GROUPDOCS_MCP_STORAGE_PATH sulla cartella. I file vengono risolti per nome, quindi l’agente passa proposal-01.pdf, non un percorso dal tuo computer. Poi:

Aggiungi una filigrana diagonale DRAFT a tutti i PDF nella mia cartella dei documenti, poi elenca i file che hai prodotto.

L’agente chiama add_watermark per ogni file. Ogni chiamata salva una nuova copia con filigrana e lascia l’originale al suo posto, così la cartella di origine rimane il tuo registro delle versioni non marcate.

Fase 2: Come passare a un timbro di revisione?

Dopo la Fase 1 ogni file contiene DRAFT, quindi sostituisci il timbro: rimuovi quello vecchio tramite testo, poi applica il nuovo timbro al risultato.

Rimuovi la filigrana DRAFT da ogni file in questa cartella, poi aggiungi una filigrana FOR REVIEW a ciascun risultato.

L’agente chiama remove_watermarks con textFilter impostato a DRAFT, poi add_watermark su ogni copia pulita. Per una cartella in stato misto, dove alcuni file sono marcati e altri no, chiedi all’agente di controllare prima:

Marca ogni file FOR REVIEW tranne quelli che hanno già una filigrana.

Esegue search_watermarks su ogni file e salta quelli che restituiscono un timbro. Per un timbro diverso per formato, specifica:

Metti il logo sulle presentazioni e un timbro testuale sui PDF.

Fase 3: Come rimuovere i timbri quando il lavoro è approvato?

L’approvazione inverte la necessità. Nella stessa cartella, con i tuoi documenti:

Rimuovi la filigrana DRAFT da ogni file in questa cartella e mantieni gli altri timbri.

Questo corrisponde a remove_watermarks con un textFilter di “DRAFT”. Il filtro è una corrispondenza di sottostringa case‑insensitive; senza di esso, tutte le filigrane che il motore può identificare vengono rimosse. I risultati sono salvati come <name>_unwatermarked.<ext>. I dettagli sono nel post complementare sulla ricerca prima della rimozione, collegato qui sotto.

Sessione di esempio (abbreviata)

You:    Add a diagonal DRAFT watermark to every PDF in my documents
        folder, then list the files you produced.
Agent:  [add_watermark x 3: text "DRAFT", rotation -45]
        Added text watermark "DRAFT" to "proposal-01.pdf"
        Added text watermark "DRAFT" to "proposal-02.pdf"
        Added text watermark "DRAFT" to "proposal-03.pdf"
        Produced 3 watermarked copies. 0 failures.
        Originals are unchanged.

Cosa succede agli originali e alla cartella di output?

Per impostazione predefinita, input e output condividono una cartella, quindi le copie con filigrana si trovano accanto alle loro origini. Se preferisci una separazione netta, imposta GROUPDOCS_MCP_OUTPUT_PATH su una cartella separata e distribuisci da lì. In entrambi i casi gli originali non vengono mai sovrascritti, così puoi rieseguire una fase dopo che un file di origine è cambiato; indica nuovamente i file che vuoi processare.

Come mantenere onesto un batch?

  • Chiedi l’elenco dei file prodotti. Un’esecuzione che riporta solo “done” ti lascia indovinare quali copie spedire.
  • Richiedi esplicitamente i fallimenti. Una cartella mista può includere un formato che il motore non può filigranare. La chiamata fallisce con un messaggio invece di saltare silenziosamente, quindi richiedi un elenco dei fallimenti.
  • Fai attenzione all’uso a consumo. Con licenza a consumo ogni file viene fatturato come elaborazione.
  • Controlla prima la licenza. Un batch in modalità valutazione è un’esecuzione sprecata.

Quali sono i limiti?

La modalità valutazione è quella principale: la pagina di licenza del server indica che l’output non licenziato ha limitazioni di valutazione; i limiti esatti sono nella licensing page della libreria. Una cartella di copie in modalità valutazione è una cartella di bozze che non puoi distribuire. Chiedi all’agente di chiamare get_license_status prima dell’esecuzione; riporta mode come evaluation, licensed o metered. Inoltre non esiste un scheduler integrato: il server agisce quando il tuo agente lo richiede, quindi un lavoro ricorrente necessita di un client o di un task runner che invii il prompt.

FAQ

L’IA può aggiungere filigrane a più PDF contemporaneamente?
Sì. L’agente itera la cartella e chiama add_watermark una volta per file, poi elenca le copie prodotte. Ogni file è elaborato separatamente.

Posso aggiungere CONFIDENTIAL a ogni documento in una cartella?
Sì. Sostituisci DRAFT con CONFIDENTIAL nel prompt. Specifica se i file che hanno già un timbro devono essere saltati.

È possibile eseguire il watermarking di massa localmente, senza caricamenti?
Sì. Il server è un processo locale avviato dal tuo client, e legge e scrive nella cartella che hai configurato.

Approfondisci