Un flusso di lavoro di revisione di documenti con un agente IA può seguire gli stessi passaggi a ogni ciclo: elencare ciò che è aperto, rispondere nei thread, risolvere, trasferire i commenti alla bozza successiva e produrre una copia pulita. Il server GroupDocs.Annotation.Mcp espone ogni passaggio come uno strumento, così un LLM in Claude, Cursor o GitHub Copilot può eseguire il ciclo localmente mentre una persona approva il risultato:

Elenca le annotazioni in output/contract_annotated.pdf. Quali non hanno risposte?

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: How to run a document review cycle with an AI agent.

Perché le sessioni di revisione si discostano senza una sequenza fissa?

Un ciclo di revisione raramente è “aggiungi un commento”. È: cosa è ancora aperto, chi l’ha sollevato, una risposta, una risoluzione e una copia pulita per il prossimo pubblico. Quando le persone lo fanno manualmente, l’ordine varia, le risposte rimangono senza firma e la bozza successiva perde i commenti della precedente.

Un agente che segue la stessa sequenza ogni volta elimina quella variazione. Lascia inoltre una traccia all’interno del documento anziché in una trascrizione della chat, dove un audit la cercherebbe.

Il flusso di lavoro, passo dopo passo

Ogni passaggio ha un prompt e uno strumento.

  1. Trova ciò che è aperto. Prompt: “Elenca le annotazioni in output/contract_annotated.pdf. Quali non hanno risposte?” L’agente chiama get_annotations, che restituisce ogni annotazione con il suo id, tipo, messaggio, pagina, bounding box, utente e risposte. Un commento senza risposta è quello con un array replies vuoto, quindi l’agente filtra l’elenco già in suo possesso.
  2. Rispondi nel thread. Prompt: “Rispondi al commento di Maria che la finanza ha approvato i termini il 12 marzo. Firma come Alex.” L’agente chiama add_reply con annotationId, comment e userName. Il nome predefinito è mcp-user, quindi chiedi un nome reale.
  3. Risolvi ciò che è completato. Scegli una convenzione e indicala nel prompt: rispondi e lascia il thread come registro, rimuovi l’annotazione con remove_annotations, oppure modifica il messaggio con update_annotation aggiungendo il prefisso [RESOLVED].
  4. Trasferisci il ciclo alla bozza successiva. Prompt: “Esporta le annotazioni dalla copia revisionata, poi importale in contract-v3.pdf.” L’agente chiama export_annotations, che scrive un file XML, quindi import_annotations.
  5. Consegna una copia pulita. Prompt: “Rimuovi tutte le annotazioni e forniscimi una copia pulita per la controparte.” remove_annotations senza ids cancella ogni annotazione in un nuovo file.

Cosa decide l’agente e cosa fa il motore?

Decisione o azione Agente Motore
Quali commenti necessitano di risposta Legge il risultato di get_annotations e lo filtra Restituisce ogni annotazione con id, autori e risposte
Cosa dice la risposta La redige in base alle tue istruzioni La memorizza sotto il userName fornito
Quale convenzione di risoluzione applicare Segue la regola indicata nel tuo prompt Applica la modifica o la rimozione richiesta
Quando il ciclo è terminato Riporta i conteggi; l’umano approva Salva il risultato di ogni modifica nello storage

Il motore non decide mai cosa conta come risolto. Il modello di annotazione non ha un flag “resolved”; la risoluzione è una convenzione che scegli e nomini nel prompt.

Dove rimane l’umano nel ciclo?

In due punti. Prima del passaggio 5, chiedi all’agente di indicare quante annotazioni sta per rimuovere e attendi la tua risposta. La rimozione di tutte le annotazioni è l’unica chiamata nel flusso senza possibilità di annullamento. Prima che qualsiasi cosa esca dal team, leggi le risposte che l’agente ha redatto. Il testo dell’annotazione proviene da altre persone, quindi tratta un commento come contenuto da riassumere, non come istruzione da eseguire.

Sessione di esempio (abbreviata)

Questa è un’illustrazione costruita dal comportamento documentato degli strumenti, non uno screenshot catturato.

You:   List the annotations in output/contract_annotated.pdf. Which ones have no replies?

Agent: [calls get_annotations on output/contract_annotated.pdf]
       Found 4 annotations. Two have no replies:
       - id 2, page 2, Maria: "Confirm the payment terms with finance."
       - id 4, page 5, Maria: "Delivery date conflicts with Schedule B."

You:   Reply to the first one that finance approved the terms on 12 March.
       Sign it as Alex.

Agent: [calls add_reply: annotationId=2, userName="Alex",
        comment="Finance approved the terms on 12 March."]
       Added reply to annotation 2 in output/contract_annotated.pdf.
       (The agent uses the saved file name in the next call.)

Come avvio il server per Claude, Cursor o Copilot?

Esegui l’immagine Docker con la cartella dei documenti montata e una cartella di output diversa da quella di storage:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Lo stesso comando e l’alternativa dnx GroupDocs.Annotation.Mcp --yes sono spiegati in AI review that lands in the document, not in the chat log. La pagina hub contiene la registrazione per Claude Desktop, Claude Code, VS Code con GitHub Copilot, Cursor, Windsurf e altri client.

Limiti onesti

  • Modalità valutazione. Senza licenza, un badge di prova è stampato in alto a ogni pagina, il che non è adatto da inviare a una controparte. Controlla get_license_status prima di una revisione formale.
  • Ogni strumento di scrittura salva il risultato nello storage. Un ciclo produce quindi una catena di file. Dì all’agente di passare il nome del file dal risultato precedente in avanti e di rileggerlo con get_annotations prima di modificarlo, perché gli id appartengono al documento appena letto. Imposta GROUPDOCS_MCP_OUTPUT_PATH su una cartella diversa da quella di storage prima di concatenare modifiche su un file prodotto. Con l’impostazione predefinita (gli output atterrano nella cartella di storage) la seconda scrittura fallisce con “being used by another process”; con una cartella di output separata add_reply, update_annotation e remove_annotations sul file prodotto hanno successo.
  • Le coordinate vengono mantenute così come sono. In una bozza riformattata una nota importata può posizionarsi vicino al testo originale, non sopra di esso. Verifica la posizione dopo l’importazione.
  • Anteprima su Linux. generate_pages_preview attualmente fallisce per file PDF su Linux, inclusa l’immagine Docker (TypeInitializationException per Gdip: System.Drawing.Common non è supportato su piattaforme non‑Windows); i documenti Word e altri Office vengono renderizzati, e su Windows con dnx tutti i formati vengono renderizzati. Gli altri dieci strumenti non sono influenzati. Gli strumenti di revisione in questo post non usano il renderer di anteprima.

Domande frequenti

Un’IA può rispondere automaticamente ai commenti in un PDF? Sì. L’agente legge i commenti con get_annotations e risponde con add_reply, che richiede l’id dell’annotazione, il testo della risposta e un nome autore.

Esiste uno stato “risolto” per i commenti? No. Gli strumenti non hanno un flag “resolved”, quindi scegli una convenzione, ad esempio mantenere il thread, rimuovere l’annotazione o prefissare il messaggio con [RESOLVED].

Posso conservare i commenti quando il documento viene revisionato? Sì. Esporta le annotazioni in XML dalla copia revisionata e importale nella nuova bozza. La stessa coppia di strumenti unisce due copie di revisori in una sola.

Approfondisci