모델에게 서비스 계약서를 검토하도록 요청하면 꽤 괜찮은 작업을 수행합니다: 90일 결제 조건, 무제한 책임, 보호 조치가 없는 데이터 전송 조항. 답변은 채팅 창에 리스트 형태로 도착합니다.

그런 다음 계약서는 동료에게 전달되고, 동료는 파일을 열어 깔끔한 문서를 확인합니다. 검토 내용은 다른 애플리케이션에 있으며, 동료가 참여하지 않은 대화에 들어가 있어, 이제 손으로 찾아야 하는 문장에 연결되어 있습니다.

모델 자체가 문제는 아닙니다. 파일에 쓸 방법이 없습니다. 이 글은 약 백 줄의 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는 문서에서 그대로 복사해야 합니다. 이는 앵커 역할을 하기 때문이며, 다음 단계에서 페이지에서 해당 문구를 찾습니다. 4~15단어가 적당합니다— 고유성을 확보할 만큼 충분히 길고, 페이지 절반을 차지할 정도로 길지는 않게.

다른 모든 내용은 이 세 필드에서 파생되며 파일 형식에 의존하지 않습니다. 그래서 하나의 프롬프트가 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 전용 도구가 할 수 없는 부분입니다.

인용문을 매칭하는 데는 세 번의 시도가 필요합니다. 순서는 다음과 같습니다: 인용문을 포함하는 단일 라인; 인용문이 페이지에서 줄 바꿈되는 경우를 대비해 연결된 텍스트에 인용문이 포함되는 연속 라인; 두 경우 모두 실패하면 아무 것도 찾지 못합니다. 앵커를 잡을 수 없는 찾기는 추정이 아니라 보고됩니다. 비교하기 전에 공백, 곱슬 따옴표 및 대시를 정규화하세요— 모델은 문서보다 깔끔한 타이포그래피로 텍스트를 재현합니다.

마크업이 위치하는 방식을 결정하는 두 가지 규칙

첫 시도가 보통 여기서 잘못되므로 명확히 설명할 가치가 있습니다.

페이지 번호가 두 번 계산됩니다. GetDocumentInfo()에서 반환되는 PageInfo.PageNumber는 1부터 시작합니다. AnnotationBase.PageNumber는 0부터 시작합니다. 첫 값을 그대로 두 번째에 전달하면 모든 주석이 한 페이지씩 앞서게 되며, 마지막 페이지용 주석은 사라집니다. 존재하지 않는 페이지에 지정된 주석은 문서를 저장할 때 삭제되기 때문입니다. 예외도, 마크업도, 메시지도 없습니다.

두 가지 기준점. TextLineInfo와 AreaAnnotation.Box는 페이지의 좌상단을 기준으로 측정합니다. 텍스트 마크업— HighlightAnnotation.Points와 그 관련 요소—는 좌하단을 기준으로 측정합니다. 이는 PDF 자체가 사용하는 관례입니다. TopIndent = t이고 높이가 h인 라인이 높이 H인 페이지에 있을 경우, 실제 위치는 H - t - h부터 H - t까지입니다.

멤버 기준점 페이지 번호
PageInfo, TextLineInfo 좌상단 1부터 시작
AnnotationBase.PageNumber — 0부터 시작
AreaAnnotation.Box 좌상단 —
HighlightAnnotation.Points 좌하단 —
PreviewOptions.PageNumbers — 1부터 시작

문서에 찾은 내용 기록하기

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 호출 하나를 교체하는 것과 같습니다.

좌표 규칙을 자세히 설명한 단계별 버전은 문서에 있습니다: 문서에 AI 검토 댓글 작성. 자체 코드 대신 채팅 클라이언트에서 이 작업을 수행하고 싶다면, GroupDocs.Annotation MCP 서버가 Claude, Cursor 또는 Copilot을 통해 동일한 작업을 수행합니다.