Bạn có thể chuyển “đính kèm trang hiển thị vấn đề” thành một lời nhắc. Máy chủ GroupDocs.Viewer.Mcp render các trang bạn chỉ định từ tệp PDF, Word, Excel hoặc PowerPoint và lưu mỗi trang dưới dạng PNG với tên tệp có thể dự đoán được, cục bộ trên máy của bạn, để Claude, Cursor hoặc GitHub Copilot có thể tạo ra các hình ảnh cho báo cáo lỗi, ghi chú đánh giá hoặc slide:

Trình bày các trang 1, 4 và 9 của tài liệu và cho tôi biết các tệp nằm ở đâu.

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: Cách tạo hình ảnh trang của tài liệu cho báo cáo và phiếu hỗ trợ.

Tại sao lại tự động hoá hình ảnh trang?

Hình ảnh trang là bằng chứng rẻ nhất hiện có. Một kỹ sư hỗ trợ đính kèm trang hoá đơn hiển thị tổng sai; một người đánh giá thả một hình thu nhỏ của mỗi trang đã thay đổi vào ghi chú đánh giá; một người thuyết trình cần một sơ đồ, không được định dạng lại. Thực hiện thủ công, mỗi việc này đều đòi hỏi mở tệp, tìm trang, chụp ảnh màn hình và đặt tên cho kết quả. Số trang khác nhau tùy từng tệp, vì vậy công việc không bao giờ có thể gộp thành lô.

Một agent có thể thực hiện phần lặp lại nếu việc render được thực hiện bởi một engine thực sự thay vì agent mô phỏng. Engine phân trang tài liệu theo cách tài liệu được phân trang và tạo ra cùng loại PNG mỗi lần.

Quy trình làm việc

  1. Đặt các tệp ở nơi máy chủ có thể truy cập chúng. Gắn (mount) thư mục chứa các tài liệu, dù nó chứa các tệp PDF hay Word, để việc render hình ảnh trang DOCX hoạt động theo cùng cách. Máy chủ đọc từ đường dẫn lưu trữ và ghi các hình ảnh vào đường dẫn đầu ra, mà bạn có thể giữ riêng bằng GROUPDOCS_MCP_OUTPUT_PATH.
  2. Kiểm tra số trang. Lời nhắc: “Tài liệu có bao nhiêu trang?” Agent gọi get_view_info và đọc pageCount. Điều này quan trọng vì render_page không từ chối một số trang vượt quá cuối tài liệu.
  3. Đặt tên cho các trang. Lời nhắc: “Trình bày các trang 1, 4 và 9 của tài liệu và cho tôi biết các tệp nằm ở đâu.” Agent gọi render_page ba lần, một lần cho mỗi trang.
  4. Thu thập tên tệp. Các tệp là specification_page1.png, specification_page4.png và specification_page9.png, trong thư mục đầu ra. Agent báo cáo các đường dẫn.
  5. Đính kèm chúng. Nếu khách hàng của bạn cũng có một issue‑tracker hoặc máy chủ chat MCP được kết nối, yêu cầu agent đính kèm các tệp vào phiếu hỗ trợ hoặc tin nhắn. Bước đó sử dụng công cụ của máy chủ khác, không phải máy chủ này.

Nếu bạn chỉ muốn các tệp, hãy nói rõ, để agent không mô tả từng hình ảnh:

Chỉ lưu các hình ảnh; bạn không cần mô tả chúng.

Agent quyết định gì, và engine làm gì?

Quyết định hoặc hành động Agent Engine
Các trang nào có liên quan Ánh xạ “các trang có bảng giá” thành số trang, sau khi render hoặc kiểm tra Không có gì
Trang có tồn tại hay không Gọi get_view_info và so sánh Trả về pageCount và kích thước trang
Render Gọi render_page một lần cho mỗi trang Tạo PNG
Đặt tên tệp Báo cáo đường dẫn đã lưu Lưu dưới dạng <source-stem>_page<N>.png
Đính kèm vào phiếu hỗ trợ Sử dụng công cụ của máy chủ khác Không có gì

Phiên làm việc mẫu

Một minh họa dựa trên các tên đầu ra đã được ghi lại, không phải một ảnh chụp màn hình thực tế.

You:   Render pages 1, 4, and 9 of the specification and tell me where
       the files are. Just save the images; no need to describe them.

Agent: [calls render_page for page 1, page 4 and page 9]
       Saved:
         <output folder>/specification_page1.png
         <output folder>/specification_page4.png
         <output folder>/specification_page9.png

Làm sao để giữ tập hợp nhỏ?

Việc render là một trang cho mỗi lần gọi, và mỗi hình ảnh cũng được trả lại cho agent trong dòng. Yêu cầu mười trang đồng nghĩa với mười lần gọi và mười hình ảnh trong cuộc trò chuyện. Yêu cầu chỉ những trang bạn cần. Một quy tắc hợp lý là chọn các trang trước khi render, dựa trên số trang và, đối với tài liệu dài, trang mục lục.

Các trường hợp sử dụng phổ biến

  • Báo cáo lỗi. Trang của tài liệu hướng dẫn hoặc hoá đơn hiển thị vấn đề.
  • Đánh giá tài liệu. Một hình ảnh cho mỗi trang đã thay đổi trong ghi chú đánh giá.
  • Slide. Một bức ảnh của sơ đồ bạn muốn, mà không cần định dạng lại.

Giới hạn thực tế

  • Chế độ đánh giá. Các trang đã render có chứa watermark đánh giá, và một tiến trình máy chủ mở tối đa 15 tài liệu. Nếu các hình ảnh ra khỏi đội của bạn, hãy hỏi “Máy chủ Viewer có được cấp phép không?” trước, để agent gọi get_license_status.
  • Một trang cho mỗi lần gọi. Không có công cụ đa trang. Một lô là một chuỗi các lần gọi.
  • Chỉ PNG. Định dạng cố định; độ phân giải không phải là tham số bạn có thể đặt qua công cụ.
  • Số trang sai vẫn tạo ra hình ảnh. Một tệp có tên _page12.png chỉ là trang 12 nếu tài liệu có 12 trang. Hãy kiểm tra số lượng trang trước.

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

Làm sao tôi chuyển một trang PDF thành hình ảnh bằng agent AI? Kết nối máy chủ GroupDocs.Viewer.Mcp với client của bạn và yêu cầu trang theo số. Agent gọi render_page và PNG được lưu trong thư mục đầu ra dưới dạng <name>_page<N>.png.

Làm sao tôi đính kèm bản xem trước tài liệu vào phiếu hỗ trợ bằng agent AI? Máy chủ Viewer tạo ra tệp hình ảnh. Việc đính kèm cần một máy chủ issue‑tracker MCP được kết nối với cùng client, là một máy chủ riêng với công cụ của nó.

Tôi có thể tạo thumbnail tài liệu cục bộ không? Có. Engine chạy trong tiến trình máy chủ trên máy của bạn, và các hình ảnh được ghi vào thư mục đầu ra mà bạn cấu hình.

Đi sâu hơn