Pídele a un modelo que revise un contrato de servicios y hace un trabajo decente: términos de pago de noventa días, responsabilidad ilimitada, una cláusula de transferencia de datos sin salvaguardas. La respuesta llega como una lista en una ventana de chat.
Luego el contrato pasa a un colega, que lo abre y ve un documento limpio. La revisión está en otra aplicación, en una conversación de la que no formaron parte, vinculada a oraciones que ahora tienen que buscar manualmente.
El modelo no es el problema. No tiene forma de escribir en el archivo. Esta publicación trata de darle una — con alrededor de cien líneas de C# y GroupDocs.Annotation for .NET, de modo que el mismo código marca PDF, Word, Excel y PowerPoint del lado del servidor, sin complemento de Word y sin extensión de navegador.
El ejemplo completo está en GitHub: ai-document-review-annotations-net.
Mantenga el contrato con el modelo pequeño
No le pida al modelo coordenadas. Pídale texto y un comentario:
[
{
"quote": "pay all invoices within ninety days",
"comment": "Ninety-day payment terms are three times our standard. Ask for thirty days.",
"severity": "high"
}
]
quote debe copiarse literalmente del documento, porque es el ancla: el siguiente paso lo busca en la página. De cuatro a quince palabras es el punto óptimo — lo suficientemente largo para ser único, lo suficientemente corto para que no se envuelva a lo largo de la mitad de la página.
Todo lo demás se deriva de esos tres campos, y nada depende del formato de archivo. Por eso una sola solicitud sirve para un PDF, un .docx y una hoja de cálculo.
Encuentre la cita en la página
GroupDocs.Annotation devuelve el texto de cada página con su geometría:
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}");
Esa misma llamada funciona para PDF, Word, Excel y PowerPoint — que es la parte que las herramientas solo para Word no pueden hacer.
Coincidir la cita lleva tres intentos, en orden: una sola línea que la contenga; una serie de líneas consecutivas cuyo texto unido la contenga, porque una oración en la página se envuelve donde la cita del modelo no lo hace; y, si ambos fallan, nada en absoluto. Un hallazgo que no puede anclarse se informa, nunca se coloca a ciegas. Normalice los espacios, comillas curvas y guiones antes de comparar — los modelos reproducen el texto con una tipografía más ordenada que la del documento.
Las dos reglas que deciden dónde se coloca el marcado
Aquí es donde un primer intento suele fallar, por lo que vale la pena declararlo claramente.
Los números de página se cuentan dos veces. PageInfo.PageNumber de GetDocumentInfo() es basado en 1. AnnotationBase.PageNumber es basado en 0. Pasar el primero directamente al segundo hace que cada anotación quede una página demasiado lejos — y las que estaban destinadas a la última página desaparecen, porque una anotación dirigida a una página que no existe se descarta al guardar el documento. Sin excepción, sin marcado, sin mensaje.
Dos orígenes. TextLineInfo y AreaAnnotation.Box miden desde la esquina superior izquierda de la página. El marcado de texto — HighlightAnnotation.Points y sus relativos — mide desde la inferior izquierda, la convención que usa el propio PDF. Una línea en TopIndent = t con altura h en una página de altura H abarca entonces H - t - h a H - t.
| Miembro | Origen | Numeración de página |
|---|---|---|
PageInfo, TextLineInfo |
superior izquierda | 1-based |
AnnotationBase.PageNumber |
— | 0-based |
AreaAnnotation.Box |
superior izquierda | — |
HighlightAnnotation.Points |
inferior izquierda | — |
PreviewOptions.PageNumbers |
— | 1-based |
Escriba el hallazgo en el documento
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");
Abra el resultado en Word y es un documento revisado normal: la frase resaltada, el comentario en el margen, una respuesta debajo esperando una respuesta. Ábralo en Acrobat y es un resaltado con una nota. Nada en él dice “producido por una máquina” excepto el nombre del autor — que es el punto.
Dos detalles que vale la pena copiar:
- No repita el mensaje en la respuesta. Word muestra ambos, por lo que la misma oración aparecería dos veces en el margen. Deje que el mensaje contenga el hallazgo y que la respuesta abra el hilo.
- Los colores son aproximados en Word.
BackgroundColores0xRRGGBBy un PDF lo mantiene exactamente, pero Word tiene una paleta fija de colores de resaltado y se ajusta al más cercano. Elija severidades que permanezcan distintas después del ajuste.
La parte que lo hace seguro de probar
Cada anotación lleva un autor, por lo que todo el paso escrito por la máquina puede retirarse sin tocar una palabra escrita por una persona:
annotator.Remove(annotator.Get().Where(a => a.User?.Name == "AI reviewer").ToList());
La revisión es una capa, no una edición. Ejecútela en un borrador, vea lo que encuentra, elimínela si es ruido, ejecútela de nuevo con una mejor solicitud. Las respuestas que la gente añadió permanecen en los mismos hilos y vuelven a través de Get(), de modo que una segunda pasada puede ver lo que se aceptó y lo que se rechazó.
Pruébelo
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
El ejemplo incluye un archivo de hallazgos para que se ejecute sin conexión; configure ANTHROPIC_API_KEY y use llm-review para que un modelo los genere en su lugar. La solicitud es un único archivo markdown, y cambiar el modelo es cambiar una llamada HTTP.
La versión paso a paso, con las reglas de coordenadas detalladas, está en la documentación: Escribir comentarios de revisión de IA en documentos. Si prefiere controlar esto desde un cliente de chat en lugar de su propio código, el GroupDocs.Annotation MCP server realiza el mismo trabajo a través de Claude, Cursor o Copilot.