Demandez à un modèle de réviser un contrat de services et il fait un travail correct : des conditions de paiement de quatre‑vingt‑dix jours, une responsabilité illimitée, une clause de transfert de données sans garanties. La réponse arrive sous forme de liste dans une fenêtre de chat.

Ensuite le contrat passe à un collègue, qui l’ouvre et voit un document propre. La révision se trouve dans une autre application, dans une conversation à laquelle ils n’ont pas participé, liée à des phrases qu’ils doivent maintenant trouver manuellement.

Le modèle n’est pas le problème. Il n’a aucun moyen d’écrire dans le fichier. Cet article porte sur la façon de lui en fournir un — avec environ une centaine de lignes de C# et GroupDocs.Annotation for .NET, de sorte que le même code annote PDF, Word, Excel et PowerPoint côté serveur, sans module complémentaire Word et sans extension de navigateur.

L’exemple complet est sur GitHub : ai-document-review-annotations-net.

Gardez le contrat avec le modèle compact

Ne demandez pas de coordonnées au modèle. Demandez‑lui du texte et une remarque :

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

quote doit être copié mot pour mot depuis le document, car il sert d’ancre : l’étape suivante le recherche sur la page. Quatre à quinze mots est le point idéal — assez long pour être unique, assez court pour ne pas s’étendre sur la moitié de la page.

Tout le reste découle de ces trois champs, et aucun ne dépend du format de fichier. C’est pourquoi une même invite fonctionne pour un PDF, un .docx et une feuille de calcul.

Trouvez la citation sur la page

GroupDocs.Annotation renvoie le texte de chaque page avec sa géométrie :

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

Le même appel fonctionne pour PDF, Word, Excel et PowerPoint — ce que les outils uniquement Word ne peuvent pas faire.

La correspondance de la citation nécessite trois tentatives, dans l’ordre : une ligne unique qui la contient ; une série de lignes consécutives dont le texte concaténé la contient, car une phrase sur la page se poursuit là où la citation du modèle ne le fait pas ; et, si les deux échouent, rien du tout. Un résultat qui ne peut pas être ancré est signalé, jamais placé à l’aveugle. Normalisez les espaces, les guillemets typographiques et les tirets avant la comparaison — les modèles reproduisent le texte avec une typographie plus soignée que celle du document.

Les deux règles qui décident où le marquage atterrit

C’est ici qu’une première tentative échoue généralement, il vaut donc la peine de le dire clairement.

Les numéros de page sont comptés deux fois. PageInfo.PageNumber provenant de GetDocumentInfo() est à partir de 1. AnnotationBase.PageNumber est à partir de 0. Transférez le premier directement dans le second et chaque annotation se place une page trop loin — et celles destinées à la dernière page disparaissent, car une annotation adressée à une page qui n’existe pas est supprimée lors de l’enregistrement du document. Aucun exception, aucun marquage, aucun message.

Deux origines. TextLineInfo et AreaAnnotation.Box mesurent depuis le coin en haut à gauche de la page. Le marquage de texte — HighlightAnnotation.Points et ses semblables — mesure depuis le en bas à gauche, la convention utilisée par le PDF lui‑même. Une ligne à TopIndent = t avec une hauteur h sur une page de hauteur H s’étend donc de H - t - h à H - t.

Membre Origine Numérotation des pages
PageInfo, TextLineInfo en haut à gauche à partir de 1
AnnotationBase.PageNumber — à partir de 0
AreaAnnotation.Box en haut à gauche —
HighlightAnnotation.Points en bas à gauche —
PreviewOptions.PageNumbers — à partir de 1

Écrivez la constatation dans le document

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

Ouvrez le résultat dans Word et c’est un document révisé normal : la phrase surlignée, la remarque dans la marge, une réponse en dessous attendant une réponse. Ouvrez‑le dans Acrobat et c’est un surlignage avec une note. Rien ne indique qu’il a été « produit par une machine » sauf le nom de l’auteur — ce qui est l’objectif.

Deux détails à retenir :

  • Ne répétez pas le message dans la réponse. Word rend les deux, de sorte que la même phrase apparaîtrait deux fois dans la marge. Laissez le message contenir la constatation et la réponse ouvrir le fil.
  • Les couleurs sont approximatives dans Word. BackgroundColor est 0xRRGGBB et un PDF la conserve exactement, mais Word possède une palette fixe de couleurs de surlignage et se rapproche de la plus proche. Choisissez des niveaux de gravité qui restent distincts après l’ajustement.

La partie qui rend cela sûr à essayer

Chaque annotation possède un auteur, de sorte que l’ensemble du passage généré par la machine peut être retiré sans toucher un mot écrit par une personne :

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

La révision est une couche, pas une modification. Exécutez‑la sur un brouillon, voyez ce qu’elle trouve, supprimez‑la si c’est du bruit, exécutez‑la à nouveau avec une meilleure invite. Les réponses ajoutées par les personnes restent dans les mêmes fils et reviennent via Get(), ainsi une deuxième passe peut voir ce qui a été accepté et ce qui a été rejeté.

Essayez-le

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

L’exemple inclut un fichier de constatations afin qu’il fonctionne hors ligne ; définissez ANTHROPIC_API_KEY et utilisez llm-review pour qu’un modèle les génère à la place. L’invite est un seul fichier markdown, et changer de modèle c’est changer un appel HTTP.

La version pas à pas, avec les règles de coordonnées détaillées, se trouve dans la documentation : Écrire des commentaires de révision IA dans les documents. Si vous préférez piloter cela depuis un client de chat plutôt que depuis votre propre code, le GroupDocs.Annotation MCP server effectue le même travail via Claude, Cursor ou Copilot.