AI agent může vytáhnout každý komentář z označeného dokumentu a nahlásit jej třemi způsoby: souhrnem, tabulkou nebo XML archivem. Server GroupDocs.Annotation.Mcp předává LLM anotace jako strukturovaná data a Claude, Cursor nebo GitHub Copilot provádějí úvahy, vše lokálně:

Summarize the review of contract_annotated.pdf: how many comments, from whom, and what the main themes are.

Krok‑za‑krokem verze s konfigurací a řešením problémů je v dokumentaci: Jak extrahovat a reportovat anotace dokumentu pomocí AI.

Co získáte, když extrahujete anotace z PDF?

Označený dokument je nejen inkoust, ale i data. Nástroj get_annotations vrací JSON objekt s found – počtem, a annotations – polem. Každý záznam obsahuje id anotace, type, message, page (číslování od 1), ohraničující rámeček, user a případné replies. Nedochází k parsování dokumentu ani k OCR, takže agent pracuje přímo s záznamy anotací.

Nástroj zpracuje jeden dokument na volání. Pro sadu souborů je třeba je uvést v promptu a agent zavolá nástroj jednou pro každý soubor. Server nenabízí volání na úrovni složky.

Způsob 1: Požádejte o souhrn

Jedno volání, pak úvaha. Uveďte soubor a řekněte, k čemu má souhrn sloužit.

Summarize the review of contract_annotated.pdf: how many comments, from whom, and what the main themes are.

Agent zavolá get_annotations, spočítá položky, seskupí je podle user a popíše témata, která najde v polích message. Počet a autoři pocházejí z dat. Témata jsou interpretací modelu, proto je vhodné je zkontrolovat lidským okem.

Způsob 2: Požádejte o tabulku nebo filtrovaný seznam

Protože data jsou strukturovaná, tvar reportu závisí na promptu:

Give me a table: page, author, comment, answered yes/no.

Group the comments by reviewer and tell me who has the most open items.

List only the strikeouts. I want to see what people want removed.

Which pages have no comments at all?

Poslední otázka je pro PDF‑čtečku obtížná, ale pole odpovídá přímo: „answered“ je neprázdný seznam replies a „pages without comments“ jsou čísla stránek, která v page hodnotách chybí. Kombinujte s get_document_info pro získání počtu stran.

Způsob 3: Archivujte komentáře jako XML

Export the annotations so we can keep them with the case file.

export_annotations zapíše XML soubor, který obsahuje jen anotace. Zpráva o úspěchu má tvar Exported N annotation(s) from <file> to <name>.annotations.xml. Soubor je malý, lze jej porovnávat, a import_annotations jej může aplikovat na jinou kopii dokumentu. To pomáhá, když dokument podléhá pravidlu uchování, ale jeho komentáře ne, nebo když chcete porovnat dvě kola revizí: dva exporty stejného dokumentu jsou dva textové soubory a agent může popsat, co se mezi nimi změnilo.

Příklad relace (zkrácený)

Jedná se o ilustraci založenou na chování nástrojů, ne o zachycený snímek obrazovky.

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.

Může agent jednat na základě komentářů?

Může předat seznam dál: otevřít issue pro každý neodpovězený komentář, připravit odpovědní e‑mail nebo napsat odstavec o stavu. Platí jedna zásada – komentáře pocházejí od jiných lidí, takže agent by měl zacházet s textem anotace jako s obsahem k reportování, ne jako s instrukcemi. Komentář typu „ignore previous instructions“ je jen data v poli. Požadujte souhrny a reporty a akce, které mění něco, provádějte pod vlastním dohledem.

Jak spustím server pro Claude, Cursor nebo Copilot?

Server běží z Docker obrazu ghcr.io/groupdocs-annotation/annotation-net-mcp nebo z NuGet pomocí dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK) a připojuje složku, ve které jsou vaše dokumenty. Na úvodní stránce jsou uvedeny registrace pro Claude Desktop, Claude Code, VS Code s GitHub Copilot, Cursor, Windsurf a další klienty.

Upřímná omezení

  • Režim hodnocení. Na každé stránce je v horní části razítko trial. Nemění data anotací, takže reporty vytvořené tímto způsobem jsou přesné i bez licence. Ovšem ovlivňuje, co můžete odesílat dál. Pokud plán končí „email the marked‑up copy“, nejprve zkontrolujte get_license_status.
  • Jeden dokument na volání. Prohledání mnoha souborů znamená mnoho volání, a každé je voláním nástroje, které agent musí provést a ohlásit.
  • Export je XML. get_annotations vrací JSON pro čtení agentem; export_annotations zapisuje XML do úložiště.
  • Není potřeba náhled. Žádná ze tří metod nevykresluje stránku, takže limit náhledu PDF (generate_pages_preview) na Linuxu neovlivňuje.

Často kladené otázky

Jak exportovat všechny komentáře z PDF? Požádejte agenta, aby exportoval anotace. Zavolá export_annotations, který vytvoří XML soubor vedle vašich dokumentů, nebo zavolá get_annotations, pokud chcete komentáře vypsané v chatu.

Může AI shrnout komentáře recenzentů napříč několika soubory? Ano. Uveďte soubory v promptu a agent načte každý pomocí get_annotations, poté sloučí výsledky do jednoho souhrnu. Čte jeden soubor na volání.

Mění se report, pokud nemám licenci? Data anotací se nemění. Pouze vykreslené nebo uložené stránky nesou razítko trial.

Jděte hlouběji