您可以將「附上顯示問題的頁面」轉換為一個提示。GroupDocs.Viewer.Mcp 伺服器會從 PDF、Word、Excel 或 PowerPoint 檔案中渲染您指定的頁面,並將每個頁面保存為具有可預測檔名的 PNG,存放在本機上,讓 Claude、Cursor 或 GitHub Copilot 能夠產生用於錯誤報告、審閱備註或投影片的圖像:
渲染規格說明書的第 1、4、9 頁,並告訴我檔案所在位置。
步驟說明(含設定與故障排除)請參考文件:如何為報告與工單建立文件的頁面圖像.
為什麼要自動化頁面圖像?
頁面圖像是最廉價的證據。支援工程師會附上顯示錯誤總計的發票頁面;審閱者會將每個變更頁面的縮圖放入審閱備註中;簡報者只需要一張未重新格式化的圖表。若手動完成,這些工作都需要開啟檔案、找到頁面、截圖並命名結果。每個檔案的頁數不同,導致工作無法有效批次處理。
若渲染由真正的引擎完成,而非代理程式模擬,代理程式即可處理重複性工作。引擎會以文件本身的分頁方式進行分頁,並每次產生相同類型的 PNG。
工作流程是什麼?
- 將檔案放在伺服器可存取的位置。 掛載保存文件的資料夾,無論裡面是 PDF 檔還是 Word 檔,都能以相同方式渲染 DOCX 頁面圖像。伺服器會從儲存路徑讀取,並將圖像寫入輸出路徑,您可以使用
GROUPDOCS_MCP_OUTPUT_PATH來分開設定。 - 檢查頁數。 提示語:「規格說明書有多少頁?」 代理程式呼叫
get_view_info並讀取pageCount。這很重要,因為render_page不會拒絕超出文件末端的頁碼。 - 命名頁面。 提示語:「渲染規格說明書的第 1、4、9 頁,並告訴我檔案所在位置。」 代理程式會呼叫
render_page三次,每次對應一頁。 - 收集檔案名稱。 檔案分別為
specification_page1.png、specification_page4.png與specification_page9.png,位於輸出資料夾中。代理程式會回報這些路徑。 - 附加檔案。 若您的客戶端同時連接了問題追蹤或聊天 MCP 伺服器,請求代理程式將檔案附加到工單或訊息。此步驟使用的是其他伺服器的工具,而非本伺服器。
如果您只需要檔案,請說明,讓代理程式不必描述每張圖像:
只儲存圖像;不需要描述它們。
代理程式決定什麼,引擎執行什麼?
| Decision or action | Agent | Engine |
|---|---|---|
| 哪些頁面相關 | 將「含有價格表的頁面」映射為頁碼,於渲染或檢查後 | 無 |
| 頁面是否存在 | 呼叫 get_view_info 並比較 |
回傳 pageCount 與頁面尺寸 |
| 渲染 | 每頁呼叫一次 render_page |
產生 PNG |
| 檔案命名 | 回報已保存的路徑 | 保存為 <source-stem>_page<N>.png |
| 附加至工單 | 使用其他伺服器的工具 | 無 |
範例對話
以下示例基於文件中列出的輸出名稱,並非截圖。
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
如何保持集合規模小?
渲染一次只處理一頁,且每張圖像都會即時回傳給代理程式。要求十頁即代表十次呼叫與十張圖像出現在對話中。請只索取您需要的頁面。一個合理的規則是先根據頁數(以及長文件的目錄頁)挑選要渲染的頁面。
常見用途
- 錯誤報告。 手冊或發票中顯示問題的頁面。
- 文件審閱。 在審閱備註中,每個變更頁面提供一張圖像。
- 投影片。 您想要的單一圖表圖片,且不需重新格式化。
誠實的限制
- 評估模式。 渲染的頁面會帶有評估水印,且伺服器程序最多同時開啟 15 份文件。若圖像要離開您的團隊,請先詢問「Viewer 伺服器是否已授權?」;代理程式會呼叫
get_license_status。 - 每次呼叫僅限一頁。 沒有多頁工具。批次即為一系列呼叫。
- 僅支援 PNG。 格式固定,解析度無法透過工具設定。
- 錯誤的頁碼仍會產生圖像。 只有當文件確實有 12 頁時,名為
_page12.png的檔案才代表第 12 頁。請先檢查頁數。
常見問答
如何使用 AI 代理將 PDF 頁面轉換為圖像? 將 GroupDocs.Viewer.Mcp 伺服器連接至您的客戶端,並以頁碼請求頁面。代理程式呼叫 render_page,PNG 會以 <name>_page<N>.png 的形式保存於輸出資料夾。
如何使用 AI 代理將文件預覽附加到工單? Viewer 伺服器會產生圖像檔案。要附加它需要一個連接至相同客戶端的問題追蹤 MCP 伺服器,該伺服器是獨立的,擁有自己的工具。
我可以在本機產生文件縮圖嗎? 可以。引擎在您機器上的伺服器程序中執行,圖像會寫入您設定的輸出資料夾。
深入了解
- 文件說明,標準操作方式:如何為報告與工單建立文件的頁面圖像
- 文件中心:GroupDocs.Viewer MCP 伺服器文件中心
- 從此開始:多模態代理需要像素,而不僅是文字
- 相關:AI 代理在渲染文件前應提出的 3 個問題
- 相關:答案在圖表中時:AI 代理透過 MCP 閱讀圖表與掃描頁面
- 本地部署與安全模型:AI 文件處理的 3 種架構,以及將檔案保留在內部網路的方案
- 問題:GroupDocs Viewer 論壇
- 原始碼:GitHub 上的 GroupDocs.Viewer.Mcp