Bitten Sie ein Modell, einen Dienstleistungsvertrag zu prüfen, und es leistet eine anständige Arbeit: neunzig‑Tage‑Zahlungsbedingungen, unbeschränkte Haftung, eine Datenübertragungsklausel ohne Schutzmaßnahmen. Die Antwort kommt als Liste in einem Chat‑Fenster.

Dann geht der Vertrag an einen Kollegen, der ihn öffnet und ein sauberes Dokument sieht. Die Prüfung befindet sich in einer anderen Anwendung, in einer Unterhaltung, an der er nicht teilgenommen hat, und ist an Sätze geknüpft, die er nun von Hand finden muss.

Das Modell ist nicht das Problem. Es hat keine Möglichkeit, in die Datei zu schreiben. In diesem Beitrag geht es darum, ihm eine zu geben – mit etwa hundert Zeilen C# und GroupDocs.Annotation for .NET, sodass derselbe Code PDF, Word, Excel und PowerPoint serverseitig markiert, ohne Word‑Add‑in und ohne Browser‑Erweiterung.

Das vollständige Beispiel befindet sich auf GitHub: ai-document-review-annotations-net.

Halten Sie den Vertrag für das Modell klein

Bitten Sie das Modell nicht um Koordinaten. Bitten Sie es um Text und einen Hinweis:

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

quote muss wortwörtlich aus dem Dokument kopiert werden, da es der Anker ist: Der nächste Schritt sucht es auf der Seite. Vier bis fünfzehn Wörter sind der optimale Bereich – lang genug, um eindeutig zu sein, kurz genug, dass es nicht über die Hälfte der Seite umbricht.

Alles andere ergibt sich aus diesen drei Feldern und hängt nicht vom Dateiformat ab. Deshalb funktioniert ein Prompt für ein PDF, ein .docx und eine Tabellenkalkulation.

Finden Sie das Zitat auf der Seite

GroupDocs.Annotation gibt den Text jeder Seite mit ihrer Geometrie zurück:

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

Der gleiche Aufruf funktioniert für PDF, Word, Excel und PowerPoint – was die rein Word‑basierten Werkzeuge nicht können.

Das Abgleichen des Zitats erfordert drei Versuche, in dieser Reihenfolge: eine einzelne Zeile, die es enthält; eine Folge aufeinanderfolgender Zeilen, deren zusammengefügter Text es enthält, weil ein Satz auf der Seite umbricht, wo das Zitat des Modells nicht umbricht; und, wenn beides fehlschlägt, gar nichts. Ein Fund, der nicht verankert werden kann, wird gemeldet, niemals an einer Vermutung platziert. Normalisieren Sie Leerzeichen, geschweifte Anführungszeichen und Bindestriche vor dem Vergleich – Modelle reproduzieren Text mit saubererer Typografie als das Dokument.

Die beiden Regeln, die bestimmen, wo die Markierung landet

Hier geht ein erster Versuch meist schief, daher lohnt es sich, das klar zu formulieren.

Seitenzahlen werden doppelt gezählt. PageInfo.PageNumber von GetDocumentInfo() ist 1‑basiert. AnnotationBase.PageNumber ist 0‑basiert. Wenn Sie das erste direkt in das zweite übergeben, landet jede Anmerkung eine Seite zu weit – und die für die letzte Seite vorgesehenen verschwinden, weil eine Anmerkung, die sich auf eine nicht existierende Seite bezieht, beim Speichern des Dokuments verworfen wird. Keine Ausnahme, keine Markierung, keine Meldung.

Zwei Ursprünge. TextLineInfo und AreaAnnotation.Box messen vom oberen linken Eck der Seite. Textmarkierungen – HighlightAnnotation.Points und verwandte – messen vom unteren linken Eck, der Konvention, die PDF selbst verwendet. Eine Zeile bei TopIndent = t mit Höhe h auf einer Seite mit Höhe H erstreckt sich daher von H - t - h bis H - t.

Element Ursprung Seitennummerierung
PageInfo, TextLineInfo oben‑links 1-based
AnnotationBase.PageNumber — 0-based
AreaAnnotation.Box oben‑links —
HighlightAnnotation.Points unten‑links —
PreviewOptions.PageNumbers — 1-based

Schreiben Sie den Fund in das Dokument

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

Öffnen Sie das Ergebnis in Word und es ist ein normal geprüftes Dokument: die Phrase ist hervorgehoben, der Hinweis im Rand, eine Antwort darunter, die auf eine Rückmeldung wartet. Öffnen Sie es in Acrobat und es ist eine Hervorhebung mit einer Notiz. Nichts daran sagt „von einer Maschine erzeugt“, außer dem Autorennamen – das ist der Punkt.

Zwei Details, die es wert sind, übernommen zu werden:

  • Wiederholen Sie die Nachricht nicht in der Antwort. Word rendert beide, sodass derselbe Satz zweimal im Rand erscheinen würde. Lassen Sie die Nachricht den Fund tragen und die Antwort den Thread öffnen.
  • Farben sind in Word approximativ. BackgroundColor ist 0xRRGGBB und ein PDF behält es exakt bei, aber Word hat eine feste Palette von Hervorhebungsfarben und greift auf die nächste zu. Wählen Sie Schweregrade, die nach dem Runden auseinander bleiben.

Der Teil, der es sicher macht, es auszuprobieren

Jede Anmerkung enthält einen Autor, sodass der gesamte maschinell geschriebene Durchlauf zurückgezogen werden kann, ohne ein Wort, das eine Person geschrieben hat, zu berühren:

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

Die Prüfung ist eine Ebene, keine Bearbeitung. Führen Sie sie auf einem Entwurf aus, sehen Sie, was sie findet, löschen Sie sie, wenn es Rauschen ist, führen Sie sie erneut mit einem besseren Prompt aus. Antworten, die Personen hinzugefügt haben, bleiben in denselben Threads und kommen über Get() zurück, sodass ein zweiter Durchlauf sehen kann, was akzeptiert und was abgelehnt wurde.

Ausprobieren

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

Das Beispiel enthält eine Funddatei, sodass es offline läuft; setzen Sie ANTHROPIC_API_KEY und verwenden Sie llm-review, um ein Modell die Ergebnisse stattdessen erzeugen zu lassen. Der Prompt ist eine einzelne Markdown‑Datei, und das Austauschen des Modells bedeutet, einen HTTP‑Aufruf zu ersetzen.

Die Schritt‑für‑Schritt‑Version, mit den Koordinatenregeln ausgeschrieben, befindet sich in der Dokumentation: AI‑Überprüfungskommentare in Dokumente schreiben.

Wenn Sie dies lieber von einem Chat‑Client aus steuern möchten als aus Ihrem eigenen Code, erledigt der GroupDocs.Annotation MCP server die gleiche Aufgabe über Claude, Cursor oder Copilot.