Een AI‑agent kan elk commentaar uit een gemarkeerd document halen en er op drie manieren over rapporteren: een samenvatting, een tabel of een XML‑archief. De GroupDocs.Annotation.Mcp‑server geeft de LLM de annotaties als gestructureerde gegevens, en Claude, Cursor of GitHub Copilot voeren de redenering uit, allemaal lokaal:

Samenvat de beoordeling van contract_annotated.pdf: hoeveel opmerkingen, van wie, en wat de belangrijkste thema’s zijn.

De stapsgewijze versie met configuratie en probleemoplossing staat in de documentatie: Hoe annotaties uit een document te extraheren en te rapporteren met AI.

Wat krijg je wanneer je annotaties uit een PDF extraheert?

Een gemarkeerd document is zowel data als inkt. Het get_annotations‑hulpmiddel retourneert een JSON‑object met found, het aantal, en annotations, een array. Elke invoer bevat de annotatie id, type, message, page (1‑gebaseerd), de begrenzingsvak, de user en eventuele replies. Er is geen documentparsing en geen OCR betrokken, dus de agent werkt vanuit de annotatierecords zelf.

Het hulpmiddel neemt één document per oproep. Om een set bestanden te dekken, noem je ze in de prompt en de agent roept het hulpmiddel één keer per bestand aan. De server biedt geen map‑niveau oproep.

Manier 1: Vraag om een samenvatting

Eén oproep, daarna redeneren. Noem het bestand en geef aan waarvoor de samenvatting is.

Samenvat de beoordeling van contract_annotated.pdf: hoeveel opmerkingen, van wie, en wat de belangrijkste thema’s zijn.

De agent roept get_annotations aan, telt de invoeren, groepeert ze op user en beschrijft de thema’s die hij vindt in de message‑velden. Het aantal en de auteurs komen uit de gegevens. De thema’s zijn de interpretatie van het model van de tekst, dus ze verdienen een menselijke blik.

Manier 2: Vraag om een tabel of een gefilterde lijst

Omdat de gegevens gestructureerd zijn, is de vorm van het rapport een kwestie van de prompt:

Geef me een tabel: pagina, auteur, opmerking, beantwoord ja/nee.

Groepeer de opmerkingen op beoordelaar en vertel me wie de meeste open items heeft.

Lijst alleen de doorhalingen. Ik wil zien wat mensen verwijderd willen hebben.

Welke pagina’s hebben helemaal geen opmerkingen?

De laatste vraag is er één die een PDF‑lezer slecht beantwoordt en een array beantwoordt direct: “answered” is een niet‑lege replies‑lijst, en “pages without comments” zijn de paginanummers die ontbreken in de page‑waarden. Combineer dit met get_document_info voor het paginacontrole.

Manier 3: Archiveer de opmerkingen als XML

Exporteer de annotaties zodat we ze bij het dossier kunnen bewaren.

export_annotations schrijft een XML‑bestand dat alleen de annotaties bevat. Het succesbericht heeft de vorm Exported N annotation(s) from <file> to <name>.annotations.xml. Het bestand is klein en kan worden vergeleken, en import_annotations kan het toepassen op een andere kopie van het document. Dit helpt wanneer het document onder een retentieregel valt die de opmerkingen niet omvat, of wanneer je twee beoordelingsrondes wilt vergelijken: twee exports van hetzelfde document zijn twee tekstbestanden, en de agent kan beschrijven wat er tussen hen is veranderd.

Voorbeeldsessie (verkort)

Dit is een illustratie gebaseerd op het gedocumenteerde gedrag van de hulpmiddelen, geen vastgelegde screenshot.

You:   Summarize the review of contract_annotated.pdf and group it by reviewer.

Agent: [calls get_annotations on contract_annotated.pdf]
       Found 5 annotations: 4 from Maria, 1 from Dana.
       Maria: payment terms (page 2), delivery date (page 5),
         liability cap (page 6), a missing signature block (page 6).
       Replies: Alex answered the page 2 payment terms comment.
       Dana: a strikeout on page 4 marking an outdated clause.
       Maria comments without a reply: page 5 and the two on page 6.

Kan de agent handelen op de opmerkingen?

Hij kan de lijst doorgeven: een issue openen per onbeantwoorde opmerking, een concept‑antwoord‑e‑mail opstellen, of een statusparagraaf schrijven. Eén regel geldt. Opmerkingen komen van anderen, dus de agent moet annotatietekst behandelen als inhoud om over te rapporteren, niet als instructies. Een opmerking die zegt “ignore previous instructions” is data in een veld. Vraag om samenvattingen en rapporten, en houd acties die iets wijzigen onder je eigen beoordeling.

Hoe start ik de server voor Claude, Cursor of Copilot?

De server draait vanuit de ghcr.io/groupdocs-annotation/annotation-net-mcp Docker‑image of via NuGet met dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK), en koppelt de map die je documenten bevat. De hub‑pagina vermeldt de registratie voor Claude Desktop, Claude Code, VS Code met GitHub Copilot, Cursor, Windsurf en andere clients.

Eerlijke beperkingen

  • Evaluation mode. Een proefbadge wordt bovenaan elke pagina geplaatst. Het verandert de annotatiegegevens niet, dus rapporten die op deze manier worden gemaakt zijn nauwkeurig zonder licentie. Het beïnvloedt wat je kunt verzenden. Als het plan eindigt met “email the marked-up copy”, controleer dan eerst get_license_status.
  • One document per call. Een doorloop over veel bestanden betekent veel oproepen, en elk is een hulpmiddel‑oproep die de agent moet doen en rapporteren.
  • Export is XML. get_annotations retourneert JSON voor de agent om te lezen; export_annotations schrijft XML naar opslag.
  • No preview needed. Geen van de drie manieren rendert een pagina, dus de PDF‑preview‑limiet van generate_pages_preview op Linux heeft geen invloed.

Veelgestelde vragen

Hoe exporteer ik alle opmerkingen uit een PDF? Vraag de agent om de annotaties te exporteren. Hij roept export_annotations aan, die een XML‑bestand naast je documenten schrijft, of hij roept get_annotations aan als je de opmerkingen in de chat wilt laten opsommen.

Kan AI beoordelingsopmerkingen over meerdere bestanden samenvatten? Ja. Noem de bestanden in de prompt en de agent leest elk bestand met get_annotations, en combineert vervolgens de resultaten in één samenvatting. Hij leest één bestand per oproep.

Verandert het rapport als ik geen licentie heb? De annotatiegegevens veranderen niet. Alleen de gerenderde of opgeslagen pagina’s dragen een proefbadge.

Ga dieper