モデルにサービス契約書のレビューを依頼すると、まずまずの結果が得られます:90日間の支払条件、無制限の責任、保護策のないデータ転送条項など。回答はチャットウィンドウにリストとして表示されます。
その後、契約書は同僚に回され、同僚はきれいな文書を開きます。レビューは別のアプリケーションにあり、同僚が参加していない会話に記録されており、対象の文を手作業で探さなければなりません。
問題はモデル自体ではありません。モデルにはファイルに書き込む手段がありません。この投稿では、約100行の 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語がちょうど良い長さです――ユニークになるほど長く、ページの半分にまたがらないほど短い。
残りはこの3つのフィールドから導き出され、ファイル形式に依存しません。だから 1 つのプロンプトで 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 のみ対応ツールでは不可能な部分です。
引用文のマッチングは次の 3 段階で行います:1 行だけで含まれる場合、連続した行を結合したテキストに含まれる場合(ページ上の文がモデルの引用と異なる位置で折り返されるため)、どちらでもない場合は何も見つからない場合です。アンカーできない検索結果は「見つからない」と報告し、推測で配置しません。比較前に空白、カーブクオート、ダッシュを正規化します――モデルは文書よりも整ったタイポグラフィでテキストを再現します。
マークアップの配置を決める 2 つのルール
ここで最初の試みが失敗しやすいので、はっきり述べておきます。
ページ番号は 2 回数える。 GetDocumentInfo() の PageInfo.PageNumber は 1 ベースです。AnnotationBase.PageNumber は 0 ベースです。前者をそのまま後者に渡すと、すべてのアノテーションが 1 ページずつずれてしまい、最後のページ向けのものは文書に存在しないページに付けられるため保存時に削除されます。例外もマークアップもメッセージも残りません。
基準点が 2 つある。 TextLineInfo と AreaAnnotation.Box はページの 左上 から測ります。テキストマークアップ(HighlightAnnotation.Points など)は 左下 から測ります――これは PDF が採用している座標系です。ページ高さ H、TopIndent = t、行の高さ h の場合、行は H - t - h から H - t までを占めます。
| Member | Origin | Page numbering |
|---|---|---|
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 で開くと、ハイライトとノートが表示されます。「機械が生成した」という表示は著者名以外にありません――それがポイントです。
覚えておくべき 2 つのポイント:
- 返信にメッセージを繰り返さない。 Word は両方を表示するため、同じ文が余白に 2 回出てしまいます。メッセージは発見内容だけを保持し、返信はスレッドを開くだけにします。
- Word の色は概算です。
BackgroundColorは0xRRGGBB形式で PDF では正確に保持されますが、Word は固定パレットのハイライト色に最も近い色にスナップします。スナップ後も区別できるように重大度ごとに色を選んでください。
安全に試せる理由
すべてのアノテーションには作者が付与されるため、機械が書き込んだ層だけを人が書いた部分に影響を与えずに削除できます:
annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());
レビューは「層」であり「編集」ではありません。ドラフトに対して実行し、見つかった箇所を確認し、ノイズであれば削除し、より良いプロンプトで再実行します。人が追加した返信は同じスレッドに残り Get() で取得できるため、2 回目のパスで受諾されたものと却下されたものを区別できます。
試してみる
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 を通じて同様の機能を提供します。