Попросіть модель переглянути договір про надання послуг, і вона виконає це досить добре: умови оплати протягом дев’яносто днів, необмежена відповідальність, пункт про передачу даних без захисту. Відповідь надходить у вигляді списку у вікні чату.

Потім контракт потрапляє до колеги, який відкриває його і бачить чистий документ. Огляд знаходиться в іншій програмі, у розмові, у якій вони не брали участі, прив’язаний до речень, які тепер доводиться шукати вручну.

Модель не є проблемою. Вона не має можливості записувати у файл. У цьому дописі мова про те, як надати їй таку можливість — за допомогою приблизно сотні рядків C# та GroupDocs.Annotation for .NET, так що той самий код розмічає PDF, Word, Excel і PowerPoint на сервері, без додатка Word і без розширення браузера.

Повний приклад розміщений на GitHub: ai-document-review-annotations-net.

Тримайте контракт з моделлю невеликим

Не просіть модель про координати. Попросіть її про текст і примітку:

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

quote має бути скопійовано дослівно з документа, оскільки це якорь: наступний крок шукає його на сторінці. Чотири‑п’ятнадцять слів — це оптимальна довжина: достатньо довго, щоб бути унікальним, і достатньо коротко, щоб не розтягувалося на половину сторінки.

Все інше випливає з цих трьох полів, і нічого не залежить від формату файлу. Ось чому один запит працює і з PDF, і з .docx, і з електронною таблицею.

Знайдіть цитату на сторінці

GroupDocs.Annotation повертає текст кожної сторінки з її геометрією:

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

Той самий виклик працює і для PDF, Word, Excel, і PowerPoint — чого не можуть зробити інструменти лише для Word.

Пошук відповідності цитати вимагає трьох спроб у такому порядку: один рядок, який її містить; послідовність сусідніх рядків, об’єднаний текст яких містить її, оскільки речення на сторінці переноситься там, де цитата моделі не переноситься; і, якщо обидва варіанти не спрацювали, нічого. Знаходження, яке не можна закріпити, повідомляється, а не розташовується за припущенням. Перед порівнянням нормалізуйте пробіли, криві лапки та тире — моделі відтворюють текст з акуратнішою типографією, ніж у документі.

Два правила, які визначають, куди потрапляє розмітка

Саме тут перша спроба зазвичай помиляється, тому варто сформулювати це чітко.

Номери сторінок рахуються двічі. PageInfo.PageNumber, отриманий з GetDocumentInfo(), є 1‑based. AnnotationBase.PageNumber — 0‑based. Якщо передати перший безпосередньо у другий, кожна анотація потрапляє на одну сторінку далі — і анотації, призначені для останньої сторінки, зникають, бо анотація, адресована неіснуючій сторінці, відкидається під час збереження документа. Жодного виключення, жодної розмітки, жодного повідомлення.

Два походження. TextLineInfo і AreaAnnotation.Box вимірюються від верхнього лівого кута сторінки. Текстова розмітка — HighlightAnnotation.Points та її родичі — вимірюються від нижнього лівого, згідно з конвенцією, яку використовує сам PDF. Рядок з TopIndent = t і висотою h на сторінці висотою H охоплює діапазон H - t - h до H - t.

Член Походження Нумерація сторінок
PageInfo, TextLineInfo верхній‑лівий 1-based
AnnotationBase.PageNumber — 0-based
AreaAnnotation.Box верхній‑лівий —
HighlightAnnotation.Points нижній‑лівий —
PreviewOptions.PageNumbers — 1-based

Запишіть знайдене у документ

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

Відкрийте результат у Word, і це звичайний документ з рецензією: фраза підсвічена, примітка на полях, відповідь під нею, що чекає на відповідь. Відкрийте його в Acrobat, і це підсвічування з нотаткою. Ніщо в цьому не вказує на «створено машиною», окрім імені автора — саме в цьому і суть.

Два деталі, які варто запозичити:

  • Не повторюйте повідомлення у відповіді. Word відображає обидва, тому одне й те саме речення з’явиться двічі на полях. Нехай повідомлення несе знайдене, а відповідь відкриває ланцюжок.
  • Кольори в Word приблизні. BackgroundColor задається у вигляді 0xRRGGBB, і PDF зберігає його точно, але Word має фіксовану палітру кольорів підсвічування і підбирає найближчий. Обирайте рівні серйозності, які залишаються різними після підбору.

Частина, яка робить спробу безпечною

Кожна анотація містить автора, тому весь машинний прохід можна відкликати, не зачіпаючи жодного слова, яке написав людина:

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

Рецензія — це шар, а не редагування. Запустіть її на чернетці, подивіться, що вона знайшла, видаліть, якщо це шум, запустіть знову з кращим запитом. Відповіді, які додали люди, залишаються в тих самих ланцюжках і повертаються через Get(), тому другий прохід може побачити, що було прийнято, а що відхилено.

Спробуйте

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

У прикладі постачається файл з результатами, тому він працює офлайн; встановіть ANTHROPIC_API_KEY і використайте llm-review, щоб модель створила їх замість цього. Запит — це один markdown‑файл, а заміна моделі це заміна одного HTTP‑запиту.

Покрокова версія, з викладеними правилами координат, знаходиться в документації: Write AI review comments into documents. Якщо ви віддаєте перевагу керувати цим з чат‑клієнта, а не зі свого коду, то GroupDocs.Annotation MCP server виконує ту ж саму задачу через Claude, Cursor або Copilot.