Per marchiare i documenti automaticamente, fornisci a un agente IA un’istruzione permanente e lascia che chiami uno strumento di filigrana immagine localmente per ogni file nella cartella di uscita. Con il server GroupDocs.Watermark.Mcp quell’istruzione può essere una singola riga in un file di regole, un’istruzione di progetto in Claude Code, o un prompt che incolli in Cursor:

Metti logo.png su ogni pagina di ciascun file nella cartella di uscita al 25% di opacità, poi elenca i file che hai prodotto.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come marchiare i documenti con una filigrana logo usando l’IA.

Perché il marchio manuale deriva?

Il marchio applicato manualmente varia da persona a persona: un team incolla il logo nel file sorgente, un altro stampa il PDF a piena intensità, un terzo dimentica. Un LLM che “aggiunge un logo” modificando il contenuto del documento non ha nemmeno una posizione stabile. Lo strumento add_image_watermark applica il logo come oggetto di filigrana, con valori espliciti di opacity e rotation, così gli stessi input producono la stessa intensità e angolo. Poiché è un oggetto e non contenuto incollato, il logo può essere trovato e rimosso in seguito quando il marchio cambia.

Cosa decide l’agente e cosa fa il motore?

Passo Decide l’agente Fa il motore
Quali file sono in ambito Legge la cartella e la tua istruzione Niente
Quale strumento chiamare add_image_watermark per un logo, add_watermark per uno stato Niente
Intensità e angolo Passa opacity e rotation dal tuo standard Disegna il marchio con esattamente quei valori
Output Riporta i file prodotti Scrive un nuovo file; l’originale non viene modificato

Lo standard vive nel tuo prompt. Il server non si programma da solo e non ha una politica di marchio integrata; la parte ripetibile è l’istruzione che salvi e riutilizzi.

Come far rispettare lo standard in cinque passaggi?

  1. Mantieni il logo accanto ai documenti. Sia il documento sia l’immagine vengono risolti per nome dalla cartella di archiviazione (GROUPDOCS_MCP_STORAGE_PATH). Usa un PNG trasparente; un logo su un rettangolo bianco mostra quel rettangolo sulla pagina.
  2. Separa i file in uscita. Imposta GROUPDOCS_MCP_OUTPUT_PATH su una cartella diversa se vuoi che le copie marchiate siano tenute separate dalle sorgenti. Se non impostato, l’output va nella cartella di archiviazione.
  3. Verifica la licenza. Chiedi: “Qual è lo stato della licenza del server watermark?” L’agente chiama get_license_status.
  4. Esegui il prompt standard. L’opacità tra 0,2 e 0,4 è l’intervallo che la documentazione raccomanda per il branding; sopra 0,6 il logo domina la pagina.
  5. Verifica. Richiedi un passaggio search_watermarks su ciascun file prodotto e confronta il conteggio con quello che ti aspetti.

Il marchio può anche indicare uno stato?

Sì, con una seconda chiamata concatenata. Marchia e indica lo stato in una singola richiesta:

Aggiungi il logo al 25% di opacità, poi aggiungi una filigrana di testo CONFIDENTIAL a quel risultato.

Ogni chiamata scrive un nuovo file, quindi “a quel risultato” è ciò che mantiene entrambi i marchi.

Sessione di esempio (abbreviata)

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

Iterare in questo modo è sicuro perché ogni tentativo è un nuovo file. Elimina quelli rifiutati in seguito.

Quale canale di distribuzione è adatto a un rollout di team?

Per un’installazione condivisa, l’immagine Docker evita di installare altro su ogni macchina, perché il runtime e le dipendenze native sono al suo interno:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

Il canale NuGet (dnx GroupDocs.Watermark.Mcp --yes) richiede il SDK .NET 10. Entrambi funzionano su Windows, Linux e macOS (dnx su Linux/macOS richiede anche libgdiplus), e entrambi usano gli stessi sei strumenti, quindi il prompt di branding non cambia tra loro.

Quali sono i limiti?

Pianifica attorno a due limiti. Primo, lo strumento espone solo opacity e rotation: non c’è impostazione di posizione, dimensione o margine. Secondo, modalità di valutazione: la pagina di licenza del server indica che l’output non licenziato ha limitazioni di valutazione (i limiti esatti sono nella pagina di licenza), quindi le copie marchiate prodotte senza licenza non sono distribuibili. Esegui get_license_status prima di un rollout di branding. Con licenza a consumo ogni file elaborato è fatturato, e con una licenza file il server funziona offline. Tieni anche presente che una filigrana etichetta un documento; non protegge il contenuto sottostante.

FAQ

L’IA può aggiungere il nostro logo aziendale a tutti i PDF?
Sì. Richiedi il logo per nome file e fornisci un’opacità; l’agente chiama add_image_watermark una volta per file. La stessa chiamata funziona anche su Word, PowerPoint, Excel e file immagine.

Posso usare lo stesso logo su immagini e documenti?
Sì. Le immagini sono obiettivi validi, quindi marchiare le foto di prodotto funziona come marchiare un PDF.

Cosa succede quando il marchio cambia?
remove_watermarks può rimuovere il vecchio logo, perché è stato applicato come oggetto di filigrana. Il suo textFilter corrisponde solo al testo della filigrana, quindi rimuovere un logo immagine significa rimuovere tutte le filigrane, inclusi i marchi di testo. Cerca prima così sai cosa c’è, poi aggiungi il nuovo logo.

Approfondisci