要使用 AI 代理批次轉換資料夾，將 GroupDocs.Conversion.Mcp 伺服器指向該資料夾，並用一句話描述工作內容。代理會逐一處理檔案，對每個文件呼叫一次轉換引擎，並回報產出結果，全部在 Claude、Cursor 或 GitHub Copilot 本地執行。這是一種由單句驅動的批次處理：

Convert every DOCX in my documents folder to PDF, keep the originals

逐步說明（含設定與除錯）請參考文件：How to batch-convert a folder of documents with an AI agent。本篇文章以簡短會話示範相同工作，從第一個提示到失敗處理。

從哪裡開始：儲存資料夾還是提示？

先設定儲存資料夾。批次工作成敗取決於資料夾對映，而對映只需在伺服器條目中設定一次，無需在每個提示中重複。以下兩個環境變數負責此設定：

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH 為代理可讀取的資料夾。GROUPDOCS_MCP_OUTPUT_PATH 為轉換後檔案的輸出位置。兩者皆設定後，來源資料夾保持不變，所有結果皆寫入 converted。這是批次作業最乾淨的布局。dnx 指令需要 .NET 10 SDK；Docker 映像 ghcr.io/groupdocs-conversion/conversion-net-mcp:latest 會將資料夾掛載為 /data。註冊伺服器後，請重新啟動 Claude Desktop、Claude Code、VS Code 或 Cursor。

第一個提示做什麼？

先給代理一個簡單的指令：

Convert everything in this folder from DOCX to PDF.

代理會列舉資料夾內的檔案，並對每個檔案呼叫 convert 工具，參數 format: "pdf"。每次呼叫會取得儲存中的檔名，並回傳已儲存的檔名。執行兩次時，第二次會在第一批檔案旁產生新名稱的檔案。

如何新增過濾條件或規則？

提示本身即是編排層。過濾、排序與錯誤政策皆以自然語言描述：

Turn all the PDFs into Markdown; skip files that are already converted.

Convert the invoices to PDF/A for archiving, and list any file that failed.

Make PNG previews of every presentation.

若需排序，代理可以先呼叫 get_document_info，此指令會回傳檔案類型、頁數與基本屬性，且不會執行轉換：

Check the page count of each PDF first, and only convert the ones with more than 10 pages.

「頁數大於 10」的判斷由代理自行完成，實際轉換仍交由引擎執行。

當某個檔案失敗時會發生什麼？

若引擎無法轉換檔案（例如來源格式不支援或密碼錯誤），該檔案的回應文字會以操作名稱與失敗原因開頭。若檔名不存在，回應會列出伺服器可見的檔案清單，讓代理自行修正。對於受保護的檔案，convert 允許傳入可選的 password 參數。

因此失敗政策應寫入提示中，例如「list any file that failed」會在執行結束時要求代理提供失敗報告，避免錯過失敗項目。閱讀報告後，可只重新執行失敗的檔案。

範例會話

以下為簡化示意會話。檔名為虛構，回覆根據文件化行為而非螢幕截圖構建。

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

如何追蹤大型資料夾的進度？

代理通常會逐一處理檔案，執行時間會隨檔案數量與大小線性增長。若需進度回報，可在提示中加入要求，例如「tell me after every ten files」或「summarize at the end」。數百份文件仍能順利執行，最終報告會說明全部結果。建議先在小範圍資料的副本上測試，目視檢查兩三個輸出，確認無誤後再對整個資料夾執行。

如果批次必須無人值守該怎麼辦？

代理會話需要有人啟動。若要排程自動化，可參考 n8n walkthrough 內示範的工作流程工具，讓其驅動同一伺服器；亦可透過 GroupDocs.Conversion .NET 程式庫以腳本方式呼叫引擎。對於需要即時檢視報告的臨時批次，仍可使用聊天介面。

限制是什麼？

  • 評估模式限制批次最多 15 份文件。 未授權時，單一伺服器程序最多同時開啟 15 份文件，且輸出會帶有評估水印。超過後的呼叫會失敗，直至伺服器重新啟動。可在開始正式批次前使用 get_license_status 檢查模式，或詢問「what is the license status of the conversion server?」。
  • 計量授權需要外部連線。 使用計量金鑰時，使用情況會回報至 GroupDocs 伺服器，因此防火牆內的機器應改用授權檔案。文件內容永不會上傳。
  • 掃描檔仍為影像。 OCR 功能不在伺服器內，僅含影像的 PDF 批次不會自動產生文字層。

常見問題

如何使用 AI 將資料夾內所有 DOCX 轉成 PDF？
先設定儲存資料夾，然後以一句話向代理下指令。代理會透過本機伺服器逐一轉換檔案，且不會上傳任何資料。

AI 代理能在本機處理整個資料夾嗎？
可以。代理與轉換伺服器皆在您的電腦上執行，檔案的讀寫皆發生在您自己的資料夾中。

自動化文件轉換流程的最佳方式是？
對於需要人工審核的臨時批次，使用聊天介面即可。若要排程執行，請使用工作流程工具（如 n8n）或直接以 .NET 程式庫撰寫腳本。

深入了解