Bạn có thể để một AI agent đưa các bình luận đánh giá của nó vào trong tài liệu thay vì trong cửa sổ chat. Máy chủ GroupDocs.Annotation.Mcp cho phép một LLM trong Claude, Cursor hoặc GitHub Copilot thêm các phần tô sáng, ghi chú và gạch ngang vào tệp PDF, Word, Excel hoặc PowerPoint, và nó ghi chúng cục bộ trên máy của bạn:

Highlight the payment clause on page 2 and add a note asking legal to confirm.

Tại sao phản hồi AI trong cửa sổ chat lại bị mất?

Yêu cầu một trợ lý xem xét hợp đồng và bạn nhận được một danh sách: “Điều khoản 4 chuyển đổi trách nhiệm, điều khoản 7 có ngày mở.” Danh sách này tồn tại trong một cuộc trò chuyện. Đồng nghiệp mở hợp đồng vào tuần tới không thấy bất kỳ thông tin nào, và bạn phải sao chép từng điểm trở lại đoạn văn thích hợp bằng tay.

Nguyên nhân không phải là agent. Nó thiếu cách để ghi vào tệp. Một bản đánh giá chỉ hữu ích khi người đọc gặp nó, tức là ngay bên cạnh văn bản mà nó đề cập.

Cách tiếp cận sai trông như thế nào?

Cách giải quyết thường gặp là dán nội dung tài liệu vào chat và yêu cầu nhận xét. Ba vấn đề xảy ra, và bạn có thể kiểm tra từng vấn đề trên một tài liệu của mình:

  • Các bình luận không có vị trí. “Trang 2, đoạn thứ hai” chỉ là mô tả mà bạn phải tự giải quyết.
  • Kết quả là một bản ghi chép, không phải một sản phẩm có thể giao. Không có gì có thể gửi cho người đánh giá tiếp theo ngoại trừ ảnh chụp màn hình hoặc một khối đã dán.
  • Tài liệu không thay đổi, vì vậy việc đánh giá không thể được lọc, đếm hoặc mang sang bản thảo tiếp theo.

Cách tiếp cận đúng: chú thích tài liệu bằng AI agent?

Chia công việc dựa trên thế mạnh của mỗi bên. Agent hiểu chỉ dẫn “đánh dấu mọi thứ làm tăng rủi ro cho chúng tôi”. Engine ghi một chú thích thực sự vào tệp thực. Công cụ thực hiện việc ghi là add_annotation. Nó chấp nhận bảy loại chú thích: textfield, area, point, arrow, highlight, underline và strikeout. Các đối số của nó là tệp, loại, văn bản, số trang bắt đầu từ 1 và tọa độ tài liệu x/y.

Kết quả được lưu dưới dạng <name>_annotated.<ext> cạnh tệp gốc. Tệp gốc không bao giờ bị sửa đổi. Cuộc gọi duy nhất này hoạt động trên hơn 50 định dạng mà engine hỗ trợ, vì vậy một bản thảo Word và một PDF đều được đánh dấu theo cùng một cách.

Công cụ nào giúp việc đặt vị trí chính xác?

Tọa độ là điểm yếu của bất kỳ agent nào không thể nhìn thấy trang, và tài liệu đã nêu rõ điều này. Ba công cụ giảm thiểu việc đoán:

  • get_document_info trả về loại tệp, số trang và kích thước, cùng với chiều rộng và chiều cao của mỗi trang khi engine cung cấp, giúp agent có một “hộp” trang để suy luận.
  • get_annotations trả về các chú thích hiện có cùng với hộp bao quanh chúng, cho phép agent dùng chúng làm mỏ neo.
  • generate_pages_preview tạo hình ảnh của một trang để mô hình có khả năng thị giác có thể xác định vị trí văn bản trước khi chú thích. Hiện tại công cụ này gặp lỗi với tệp PDF trên Linux; xem các giới hạn bên dưới.

Cạm bẫy duy nhất trong chuỗi chú thích?

Mỗi công cụ ghi đều tạo một tệp mới. Một chú thích thứ hai phải được áp dụng lên tệp mà lời gọi đầu tiên đã tạo, không phải lên tệp gốc, nếu không chú thích đầu tiên sẽ bị bỏ lại trong một tệp không ai mở lại. Hãy nói rõ trong lời nhắc:

Highlight the payment clause, then on the resulting file strike out the old delivery date.

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

Đây là một minh hoạ 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:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

Làm sao khởi động máy chủ chú thích trong client AI của tôi?

Để chạy dưới dạng container, gắn thư mục chứa tài liệu của bạn vào /data:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Nếu bạn không muốn dùng container, cài đặt .NET 10 SDK và khởi chạy dnx GroupDocs.Annotation.Mcp --yes; trên Windows đây cũng là kênh để sử dụng xem trước trang PDF. Trang hub có các đoạn mã đăng ký sẵn cho Claude Desktop, Claude Code, VS Code với GitHub Copilot, Cursor, Windsurf và các client khác. Đặt GROUPDOCS_MCP_OUTPUT_PATH thành một thư mục khác với thư mục lưu trữ trước khi thực hiện chuỗi chỉnh sửa trên tệp đã tạo. Với mặc định (đầu ra nằm trong thư mục lưu trữ) lần ghi thứ hai sẽ thất bại với lỗi being used by another process; khi dùng thư mục đầu ra riêng, add_reply, update_annotation và remove_annotations trên tệp đã tạo đều thành công. Với image Docker, truyền -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Sau khi đăng ký, client sẽ tự khởi động server và giao tiếp qua stdio, vì vậy không có gì lắng nghe trên cổng mạng và server không gửi nội dung tài liệu tới dịch vụ đám mây.

Giới hạn thực tế

  • Chế độ đánh giá. Không có giấy phép, một huy hiệu dùng thử sẽ được dán ở đầu mỗi trang, vì vậy đầu ra đã chú thích không thể phân phối. Hãy hỏi “Trạng thái giấy phép của máy chủ chú thích là gì?” trước; agent sẽ gọi get_license_status.
  • Vị trí chỉ là ước lượng nếu không có trợ giúp. Một agent đoán x/y từ lời nhắc sẽ đặt chú thích area hoặc point một cách tương đối. Hãy đọc trước hoặc render trước để có vị trí chính xác.
  • Xem trước trên Linux. generate_pages_preview hiện đang thất bại với tệp PDF trên Linux, bao gồm cả image Docker (TypeInitializationException cho Gdip: System.Drawing.Common không được hỗ trợ trên nền tảng không phải Windows); các tài liệu Word và các tài liệu Office khác vẫn render được, và trên Windows với dnx mọi định dạng đều render. Mười công cụ còn lại không bị ảnh hưởng.

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

Claude có thể thêm bình luận vào PDF không? Có, thông qua một máy chủ MCP cung cấp công cụ chú thích. Với GroupDocs.Annotation.Mcp, agent gọi add_annotation và bình luận được ghi vào <name>_annotated.pdf.

AI có cần tải lên tài liệu của tôi để chú thích không? Không, không qua server: nó mở tệp trong thư mục đã gắn và lưu bản sao đã chú thích cạnh nó. Chỉ những gì mô hình tự nó nhìn thấy, chẳng hạn như văn bản bạn dán hoặc hình ảnh trang mà agent xem, mới được gửi tới nhà cung cấp mô hình.

Công cụ có hoạt động trên Word và Excel, không chỉ PDF? Có. Các loại chú thích giống nhau hoạt động trên PDF, DOCX, XLSX, PPTX và hình ảnh, với hơn 50 định dạng được liệt kê trong tài liệu.

Đi sâu hơn