Puoi far rispettare una politica di firma facendo auditare a un agente AI un’intera cartella di documenti in un unico prompt, localmente, e restituendo una singola tabella di eccezioni. L’agente gira in Claude Desktop, Claude Code, Cursor o GitHub Copilot, e il server GroupDocs.Signature.Mcp esegue il controllo. Il prompt che avvia la scansione:

Per ogni PDF nella mia cartella documenti, verifica se è firmato digitalmente e ancora valido. Forniscimi una tabella: file, firmatario, data di firma, stato.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come auditare una cartella di documenti firmati con un agente AI.

Perché una politica di firma ha bisogno di una scansione automatizzata?

Una politica come “ogni contratto nell’archivio deve contenere una firma digitale valida” è solo una politica se qualcosa la verifica. I controlli manuali aprono i file uno alla volta, quindi avvengono raramente e coprono solo un campione. Le domande che la conformità pone riguardano l’intero archivio: quali contratti non sono firmati, il cui certificato è scaduto, quali file sono stati modificati dopo la firma.

Un agente AI da solo non può rispondere, perché un modello che legge un PDF non può vedere la struttura della firma. L’agente fornisce il ciclo e il riepilogo. Il motore fornisce i fatti, per file.

Il flusso di lavoro, passo per passo

  1. Indirizza il server alla cartella. Imposta GROUPDOCS_MCP_STORAGE_PATH sulla cartella dei documenti. I file vengono risolti per nome, quindi l’agente passa contract-042.pdf, non un percorso dal tuo computer.
  2. Controlla la modalità di licenza. Chiedi all’agente di chiamare get_license_status. In modalità valutazione vengono elaborate solo le prime 2 pagine, quindi un report pulito può essere errato (vedi i limiti sotto).
  3. Esegui la scansione. Usa il prompt sopra. Per ogni file l’agente chiama search_digital_signatures e costruisce la tabella. Un file senza firma digitale trovata viene segnalato come non firmato.
  4. Leggi le eccezioni. Ordina la tabella per stato e gestisci i tre gruppi descritti di seguito.
  5. Riesegui secondo programma. Lo stesso prompt funziona il mese successivo sulla stessa cartella, così l’audit diventa una routine anziché un progetto.

Decide l’agente e fa il motore

Passo Decide l’agente Fa il motore
Quali file controllare Elenca i PDF nella cartella dal tuo prompt Risolve ogni file per nome dallo storage
È firmato, valido e da chi Seleziona i file Restituisce firmatario, emittente, numero di serie, periodo di validità, timestamp e isValid (search_digital_signatures)
Il report Costruisce la tabella e raggruppa le eccezioni Nessuna; il motore non riassume

Sessione di esempio (abbreviata)

Tu:    Per ogni PDF nella mia cartella documenti, verifica se è firmato digitalmente
        e ancora valido. Forniscimi una tabella: file, firmatario, data di firma, stato.

Agente:  [get_license_status]  mode: licensed
        [search_digital_signatures] x N
        | file             | firmatario      | data firma     | stato   |
        | contract-041.pdf | Dana Whitfield | 2026-09-14 | valido    |
        | contract-042.pdf | -              | -          | non firmato |
        | contract-043.pdf | Omar Haddad    | 2026-08-02 | non valido  |
        Eccezioni: 1 non firmato, 1 non valido. Non valido di solito significa che il file
        è stato modificato dopo la firma.

Output illustrativo: i nomi dei file e dei firmatari sono inventati. Lo strumento restituisce i campi descritti sopra.

Le tre eccezioni che contano

  • File non firmati. Questo è il divario che l’audit serve a trovare.
  • Firme non valide. Quasi sempre qualcosa è cambiato dopo la firma: un timbro aggiunto successivamente, un nuovo salvataggio, una pagina aggiunta. Vale la pena saperlo.
  • Certificati scaduti. La firma era valida al momento della creazione. Se conta ancora dipende dalla tua politica. Il periodo di validità è nei dati restituiti, quindi chiedi all’agente di elencare ogni certificato il cui periodo di validità è terminato prima di oggi; quel confronto è ciò che li individua.

Come mantenere la scansione economica e il report affidabile?

  • Esegui search_digital_signatures su ogni file. Aggiungi verify solo come schermata rapida opzionale, e tratta il record dettagliato come fonte di verità.
  • Salta search_image_signatures in blocco. Restituisce immagini base64 per ogni risultato e gonfia l’esecuzione inutilmente.
  • Lascia returnImage disattivato nelle ricerche di codice.
  • Con licenza a consumo ogni chiamata è fatturata in base all’uso, quindi una scansione mirata costa meno e viene eseguita più velocemente.
  • Conserva i dettagli del certificato per file (firmatario, emittente, seriale, timestamp) come tuo archivio. Il riassunto in prosa dell’agente è un report, non un’attestazione, e non è un atto notarile.

Poi agisci sulle eccezioni

La stessa sessione può correggere ciò che la scansione trova, ad esempio applicando un marchio di riferimento ai file non firmati:

Firma i tre file non firmati con il nostro riferimento QR standard e elenca ciò che hai fatto.

Sii preciso su cosa fa. Un codice QR è un marchio visivo, non una firma basata su certificato, quindi non sostituisce una firma digitale obbligatoria. Per i file che ne hanno bisogno, applicala per ultima con sign e type: "digital".

Limiti da indicare nel tuo processo

La modalità valutazione elabora solo le prime 2 pagine di ogni documento e appone un badge di prova su ogni pagina. Una firma a pagina 4 non appare, quindi un audit di massa non licenziato può segnalare “pulito” per un file che non lo è. Controlla get_license_status prima, ogni volta. Il server legge anche i dati della firma dal file; non conosce la tua politica, quindi la definizione di certificato accettabile rimane a te.

FAQ

Quali dei miei contratti non sono firmati?
Chiedi all’agente di auditare la cartella e di elencare i file senza firma digitale. Ogni file genera una chiamata search_digital_signatures; un file per cui non ne viene trovata alcuna è elencato come non firmato. Il risultato è una singola tabella.

L’AI può fare un controllo di massa delle firme PDF?
Sì, in un unico prompt su una cartella, localmente. Senza licenza vengono esaminate solo le prime 2 pagine di ogni file.

Il report può servire come prova di conformità?
Conserva i dettagli del certificato per file restituiti dal motore come prova. Il riepilogo dell’agente è una comodità, non un’attestazione.

Approfondisci