Một tác nhân AI có thể lấy mọi bình luận ra khỏi tài liệu đã được chú thích và báo cáo chúng theo ba cách: tóm tắt, bảng hoặc lưu trữ XML. Máy chủ GroupDocs.Annotation.Mcp cung cấp các chú thích cho LLM dưới dạng dữ liệu có cấu trúc, và Claude, Cursor hoặc GitHub Copilot thực hiện việc suy luận, tất cả đều chạy cục bộ:

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

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: How to extract and report on document annotations with AI.

Bạn nhận được gì khi trích xuất chú thích từ một tệp PDF?

Một tài liệu đã được chú thích vừa là dữ liệu vừa là mực. Công cụ get_annotations trả về một đối tượng JSON với found (số lượng) và annotations (một mảng). Mỗi mục chứa id, type, message, page (đánh số bắt đầu từ 1), hộp bao, user và bất kỳ replies nào. Không có việc phân tích tài liệu và không có OCR liên quan, vì vậy tác nhân làm việc trực tiếp từ các bản ghi chú thích.

Công cụ nhận một tài liệu cho mỗi lần gọi. Để bao phủ một tập hợp các tệp, hãy liệt kê chúng trong lời nhắc và tác nhân sẽ gọi công cụ một lần cho mỗi tệp. Máy chủ không hỗ trợ gọi ở mức thư mục.

Cách 1: Yêu cầu một bản tóm tắt

Một lần gọi, sau đó suy luận. Đặt tên tệp và nói mục đích của bản tóm tắt.

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

Tác nhân gọi get_annotations, đếm các mục, nhóm chúng theo user và mô tả các chủ đề mà nó tìm thấy trong các trường message. Số lượng và tác giả được lấy từ dữ liệu. Các chủ đề là cách mô hình đọc văn bản, vì vậy chúng cần được con người xem xét lại.

Cách 2: Yêu cầu một bảng hoặc danh sách đã lọc

Vì dữ liệu có cấu trúc, hình dạng của báo cáo phụ thuộc vào lời nhắc:

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?

Câu hỏi cuối cùng là một câu mà các trình đọc PDF thường trả lời kém, trong khi một mảng trả lời trực tiếp: “answered” là danh sách replies không rỗng, và “pages without comments” là các số trang không xuất hiện trong giá trị page. Kết hợp với get_document_info để biết tổng số trang.

Cách 3: Lưu trữ các bình luận dưới dạng XML

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

export_annotations ghi một tệp XML chỉ chứa các chú thích. Thông báo thành công của nó có dạng Exported N annotation(s) from <file> to <name>.annotations.xml. Tệp này nhỏ gọn và có thể so sánh diff, và import_annotations có thể áp dụng nó cho một bản sao khác của tài liệu. Điều này hữu ích khi tài liệu nằm dưới quy tắc lưu trữ mà các bình luận không, hoặc khi bạn muốn so sánh hai vòng đánh giá: hai lần xuất cùng một tài liệu sẽ tạo ra hai tệp văn bản, và tác nhân có thể mô tả những gì đã thay đổi giữa chúng.

Phiên làm việc mẫu (rút gọn)

Đây là một minh hoạ được xây dựng dựa trên hành vi được tài liệu mô tả của các công cụ, không phải một ảnh chụp màn hình thực tế.

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.

Tác nhân có thể thực hiện hành động trên các bình luận không?

Nó có thể chuyển danh sách sang các công cụ khác: mở một issue cho mỗi bình luận chưa trả lời, soạn email trả lời, hoặc viết một đoạn trạng thái. Một quy tắc áp dụng: các bình luận đến từ người khác, vì vậy tác nhân nên xem văn bản chú thích như nội dung để báo cáo, không phải như hướng dẫn. Một bình luận nói “ignore previous instructions” chỉ là dữ liệu trong một trường. Hãy yêu cầu tóm tắt và báo cáo, và giữ các hành động thay đổi gì đó dưới sự xem xét của bạn.

Làm thế nào để chạy máy chủ cho Claude, Cursor hoặc Copilot?

Máy chủ chạy từ hình ảnh Docker ghcr.io/groupdocs-annotation/annotation-net-mcp hoặc từ NuGet với dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK), và gắn kết thư mục chứa tài liệu của bạn. Trang trung tâm liệt kê các đăng ký cho Claude Desktop, Claude Code, VS Code với GitHub Copilot, Cursor, Windsurf và các khách hàng khác.

Giới hạn thực tế

  • Chế độ đánh giá. Một huy hiệu dùng thử được dán ở đầu mỗi trang. Nó không thay đổi dữ liệu chú thích, vì vậy các báo cáo được tạo theo cách này vẫn chính xác mà không cần giấy phép. Nó ảnh hưởng đến những gì bạn có thể gửi đi. Nếu kế hoạch kết thúc bằng “email the marked-up copy”, hãy kiểm tra get_license_status trước.
  • Một tài liệu mỗi lần gọi. Việc quét nhiều tệp đồng nghĩa với nhiều lần gọi, và mỗi lần là một lời gọi công cụ mà tác nhân phải thực hiện và báo cáo.
  • Xuất ra là XML. get_annotations trả về JSON để tác nhân đọc; export_annotations ghi XML vào bộ nhớ lưu trữ.
  • Không cần xem trước. Ba cách này đều không render trang, vì vậy giới hạn xem trước PDF của generate_pages_preview trên Linux không ảnh hưởng đến chúng.

Câu hỏi thường gặp

Làm sao để xuất tất cả bình luận từ một PDF? Yêu cầu tác nhân xuất các chú thích. Nó sẽ gọi export_annotations, ghi một tệp XML bên cạnh tài liệu của bạn, hoặc gọi get_annotations nếu bạn muốn các bình luận được liệt kê trong cuộc trò chuyện.

AI có thể tóm tắt bình luận của người đánh giá trên nhiều tệp không? Có. Đặt tên các tệp trong lời nhắc và tác nhân sẽ đọc từng tệp bằng get_annotations, sau đó kết hợp kết quả thành một bản tóm tắt. Nó đọc một tệp cho mỗi lần gọi.

Báo cáo có thay đổi nếu tôi không có giấy phép không? Dữ liệu chú thích không thay đổi. Chỉ các trang được render hoặc lưu sẽ có huy hiệu dùng thử.

Đi sâu hơn