Ask a model to review a services agreement and it does a decent job: ninety-day payment terms, unlimited liability, a data-transfer clause with no safeguards. The answer arrives as a list in a chat window.

Then the contract goes to a colleague, who opens it and sees a clean document. The review is in another application, in a conversation they were not part of, keyed to sentences they now have to find by hand.

The model is not the problem. It has no way to write into the file. This post is about giving it one — with about a hundred lines of C# and GroupDocs.Annotation for .NET, so the same code marks up PDF, Word, Excel and PowerPoint server-side, with no Word add-in and no browser extension.

The full sample is on GitHub: ai-document-review-annotations-net.

Houd het contract met het model klein

Vraag een model niet om coördinaten. Vraag het om tekst en een opmerking:

[
  {
    "quote": "pay all invoices within ninety days",
    "comment": "Ninety-day payment terms are three times our standard. Ask for thirty days.",
    "severity": "high"
  }
]

quote moet letterlijk uit het document worden gekopieerd, omdat het de anker is: de volgende stap zoekt ernaar op de pagina. Vier tot vijftien woorden is de ideale lengte — lang genoeg om uniek te zijn, kort genoeg zodat het niet over de helft van de pagina heen loopt.

Alles andere volgt uit die drie velden, en niets ervan hangt af van het bestandsformaat. Daarom werkt één prompt voor een PDF, een .docx en een spreadsheet.

Vind de quote op de pagina

GroupDocs.Annotation geeft de tekst van elke pagina terug met zijn geometrie:

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}");

Diezelfde oproep werkt voor PDF, Word, Excel en PowerPoint — wat het deel is dat de alleen‑voor‑Word tools niet kunnen.

Het matchen van de quote vereist drie pogingen, in volgorde: een enkele regel die het bevat; een reeks opeenvolgende regels waarvan de samengevoegde tekst het bevat, omdat een zin op de pagina anders wordt afgebroken dan de quote van het model; en, als beide falen, helemaal niets. Een bevinding die niet kan worden verankerd, wordt gerapporteerd, nooit geplaatst op een gok. Normaliseer witruimte, krullende aanhalingstekens en streepjes vóór het vergelijken — modellen reproduceren tekst met nettere typografie dan het document heeft.

De twee regels die bepalen waar de markup terechtkomt

Dit is waar een eerste poging meestal fout gaat, dus het is de moeite waard dit duidelijk te stellen.

Paginanummers worden twee keer geteld. PageInfo.PageNumber van GetDocumentInfo() is 1‑based. AnnotationBase.PageNumber is 0‑based. Stuur de eerste direct naar de tweede en elke annotatie landt één pagina te ver — en de annotaties bedoeld voor de laatste pagina verdwijnen, omdat een annotatie gericht op een niet‑bestaande pagina wordt weggelaten bij het opslaan van het document. Geen uitzondering, geen markup, geen bericht.

Twee oorsprongen. TextLineInfo en AreaAnnotation.Box meten vanaf de linkerboven‑hoek van de pagina. Tekst‑markup — HighlightAnnotation.Points en verwante — meet vanaf de linkeronder‑hoek, de conventie die PDF zelf gebruikt. Een regel op TopIndent = t met hoogte h op een pagina met hoogte H beslaat dus H - t - h tot H - t.

Lid Oorsprong Paginanummering
PageInfo, TextLineInfo top-left 1-based
AnnotationBase.PageNumber — 0-based
AreaAnnotation.Box top-left —
HighlightAnnotation.Points bottom-left —
PreviewOptions.PageNumbers — 1-based

Schrijf de bevinding in het document

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");

Open the result in Word and it is a normal reviewed document: the phrase highlighted, the remark in the margin, a reply under it waiting for an answer. Open it in Acrobat and it is a highlight with a note. Nothing about it says “produced by a machine” except the author name — which is the point.

Twee details die het waard zijn om te stelen:

  • Herhaal de boodschap niet in de reactie. Word rendert beide, dus dezelfde zin zou twee keer in de marge verschijnen. Laat de boodschap de bevinding dragen en de reactie de thread openen.
  • Kleuren zijn benaderend in Word. BackgroundColor is 0xRRGGBB en een PDF behoudt dit exact, maar Word heeft een vaste palet van markeerkleuren en springt naar de dichtstbijzijnde. Kies ernstniveaus die na het springen nog duidelijk van elkaar verschillen.

Het deel dat het veilig maakt om te proberen

Every annotation carries an author, so the whole machine-written pass can be withdrawn without touching a word a person wrote:

annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());

The review is a layer, not an edit. Run it on a draft, see what it finds, delete it if it is noise, run it again with a better prompt. Replies that people added stay in the same threads and come back through Get(), so a second pass can see what was accepted and what was rejected.

Probeer het

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

The sample ships a findings file so it runs offline; set ANTHROPIC_API_KEY and use llm-review to have a model produce them instead. The prompt is a single markdown file, and swapping the model is swapping one HTTP call.

De stapsgewijze versie, met de coördinateregels uitgelegd, staat in de documentatie: Schrijf AI review commentaren in documenten. Als je dit liever vanuit een chatclient wilt aansturen dan vanuit je eigen code, doet de GroupDocs.Annotation MCP server hetzelfde via Claude, Cursor of Copilot.