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 sunucu tarafında PDF, Word, Excel ve PowerPoint üzerine işaretleme yapar, Word eklentisi ve tarayıcı olmadan extension.
The full sample is on GitHub: ai-document-review-annotations-net.
Model ile sözleşmeyi küçük tutun
Bir modelden koordinat istemeyin. Metin ve bir yorum isteyin:
[
{
"quote": "pay all invoices within ninety days",
"comment": "Ninety-day payment terms are three times our standard. Ask for thirty days.",
"severity": "high"
}
]
quote belgeden kelimesi kelimesine kopyalanmalıdır, çünkü bu bir çapa görevi görür: sonraki adım sayfada onu arar. Dört ila on beş kelime ideal noktadır — benzersiz olacak kadar uzun, sayfanın yarısına yayılmayacak kadar kısa.
Diğer her şey bu üç alandan gelir ve hiçbiri dosya formatına bağlı değildir. Bu yüzden tek bir istem PDF, bir .docx ve bir elektronik tablo için çalışır.
Sayfada alıntıyı bulma
GroupDocs.Annotation her sayfanın metnini geometrisiyle birlikte geri verir:
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}");
Aynı çağrı PDF, Word, Excel ve PowerPoint için yanıt verir — bu, yalnızca Word araçlarının yapamadığı kısımdır.
Alıntıyı eşleştirmek üç deneme alır, sırayla: onu içeren tek bir satır; birleştirilmiş metni alıntıyı içeren ardışık satırların bir dizisi, çünkü sayfadaki bir cümle modelin alıntısının sarmadığı bir yerde kayar; ve her ikisi de başarısız olursa, hiç bir şey. Çapa konulamayan bir bulgu raporlanır, tahmine dayalı olarak yerleştirilmez. Karşılaştırmadan önce boşlukları, kıvrımlı tırnakları ve tireleri normalleştirin — modeller belgeye göre daha düzenli tipografiyle metni yeniden üretir.
İşaretlemenin nerede görüneceğini belirleyen iki kural
İlk denemenin genellikle yanlış gittiği yer burasıdır, bu yüzden açıkça belirtmeye değer.
Sayfa numaraları iki kez sayılır. GetDocumentInfo()‘dan gelen PageInfo.PageNumber 1 tabanlıdır. AnnotationBase.PageNumber 0 tabanlıdır. İlkini doğrudan ikinciye geçirirseniz, her işaretleme bir sayfa fazla yer alır — ve son sayfa için olanlar kaybolur, çünkü var olmayan bir sayfaya yönlendirilmiş işaretleme belge kaydedildiğinde atılır. İstisna yok, işaretleme yok, mesaj yok.
İki köken. TextLineInfo ve AreaAnnotation.Box sayfanın sol üst köşesinden ölçüm yapar. Metin işaretlemesi — HighlightAnnotation.Points ve akrabaları — sol alt köşeden ölçüm yapar, PDF’in kullandığı konvansiyon budur. Yüksekliği H olan bir sayfada TopIndent = t ve yüksekliği h olan bir satır, H - t - h ile H - t arasında uzanır.
| Üye | Köken | Sayfa numaralandırması |
|---|---|---|
PageInfo, TextLineInfo |
top-left | 1-based |
AnnotationBase.PageNumber |
— | 0-based |
AreaAnnotation.Box |
top-left | — |
HighlightAnnotation.Points |
bottom-left | — |
PreviewOptions.PageNumbers |
— | 1-based |
Bulguyu belgeye yazma
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");
Sonucu Word’de açtığınızda normal bir incelenmiş belge olur: ifade vurgulanmış, kenar boşluğunda yorum, altında bir yanıt bekliyor. Acrobat’ta açtığınızda ise bir notlu vurgulama olur. İçinde “bir makine tarafından üretildi” diyen tek şey yazar adı — ki bu amaçtır.
Çalınmaya değer iki detay:
- Yanıtta mesajı tekrarlamayın. Word ikisini de gösterir, bu yüzden aynı cümle kenar boşluğunda iki kez görünür. Mesajın bulguyu taşımasına izin verin ve yanıt konuyu açsın.
- Renkler Word’de yaklaşık olarak verilir.
BackgroundColor0xRRGGBBbiçimindedir ve PDF bunu tam olarak tutar, ancak Word sabit bir vurgulama renk paletine sahiptir ve en yakın renge yuvarlar. Yuvarlamadan sonra birbirinden ayrı kalacak şiddet seviyelerini seçin.
Denemeyi güvenli kılan bölüm
Her işaretleme bir yazar içerir, böylece tamamen makine tarafından yazılmış geçiş, bir kişinin yazdığı bir kelimeye dokunmadan geri alınabilir:
annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());
İnceleme bir katmandır, düzenleme değildir. Bir taslak üzerinde çalıştırın, ne bulduğunu görün, eğer gürültü ise silin, daha iyi bir istemle tekrar çalıştırın. İnsanların eklediği yanıtlar aynı konularda kalır ve Get() aracılığıyla geri gelir, böylece ikinci bir geçiş neyin kabul edildiğini neyin reddedildiğini görebilir.
Deneyin
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
Örnek bir bulgu dosyasıyla gelir, böylece çevrim dışı çalışır; ANTHROPIC_API_KEY ayarlayın ve llm-review kullanarak bir modelin onları üretmesini sağlayın. İstem tek bir markdown dosyasıdır ve modeli değiştirmek bir HTTP çağrısını değiştirmektir.
Koordinat kurallarıyla adım adım sürüm belgelerde: Write AI review comments into documents. Eğer bunu kendi kodunuz yerine bir sohbet istemcisinden yönlendirmek isterseniz, GroupDocs.Annotation MCP server aynı işi Claude, Cursor veya Copilot aracılığıyla yapar.