Hãy tưởng tượng một hộp thư đến chứa các hoá đơn đã quét, trong đó mỗi trang có một mã vạch ghi tên đơn đặt hàng. Một agent AI có thể đọc mọi mã trong thư mục cục bộ, không cần tải lên, và cung cấp cho bạn một bảng khớp mỗi tệp với bản ghi của nó. Agent là Claude, Cursor hoặc GitHub Copilot; việc đọc được thực hiện bởi máy chủ GroupDocs.Signature.Mcp. Một lời nhắc duy nhất có thể thực hiện:

Đối với mọi PDF trong thư mục, đọc mã vạch và cho tôi một bảng gồm tên tệp, giá trị mã vạch, trang.

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 QR code and barcode data from documents with AI.

Kịch bản: từ một đống tệp đến một hàng đợi được định tuyến

Một phòng thư, một đội ngũ kế toán phải trả hoặc một bàn quản lý vụ việc nhận tài liệu với số lượng lớn. Mỗi tài liệu mang một mã có thể đọc bằng máy được đặt ở đó cho đúng thời điểm này. Nếu không có tự động hoá, ai đó sẽ gõ giá trị vào hệ thống tiếp theo. Với một agent, quy trình là:

  1. Các tài liệu được đưa vào thư mục mà máy chủ được cấu hình để sử dụng (GROUPDOCS_MCP_STORAGE_PATH).
  2. Agent gọi search_barcodes trên mỗi tệp và thu thập các giá trị đã giải mã, trang và vị trí.
  3. Agent trả về bảng. Bảng đó là khóa nối giữa các tệp và các bản ghi trong ERP, kho hoặc hệ thống quản lý vụ việc của bạn.
  4. Một người, hoặc một bước tự động sau này mà bạn kiểm soát, thực hiện việc tra cứu và định tuyến.

Bước 4 được giữ bên ngoài agent cố ý. Xem “Những gì không nên tự động hoá” bên dưới.

Công cụ nào đọc mã nào?

search_qr_codes đọc mã QR. search_barcodes đọc các mã vạch một chiều như Code39, Code128 và EAN. Mỗi công cụ trả về văn bản đã giải mã, trang và vị trí của mỗi kết quả. Nếu bạn không chắc tài liệu chứa loại mã nào, hãy yêu cầu cả hai:

Đọc các mã QR và mã vạch trong invoice.pdf và cho tôi biết chúng chứa gì.

Làm sao để tìm một mã trong số nhiều mã?

Cả hai công cụ đều chấp nhận bộ lọc text để chỉ trả về các mã chứa một chuỗi nhất định:

Tìm mã vạch bắt đầu bằng SHIP và cho tôi biết nó nằm trên trang nào.

Trong một tài liệu có hàng chục mã, đây là sự khác biệt giữa một câu trả lời và một bức tường các giá trị.

Giữ phản hồi ngắn gọn

Cả hai công cụ đều chấp nhận returnImage. Hãy tắt tính năng này trừ khi bạn thực sự cần hình ảnh. Văn bản đã giải mã là những gì agent suy luận, và hình ảnh base64 làm phản hồi trở nên lớn và chậm.

Phiên làm việc ví dụ (rút gọn)

You:    For every PDF in the folder, read the barcode, and give me a table
        of file name, barcode value, page.

Agent:  [search_barcodes] file=invoice-0007.pdf   found: 1
        [search_barcodes] file=invoice-0008.pdf   found: 1
        [search_barcodes] file=scan-0009.pdf      found: 0
        | file             | barcode value | page |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf has no barcode in the pages that were processed.

Đầu ra minh họa: tên tệp và giá trị mã vạch được tạo ra. Công cụ trả về các trường đã mô tả ở trên.

Signature hay Parser: máy chủ nào đọc mã?

Sử dụng GroupDocs.Signature.Mcp khi mã là một phần tử chữ ký bạn cũng thêm vào, hoặc khi tài liệu di chuyển cả hai chiều: đọc tham chiếu đến, thực hiện công việc, sau đó gọi sign trên tài liệu gửi đi với một mã QR mang tham chiếu mới. Sử dụng GroupDocs.Parser.Mcp (chỉ cung cấp dưới dạng hình ảnh Docker; công cụ extract_barcodes của nó) khi bạn đang trích xuất dữ liệu từ các bản quét tùy ý và cũng cần văn bản, bảng hoặc siêu dữ liệu từ cùng các tệp. Máy chủ này đọc chữ ký và mã. Nó không trích xuất bố cục, trường hay bảng.

Những gì không nên tự động hoá

  • Không phải OCR. Các công cụ này đọc các ký hiệu mã, không phải văn bản đã in. Một trang quét không có mã sẽ trả về không có gì, và đó là câu trả lời đúng chứ không phải lỗi.
  • Giá trị đã giải mã là đầu vào không đáng tin cậy. Nó được cung cấp bởi người tạo tài liệu. Hãy báo cáo, tra cứu và kiểm tra chéo. Đừng để agent hành động dựa trên nó mà không được xem xét.

Giới hạn đánh giá

Nếu không có giấy phép, chỉ 2 trang đầu tiên của một tài liệu được xử lý, và một huy hiệu dùng thử được dán lên mỗi trang. Một mã trên trang 3 sẽ không được tìm thấy, và kết quả trống sẽ trông giống như “không có mã”. Yêu cầu agent gọi get_license_status trước khi bạn tin tưởng vào kết quả trống.

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

Claude có thể đọc mã QR trong PDF này không?
Có. Khi máy chủ đã kết nối, Claude gọi search_qr_codes và báo cáo văn bản đã giải mã, trang và vị trí, cục bộ.

Làm sao tôi có thể trích xuất giá trị mã vạch từ hoá đơn bằng AI?
Yêu cầu agent đọc các mã vạch trong tệp. Nó gọi search_barcodes và trả về giá trị đã giải mã; thêm bộ lọc text nếu bạn muốn một mã cụ thể.

Tôi có thể tìm mọi mã QR trong một thư mục tài liệu không?
Có. Yêu cầu agent lặp qua thư mục và liệt kê tệp, văn bản đã giải mã và trang cho mỗi mã QR. Nếu không có giấy phép, chỉ 2 trang đầu tiên của mỗi tệp được kiểm tra.

Đi sâu hơn