Giả sử bạn có một thư mục chứa các hợp đồng và cần trang đầu tiên của mỗi hợp đồng, hoặc trang chữ ký, để xem xét. Một AI agent với máy chủ GroupDocs.Merger.Mcp thực hiện việc này trong một lời nhắc, cục bộ trên máy của bạn, từ Claude Desktop, Claude Code, Cursor hoặc VS Code với GitHub Copilot:

Trích xuất trang 1 từ mọi PDF trong thư mục tài liệu của tôi và liệt kê những gì bạn đã tạo ra.

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 extract pages from many documents at once.

Agent thực hiện gì với một thư mục chứa các tệp?

Đối với mỗi tệp, agent gọi công cụ split một lần. Mỗi lần gọi tạo ra một tài liệu một trang. Một thư mục chứa 40 hoá đơn do đó tạo ra 40 trang bìa. Công cụ không có chế độ thư mục; agent cung cấp vòng lặp, và engine thực hiện việc trích xuất trang cho mỗi tệp. Các tệp được xác định bằng tên trong thư mục được cấu hình trong GROUPDOCS_MCP_STORAGE_PATH, vì vậy agent truyền invoice-014.pdf, không phải đường dẫn từ máy của bạn.

Làm sao để giữ các trang đã trích xuất ra khỏi thư mục của các tệp gốc?

Bốn mươi trang đã trích xuất bên cạnh bốn mươi trang gốc tạo thành một thư mục mà không ai có thể duyệt. Đặt GROUPDOCS_MCP_OUTPUT_PATH thành một thư mục riêng, và kết quả sẽ được lưu ở nơi khác so với nguồn. Nếu không đặt, đầu ra sẽ vào thư mục lưu trữ. Đây là cài đặt một lần, và mọi lời nhắc hàng loạt sau đó sẽ gọn gàng.

Làm sao để trích xuất trang cuối cùng, hoặc một trang di chuyển?

“Trang cuối cùng” là một số khác nhau trong mỗi tệp. Hãy để agent gọi get_document_info cho mỗi tài liệu trước. Nó trả về pageCount, vì vậy agent có thể tính số trang cho mỗi tệp:

Đối với mỗi PDF trong thư mục, kiểm tra số lượng trang, sau đó trích xuất trang cuối cùng của mỗi tệp.

Một agent đoán sẽ thất bại trên các tệp mà dự đoán sai. Lỗi xảy ra riêng từng tệp, không gây chết chương trình.

Những biến thể nào xuất hiện thường nhất?

Trích xuất trang cuối cùng của mỗi tài liệu. Kiểm tra số lượng trang trước.

Kéo trang 2 ra khỏi mỗi hợp đồng, sau đó hợp nhất tất cả chúng thành một tệp xem xét.

Đối với mỗi tệp, trích xuất trang chữ ký và đặt kết quả vào thư mục đầu ra.

Lời nhắc thứ hai nối vào merge trong các vòng lên tới bốn tài liệu, cho bạn một tài liệu hợp nhất được xây dựng từ một trang của mỗi nguồn. Hơn bốn nguồn nghĩa là sẽ có nhiều vòng hơn. Lời nhắc trang chữ ký hoạt động khi bạn cho agent biết trang nào chứa chữ ký; công cụ sẽ trích xuất các số trang bạn cung cấp và không tìm kiếm nội dung.

Khi nào một lời nhắc cho mỗi thư mục là kích thước phù hợp?

Sử dụng khi cùng một quy tắc áp dụng cho mọi tệp: trang đầu, trang cuối, một trang chữ ký đã biết. Lời nhắc nêu quy tắc một lần, và agent áp dụng nó cho từng tệp. Công việc lưu trữ và kiểm tra pháp lý phù hợp với dạng này: một trang bìa từ mỗi tệp để lập chỉ mục, hoặc trang chứa chữ ký từ mỗi hợp đồng để kiểm tra. Nếu quy tắc khác nhau cho từng tệp, hãy chia thư mục thành các nhóm và chạy một lời nhắc cho mỗi nhóm, để mỗi lời nhắc vẫn chỉ một quy tắc duy nhất. Giữ lại chỉ dẫn “list what you produced” trong mọi lời nhắc hàng loạt; danh sách là bản ghi của các tệp đã được xử lý.

Phiên làm việc mẫu (rút gọn)

Một minh hoạ dựa trên hành vi công cụ được tài liệu mô tả, không phải một ảnh chụp màn hình thực tế.

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.

Những gì có thể sai trong một lô nhiều tệp?

  • Lỗi xảy ra riêng từng tệp. Một tài liệu bị hỏng hoặc được bảo vệ bằng mật khẩu sẽ thất bại trong lời gọi của nó. Yêu cầu danh sách các lỗi để một lô 40 tệp không che giấu hai lỗi. Công cụ split chấp nhận đối số password cho các tài liệu được bảo vệ.
  • Tài liệu ngắn. Yêu cầu một trang không tồn tại sẽ thất bại cho tệp đó; các tệp khác không bị ảnh hưởng.
  • Sử dụng theo mức đo lường cộng dồn. Dưới giấy phép tính theo mức, mỗi lời gọi đều được tính phí như một lần xử lý.

Giới hạn thực tế

  • Chế độ đánh giá cắt giảm đầu ra hợp nhất xuống 3 trang. Kết quả được cắt giảm chỉ còn 3 trang đầu, với một huy hiệu dùng thử trên mỗi trang. Việc trích xuất các trang đơn lẻ không bị ảnh hưởng, nhưng ngay khi bạn hợp nhất các kết quả, giới hạn này sẽ được áp dụng một cách im lặng. Một tệp xem xét hợp nhất được xây dựng từ bốn mươi trang đầu sẽ chỉ còn ba trang. Kiểm tra get_license_status trước khi chạy.
  • Không tìm kiếm nội dung. Agent chọn các trang dựa trên số. Việc tìm “trang có chữ ký” là chỉ dẫn của bạn, không phải tính năng của công cụ.
  • Không có chế độ thư mục trong công cụ. Một lời gọi split xử lý một tệp, vì vậy một thư mục lớn đồng nghĩa với nhiều lời gọi.

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

Làm sao để trích xuất trang đầu tiên từ tất cả các PDF trong một thư mục? Chỉ định máy chủ tới thư mục, sau đó hỏi: “Trích xuất trang 1 từ mọi PDF trong thư mục tài liệu của tôi và liệt kê những gì bạn đã tạo ra.” Agent sẽ gọi split cho mỗi tệp.

AI có thể tách hàng loạt tài liệu và gom các trang lại thành một tệp không? Có. Sau khi trích xuất, yêu cầu agent hợp nhất các tệp một trang trong các vòng lên tới bốn. Trong chế độ đánh giá, tệp hợp nhất sẽ bị cắt giảm còn 3 trang.

Các tệp có rời khỏi máy của tôi không? Không. Máy chủ đọc và ghi các thư mục bạn cấu hình, qua giao thức stdio cục bộ, mà không có cổng vào nào.

Đi sâu hơn