假設你有一個合約資料夾，需要每份合約的首頁或簽名頁以供審查。使用搭載 GroupDocs.Merger.Mcp 伺服器的 AI 代理，只需一個提示，即可在本機上完成，無論是透過 Claude Desktop、Claude Code、Cursor 或是搭配 GitHub Copilot 的 VS Code：

從我的文件資料夾中的每個 PDF 提取第 1 頁，並列出你產生的內容。

一步一步的設定與故障排除說明請參考文件：一次性從多個文件中提取頁面

代理在處理檔案資料夾時會做什麼？

對每個檔案，代理會呼叫一次 split 工具。每次呼叫會產生一個單頁文件。40 份發票的資料夾因此會產生 40 個封面頁。此工具沒有資料夾模式；代理負責迴圈，引擎則為每個檔案執行頁面提取。檔案會以 GROUPDOCS_MCP_STORAGE_PATH 中設定的資料夾內的名稱來解析，因此代理傳遞的是 invoice-014.pdf，而不是你機器上的完整路徑。

如何避免將提取的頁面放在原始檔案的資料夾中？

四十個提取頁面與四十個原始檔案混在一起會讓資料夾難以瀏覽。將 GROUPDOCS_MCP_OUTPUT_PATH 設為另一個目錄，結果就會存放在來源之外。若不設定，輸出會寫入儲存資料夾。這是一次性設定，之後的每一次批次提示都會保持整潔。

如何提取最後一頁，或是會變動的頁面？

「最後一頁」在每個檔案中都是不同的頁碼。先讓代理對每個文件呼叫 get_document_info。它會回傳 pageCount，代理即可依檔案計算出正確的頁碼：

對資料夾中的每個 PDF，先檢查頁數，然後提取每份文件的最後一頁。

若代理自行猜測頁碼，當猜錯時只會在該檔案產生錯誤，錯誤僅限於單一檔案，並不會導致整體失敗。

最常見的變化有哪些？

提取每份文件的最後一頁。先檢查頁數。

從每份合約中抽出第 2 頁，然後將所有抽出的頁面合併成一個審查檔案。

對每個檔案提取簽名頁，並將結果放入輸出資料夾。

第二個提示會在每輪最多四份文件的情況下呼叫 merge，從每個來源抽取一頁，最終得到一個由單頁組成的合併文件。超過四個來源時會分多輪進行。簽名頁提示在你告訴代理哪一頁是簽名頁時有效；工具只會提取你指定的頁碼，並不會自行搜尋內容。

什麼時候每個資料夾只需要一個提示？

當同一規則適用於所有檔案時：首頁、最後一頁、已知的簽名頁。提示只需說明一次規則，代理會逐檔套用。檔案存檔與法律審查的工作常符合此模式：為每個檔案取得封面以建立索引，或取得每份合約的簽名頁以進行核對。若規則因檔案而異，請將資料夾分成多個群組，對每個群組執行一次提示，讓每次提示仍只包含單一規則。務必在每個批次提示中保留「列出你產生的內容」指令，列表即是你處理過哪些檔案的紀錄。

範例會話（節錄）

基於文件中工具行為的示意，非實際截圖。

You:   Extract page 1 from every PDF in my documents folder and
       list what you produced.

Agent: Found 3 PDFs in the folder.
       [calls split on each file with pages = "1"]
       Extracted page 1 from all 3 files: 3 single-page documents
       in your output folder. No failures.

大量檔案批次中可能出現的問題？

  • 失敗是針對單一檔案。 損毀或受密碼保護的文件只會失敗該次呼叫。請要求以列表形式回報失敗，避免在 40 份檔案的批次中隱藏兩個錯誤。split 工具接受 password 參數以處理受保護的文件。
  • 文件過短。 要求不存在的頁面會在該檔案失敗；其他檔案不受影響。
  • 計量使用會累積。 在計量授權模式下，每一次呼叫都會被計費。

誠實的限制

  • 評估模式會將合併輸出裁剪至 3 頁。 結果會被裁減為前 3 頁，且每頁都會顯示試用標記。單頁提取不受影響，但一旦合併結果，限制會悄悄生效。執行前請先呼叫 get_license_status 檢查。
  • 不支援內容搜尋。 代理只能依頁碼挑選頁面。要「找到簽名所在的頁面」必須由使用者指示，而非工具功能。
  • 工具本身沒有資料夾模式。 每一次 split 呼叫只能處理一個檔案，因此大型資料夾會產生大量呼叫。

FAQ

如何從資料夾中的所有 PDF 提取首頁？ 將伺服器指向該資料夾，然後詢問：「從我的文件資料夾中的每個 PDF 提取第 1 頁，並列出你產生的內容。」代理會對每個檔案呼叫 split。

AI 能否批次分割文件並將頁面收集到同一個檔案中？ 能。提取完畢後，請求代理以每四份文件為一輪合併單頁文件。於評估模式下，合併檔案會被裁剪至 3 頁。

檔案會離開我的機器嗎？ 不會。伺服器只會讀寫你在設定中指定的資料夾，透過本機 stdio 傳輸，沒有任何入站埠口。

深入了解