Chiedi a un modello di revisionare un contratto di servizi e fa un lavoro decente: termini di pagamento a novanta giorni, responsabilità illimitata, una clausola di trasferimento dati senza salvaguardie. La risposta arriva come un elenco in una finestra di chat.
Poi il contratto passa a un collega, che lo apre e vede un documento pulito. La revisione è in un’altra applicazione, in una conversazione di cui non faceva parte, collegata a frasi che ora devono trovare manualmente.
Il modello non è il problema. Non ha modo di scrivere nel file. Questo post riguarda il dargli la possibilità — con circa cento righe di C# e GroupDocs.Annotation for .NET, così lo stesso codice contrassegna PDF, Word, Excel e PowerPoint lato server, senza componenti aggiuntivi per Word né estensioni del browser.
Il campione completo è su GitHub:
ai-document-review-annotations-net.
Mantieni il contratto con il modello piccolo
Non chiedere al modello coordinate. Chiedi testo e un commento:
[
{
"quote": "pay all invoices within ninety days",
"comment": "Ninety-day payment terms are three times our standard. Ask for thirty days.",
"severity": "high"
}
]
quote deve essere copiata alla lettera dal documento, perché è l’ancora: il passo successivo lo cerca nella pagina. Da quattro a quindici parole è il punto ideale — abbastanza lungo da essere unico, abbastanza corto da non avvolgersi su metà pagina.
Tutto il resto deriva da questi tre campi e non dipende dal formato del file. Ecco perché un unico prompt serve un PDF, un .docx e un foglio di calcolo.
Trova la citazione nella pagina
GroupDocs.Annotation restituisce il testo di ogni pagina con la sua geometria:
using Annotator annotator = new Annotator("service-agreement.docx");
IDocumentInfo info = annotator.Document.GetDocumentInfo();
foreach (PageInfo page in info.PagesInfo)
foreach (TextLineInfo line in page.TextLines)
Console.WriteLine($"{line.Text} @ {line.LeftIndent},{line.TopIndent} {line.Width}x{line.Height}");
Quella stessa chiamata funziona per PDF, Word, Excel e PowerPoint — cosa che gli strumenti solo per Word non possono fare.
Il confronto della citazione richiede tre tentativi, in ordine: una singola riga che la contiene; una sequenza di righe consecutive il cui testo unito la contiene, perché una frase nella pagina si avvolge dove la citazione del modello no; e, se entrambi falliscono, nulla. Un risultato che non può essere ancorato viene segnalato, mai posizionato a caso. Normalizza spazi, virgolette ricurve e trattini prima di confrontare — i modelli riproducono il testo con una tipografia più ordinata rispetto al documento.
Le due regole che decidono dove cade il markup
Questo è il punto in cui un primo tentativo di solito sbaglia, quindi vale la pena enunciarlo chiaramente.
I numeri di pagina sono contati due volte. PageInfo.PageNumber da GetDocumentInfo() è 1-based. AnnotationBase.PageNumber è 0-based. Passare il primo direttamente al secondo fa sì che ogni annotazione atterri una pagina oltre il necessario — e quelle destinate all’ultima pagina scompaiono, perché un’annotazione indirizzata a una pagina inesistente viene scartata al salvataggio del documento. Nessuna eccezione, nessun markup, nessun messaggio.
Due origini. TextLineInfo e AreaAnnotation.Box misurano dal angolo in alto a sinistra della pagina. Il markup del testo — HighlightAnnotation.Points e i suoi correlati — misura dal angolo in basso a sinistra, la convenzione usata dal PDF. Una riga con TopIndent = t e altezza h su una pagina di altezza H quindi occupa H - t - h fino a H - t.
| Member | Origine | Numerazione pagina |
|---|---|---|
PageInfo, TextLineInfo |
in alto a sinistra | 1-based |
AnnotationBase.PageNumber |
— | 0-based |
AreaAnnotation.Box |
in alto a sinistra | — |
HighlightAnnotation.Points |
in basso a sinistra | — |
PreviewOptions.PageNumbers |
— | 1-based |
Scrivi il risultato nel documento
User reviewer = new User { Id = 1, Name = "AI reviewer", Role = Role.Editor };
float top = (float)(page.Height - box.Y);
float bottom = (float)(page.Height - box.Y - box.Height);
annotator.Add(new HighlightAnnotation
{
PageNumber = page.PageNumber - 1,
BackgroundColor = 0xFFE699,
Opacity = 0.5,
Message = finding.Comment,
CreatedOn = DateTime.Now,
User = reviewer,
Points = new List<Point>
{
new Point(left, top), new Point(right, top),
new Point(left, bottom), new Point(right, bottom)
},
Replies = new List<Reply>
{
new Reply
{
Comment = $"Severity: {finding.Severity}. Reply to accept or reject this remark.",
RepliedOn = DateTime.Now,
User = reviewer
}
}
});
annotator.Save("service-agreement.reviewed.docx");
Apri il risultato in Word ed è un documento revisionato normale: la frase evidenziata, il commento a margine, una risposta sotto in attesa di una risposta. Aprilo in Acrobat e trovi un evidenziatore con una nota. Nulla indica “prodotto da una macchina” tranne il nome dell’autore — ed è proprio questo il punto.
Due dettagli da rubare:
- Non ripetere il messaggio nella risposta. Word rende entrambi, quindi la stessa frase apparirebbe due volte a margine. Lascia che il messaggio contenga il risultato e che la risposta apra la discussione.
- I colori sono approssimativi in Word.
BackgroundColorè0xRRGGBBe un PDF lo mantiene esattamente, ma Word ha una tavolozza fissa di colori di evidenziazione e si aggancia a quello più vicino. Scegli severità che rimangano distinte dopo l’aggancio.
La parte che la rende sicura da provare
Ogni annotazione porta un autore, così l’intera passata generata dalla macchina può essere ritirata senza toccare una parola scritta da una persona:
annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());
La revisione è uno strato, non una modifica. Eseguila su una bozza, vedi cosa trova, eliminala se è rumore, riesegui con un prompt migliore. Le risposte aggiunte dalle persone rimangono negli stessi thread e ritornano tramite Get(), così un secondo passaggio può vedere cosa è stato accettato e cosa rifiutato.
Provalo
git clone https://github.com/groupdocs-annotation/ai-document-review-annotations-net.git
cd ai-document-review-annotations-net
dotnet run --project src/AiReview -- review samples/service-agreement.docx
Il campione fornisce un file di risultati così può funzionare offline; imposta ANTHROPIC_API_KEY e usa llm-review per far produrre al modello i risultati invece. Il prompt è un unico file markdown, e cambiare modello significa cambiare una chiamata HTTP.
La versione passo‑passo, con le regole delle coordinate spiegate, è nella documentazione: Write AI review comments into documents.
Se preferisci guidare il tutto da un client di chat anziché dal tuo codice, il GroupDocs.Annotation MCP server fa lo stesso lavoro tramite Claude, Cursor o Copilot.