AI 代理可以從已標註的文件中提取所有評論，並以三種方式報告：摘要、表格或 XML 檔案。GroupDocs.Annotation.Mcp 伺服器將註解以結構化資料傳遞給大型語言模型，而 Claude、Cursor 或 GitHub Copilot 在本機執行推理。

總結 contract_annotated.pdf 的審閱：有多少條評論、來自誰，以及主要主題是什麼。

如何使用 AI 提取並報告文件註解

從 PDF 中提取註解會得到什麼？

已標註的文件同時是資料也是墨跡。get_annotations 工具會回傳一個 JSON 物件，包含 found（計數）與 annotations（陣列）。每個條目包含註解的 id、type、message、page（以 1 為起點）、邊界框、user 以及任何 replies。此過程不涉及文件解析或 OCR，因此代理直接從註解記錄本身工作。

此工具每次呼叫只能處理一份文件。若要覆蓋多個檔案，請在提示中列出它們，代理會對每個檔案各呼叫一次工具。伺服器不提供資料夾層級的呼叫。

方式 1：請求摘要

一次呼叫，然後推理。說明檔案名稱並說明摘要的用途。

總結 contract_annotated.pdf 的審閱：有多少條評論、來自誰，以及主要主題是什麼。

代理呼叫 get_annotations，計算條目數量，依 user 分組，並描述在 message 欄位中發現的主題。計數與作者資訊來自資料本身。主題則是模型對文字的解讀，仍建議人工檢視。

方式 2：請求表格或過濾清單

因為資料已結構化，報告的形態取決於提示內容：

給我一個表格：頁碼、作者、評論、是否已回覆。

將評論依審閱者分組，告訴我誰有最多未解決的項目。

僅列出刪除線的評論。我想看到人們想要移除的內容。

哪些頁面完全沒有評論？

最後一個問題是 PDF 閱讀器通常回答不佳，而陣列可以直接給出答案：「已回覆」指的是非空的 replies 清單，「沒有評論的頁面」則是 page 值中缺少的頁碼。可搭配 get_document_info 取得總頁數。

方式 3：將評論存檔為 XML

匯出註解，以便我們能將它們與案件檔案一起保存。

export_annotations 會寫入僅包含註解的 XML 檔案。成功訊息的格式為 Exported N annotation(s) from <file> to <name>.annotations.xml。此檔案體積小且可進行差異比較，import_annotations 則可將其套用到文件的另一個副本。當文件受保存規則限制而註解不受限制，或想比較兩輪審閱時，此功能特別有用：同一文件的兩次匯出會產生兩個文字檔，代理可以說明它們之間的變化。

範例會話（節錄）

這是一個根據工具文件化行為所構建的示意，並非截圖。

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.

代理可以對評論執行操作嗎？

它可以將清單傳遞下去：為每條未回覆的評論開啟一個議題、草擬回覆電子郵件，或撰寫狀態段落。唯一的規則是：評論來自他人，代理應將註解文字視為報告內容，而非指令。包含「忽略先前指示」的評論僅是欄位中的資料。請求摘要與報告，並將任何變更行動保留在您自行審核之下。

如何為 Claude、Cursor 或 Copilot 執行伺服器？

伺服器可透過 ghcr.io/groupdocs-annotation/annotation-net-mcp Docker 映像或使用 NuGet 搭配 dnx GroupDocs.Annotation.Mcp --yes（.NET 10 SDK）執行，並掛載保存文件的資料夾。中心頁面列出了 Claude Desktop、Claude Code、搭配 GitHub Copilot 的 VS Code、Cursor、Windsurf 以及其他客戶端的註冊方式。

誠實的限制

  • Evaluation mode. 每頁頂部會蓋上試用徽章。此徽章不會改變註解資料，因此以此方式產生的報告在未取得授權的情況下仍然正確。它會影響您可以傳送的內容。若計畫以「電郵已標註的副本」結束，請先檢查 get_license_status。
  • One document per call. 若要掃描多個檔案，需要多次呼叫，每一次都是代理必須執行並回報的工具呼叫。
  • Export is XML. get_annotations 以 JSON 回傳供代理閱讀；export_annotations 則將 XML 寫入儲存空間。
  • No preview needed. 這三種方式皆不會渲染頁面，因此 Linux 上 generate_pages_preview 的 PDF 預覽限制不會影響它們。

常見問題

如何匯出 PDF 中的所有評論？
請求代理匯出註解。它會呼叫 export_annotations，在您的文件旁寫入 XML 檔案；若您想在聊天中列出評論，則可呼叫 get_annotations。

AI 能否彙總多個檔案的審閱者評論？
可以。只要在提示中列出檔案名稱，代理會對每個檔案呼叫 get_annotations，然後將結果合併成一個摘要。每次仍只處理一個檔案。

若我沒有授權，報告會改變嗎？
註解資料本身不會改變。只有已渲染或已儲存的頁面會帶有試用徽章。

深入了解