Để chuyển đổi hàng loạt một thư mục bằng một tác nhân AI, hãy chỉ định máy chủ GroupDocs.Conversion.Mcp tới thư mục và mô tả công việc trong một câu. Tác nhân sẽ duyệt qua các tệp, gọi công cụ chuyển đổi một lần cho mỗi tài liệu và báo cáo những gì nó đã tạo, toàn bộ diễn ra cục bộ trong Claude, Cursor hoặc GitHub Copilot. Đây là quá trình xử lý hàng loạt dựa trên một câu:

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

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: How to batch-convert a folder of documents with an AI agent. Bài viết này hướng dẫn cùng một công việc trong một phiên ngắn, từ lời nhắc đầu tiên đến cách xử lý lỗi.

Bạn bắt đầu từ đâu: thư mục lưu trữ hay lời nhắc?

Bắt đầu với thư mục lưu trữ. Một công việc batch thành công hay thất bại phụ thuộc vào việc ánh xạ thư mục, và ánh xạ này được thiết lập một lần trong mục nhập máy chủ, không phải trong mỗi lời nhắc. Hai biến môi trường kiểm soát nó:

{
  "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 là thư mục mà tác nhân có thể đọc. GROUPDOCS_MCP_OUTPUT_PATH là nơi các tệp đã chuyển đổi sẽ được lưu. Khi cả hai được đặt, thư mục nguồn vẫn không bị chạm vào và mọi kết quả đều vào converted. Đây là cách bố trí sạch sẽ nhất cho một batch. Lệnh dnx yêu cầu .NET 10 SDK; hình ảnh Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest sẽ gắn thư mục dưới dạng /data. Khởi động lại Claude Desktop, Claude Code, VS Code hoặc Cursor sau khi bạn đăng ký máy chủ.

Lời nhắc đầu tiên làm gì?

Cung cấp cho tác nhân trường hợp đơn giản trước:

Convert everything in this folder from DOCX to PDF.

Tác nhân sẽ liệt kê thư mục và gọi công cụ convert cho mỗi tệp với format: "pdf". Mỗi lần gọi nhận một tên tệp từ lưu trữ và trả về tên tệp đã lưu. Chạy hai lần và lần chạy thứ hai sẽ tạo các tệp mới, có tên khác, nằm cạnh các tệp đầu tiên.

Làm sao để thêm bộ lọc hoặc quy tắc?

Lời nhắc là lớp điều phối. Việc lọc, sắp xếp và chính sách lỗi được diễn đạt bằng ngôn ngữ tự nhiên:

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.

Đối với việc sắp xếp, tác nhân có thể gọi get_document_info trước, hàm này trả về loại tệp, số trang và các thuộc tính cơ bản mà không cần chuyển đổi:

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

Quyết định “hơn 10 trang” do tác nhân đưa ra. Việc chuyển đổi vẫn do engine thực hiện.

Điều gì xảy ra khi một tệp thất bại?

Khi engine không thể chuyển đổi một tệp (ví dụ vì định dạng nguồn không được hỗ trợ hoặc mật khẩu sai), văn bản phản hồi cho tệp đó sẽ bắt đầu bằng thao tác và lý do. Một tên tệp không tồn tại sẽ trả về danh sách các tệp mà máy chủ có thể thấy để tác nhân tự sửa. Đối với tệp được bảo vệ, convert chấp nhận tham số tùy chọn password.

Vì vậy, chính sách thất bại nên được đưa vào lời nhắc: “list any file that failed” yêu cầu tác nhân cung cấp báo cáo vào cuối quá trình, để lỗi không bị bỏ qua. Đọc báo cáo và chạy lại chỉ những tệp thất bại.

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

Đây là một phiên ngắn gọn, mang tính minh họa. Các tên tệp được tạo ra và phản hồi dựa trên hành vi đã được tài liệu mô tả, không phải ảnh chụp màn hình.

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).

Làm sao theo dõi tiến độ khi xử lý một thư mục lớn?

Tác nhân thường xử lý các tệp lần lượt, vì vậy thời gian chạy tăng theo số lượng và kích thước tệp. Để báo cáo tiến độ, hãy yêu cầu trong lời nhắc: “tell me after every ten files” hoặc “summarize at the end”. Vài trăm tài liệu vẫn hoạt động tốt, và báo cáo cuối cùng sẽ cho bạn biết những gì đã xảy ra. Bắt đầu với một bản sao của một tập con nhỏ, kiểm tra hai hoặc ba kết quả bằng mắt, sau đó chạy toàn bộ thư mục.

Nếu batch phải chạy không có người giám sát thì sao?

Một phiên tác nhân cần một người khởi động. Đối với các pipeline được lên lịch, hướng dẫn n8n walkthrough trình bày cách một công cụ workflow điều khiển cùng máy chủ, và engine cũng có thể được lập trình thông qua thư viện GroupDocs.Conversion .NET. Sử dụng chat cho các batch ngẫu nhiên khi bạn muốn đọc báo cáo.

Những giới hạn là gì?

  • Chế độ đánh giá giới hạn batch ở 15 tài liệu. Không có giấy phép, một tiến trình máy chủ tối đa mở 15 tài liệu và đầu ra sẽ có watermark đánh giá. Sau đó, các lời gọi tiếp theo sẽ thất bại cho đến khi máy chủ khởi động lại. Kiểm tra chế độ bằng get_license_status trước khi bắt đầu batch thực tế, hoặc hỏi “what is the license status of the conversion server?”.
  • Giấy phép tính theo mức cần truy cập ra ngoài. Với khóa tính theo mức, việc sử dụng được báo cáo tới máy chủ GroupDocs, vì vậy máy tính nằm sau tường lửa nên nên dùng file giấy phép. Nội dung tài liệu không bao giờ được gửi.
  • Các tệp quét vẫn là hình ảnh. OCR không có trong máy chủ, vì vậy một batch PDF chỉ chứa hình ảnh sẽ không có lớp văn bản.

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

Làm sao tôi chuyển đổi tất cả các tệp DOCX trong một thư mục sang PDF bằng AI?
Đặt thư mục lưu trữ, sau đó yêu cầu tác nhân của bạn thực hiện đúng yêu cầu trong một câu. Nó sẽ chuyển đổi các tệp từng cái một qua máy chủ cục bộ và không tải lên bất kỳ dữ liệu nào.

Một tác nhân AI có thể xử lý toàn bộ thư mục cục bộ không?
Có. Cả tác nhân và máy chủ chuyển đổi đều chạy trên máy của bạn, các tệp được đọc và ghi vào các thư mục của bạn.

Cách tốt nhất để tự động hoá quy trình chuyển đổi tài liệu là gì?
Sử dụng chat cho các batch ngẫu nhiên mà bạn muốn xem lại. Đối với pipeline chạy theo lịch, điều khiển cùng máy chủ từ công cụ workflow như n8n, hoặc viết script bằng thư viện .NET.

Đi sâu hơn