A document pack,例如董事會資料包、投標資料包或結案文件夾,可以由 AI 代理人在固定順序下,透過單一常駐提示組裝,並在您的機器本地合併檔案。順序來源於檔名,代理人分輪執行合併,您在送出前驗證結果:

將我的 documents 資料夾中的所有 PDF 依檔名順序合併成一個資料包。每次合併四個,將每次的結果串接到下一次呼叫,並告訴我最終檔名。

逐步說明(含設定與故障排除)請參考文件:如何使用 AI 代理人組裝文件資料包

為什麼文件資料包會出錯?

資料包每次的形態相同:固定順序、超過四個部件,以及一個截止日期。失敗的原因也相同:缺少部件、兩個部件位置交換,或最終檔案是由較舊版本的某個章節組成。

如果只告訴代理人「把檔案放在一起」,它必須從您的句子中猜測順序。若給予它可以檢查的排序規則,就不需要猜測。此處的自動化是消除猜測,而不是取代人員。

工作流程是什麼?一步一步說明

  1. 以明顯的方式命名檔案。 使用數字前綴。
  2. 先檢查授權。 向代理人詢問授權狀態。
  3. 分輪執行組裝。 merge 工具每次最多處理四個文件。
  4. 驗證頁數。 將結果與各部件的總頁數比較。
  5. 分別執行轉換、加標記與清理。 其他 MCP 伺服器負責這些工作。

第 1 步:以明顯的方式命名檔案

D:/Storage/Documents/
  00-cover.pdf
  01-summary.pdf
  02-body.pdf
  03-appendix-a.pdf
  04-appendix-b.pdf
  05-annexes.pdf

數字前綴消除您與代理人之間的序列歧義。這就是執行機制:規則寫在資料夾內,提示可以月復一月保持不變。重複執行前,將 GROUPDOCS_MCP_OUTPUT_PATH 設為不同的資料夾。預設情況下,輸出會儲存在 storage 資料夾,因此「我的 documents 資料夾中的每個 PDF」會同時抓到上個月的資料包與每輪的中間結果。

第 2 步:在正式執行前先檢查授權

合併伺服器的授權狀態是什麼?

代理人會呼叫 get_license_status,此方法不接受參數且不會修改任何內容。評估模式下,每次合併的結果會被裁剪至前 3 頁,且每頁都會顯示試用標記,輸出中不會另行說明。

第 3 步:分輪執行組裝

使用上方的常駐提示。對於上述六個檔案,代理人會呼叫 merge 兩次:第一次合併 00‑03 產生中間結果,第二次將該結果與 04、05 合併產生最終資料包。部件越多,輪次就越多。順序遵循槽位順序(file1 先、file4 後),因此串接的輪次會把前一次的結果放在第一個槽位。

第 4 步:驗證頁數

最終資料包有多少頁?

get_document_info 會回傳 pageCount。若有部件遺失,頁數會顯示過低。若部件總頁數很多卻只回傳 3 頁,表示是未授權的合併結果。

第 5 步:分別執行轉換、加標記與清理

並非每個部件都是 PDF,且資料包通常需要除合併外的其他處理。merge 每次只能接受同一格式族的檔案,因此先使用 GroupDocs.Conversion.Mcp 將 Word 章節轉成 PDF。之後可使用同族的其他伺服器為資料包加上浮水印(GroupDocs.Watermark)、簽名(GroupDocs.Signature)或去除中繼資料(GroupDocs.Metadata)。每個功能都是獨立的伺服器,安裝方式相同。若資料包需要數位簽章,請最後才加上:之後的任何變更(包括加浮水印或去除中繼資料)都會使簽章失效。

代理人決定什麼,引擎執行什麼?

步驟 代理人 引擎
選取檔案 列出資料夾並讀取數字前綴 解析 storage 資料夾中的每個名稱
規劃輪次 每次將檔案分成四個一組 無
合併 依槽位順序呼叫 merge 合併文件並儲存結果
串接 把前一次的結果傳入下一次呼叫 與下一批檔案合併
驗證 呼叫 get_document_info 並比較頁數 回傳頁數

引擎永遠不會自行決定順序;它只會遵循給定的槽位。因此命名規則相當重要。

範例對話(節錄)

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

You:   Merge every PDF in my documents folder into one pack, in
       file-name order. Merge four at a time, chaining each result
       into the next call, and tell me the final file name.

Agent: Found 6 PDFs, 00-cover.pdf to 05-annexes.pdf.
       [calls merge: 00-cover, 01-summary, 02-body, 03-appendix-a]
       [calls merge: previous result, 04-appendix-b, 05-annexes]
       The final pack is saved in your output folder. I can check its
       page count against the six parts if you like.

誠實的限制

  • 評估模式會將資料包裁剪至 3 頁。 結果只保留前 3 頁,且每頁都有試用標記。未授權的多部件合併會只回傳三頁且看起來已完成。請先檢查 get_license_status,之後再比較頁數。
  • 每次呼叫最多四個文件。 透過分輪方式繞過此限制;必須要求代理人將結果串接。
  • 每次合併只能使用單一格式族。 先將混合格式的部件轉換成同一格式。
  • 排序規則是一種慣例,而非鎖定。 若檔案命名錯誤,資料包的順序也會錯亂。頁數檢查能發現遺失的部件,但無法偵測交換位置的情況。

常見問答

如何在指定順序下將多個文件合併成一個 PDF? 在檔名加上數字前綴,並請代理人依檔名順序、每次四個地合併。merge 工具會遵守 file1 到 file4 的輸入順序。

AI 代理人能每月自動產生董事會資料包嗎? 能。保持相同的命名慣例,重複使用相同提示,並將 GROUPDOCS_MCP_OUTPUT_PATH 指向獨立資料夾(或先清除前一次的輸出),避免舊資料包被再次合併。每次完成後都驗證頁數。

如果有些部件是 Word 檔案怎麼辦? 先使用 GroupDocs.Conversion.Mcp 轉成 PDF,再進行合併。只要兩個伺服器都已註冊,即可在同一次對話中完成。

深入了解