Một bản quét phòng thư là một hình ảnh: không ai có thể tìm kiếm nó, và bộ trích xuất văn bản không tìm thấy gì trong đó. Mã vạch trên trang là ngoại lệ. Máy chủ GroupDocs.Parser.Mcp chạy cục bộ trong Docker, và một tác nhân AI trong một khách hàng như Claude Desktop, Cursor hoặc GitHub Copilot có thể yêu cầu nó đọc mã vạch từ tài liệu đã quét và trả về các giá trị đã giải mã:

Đọc các mã vạch trong các phiếu giao hàng đã quét này và liệt kê các giá trị cùng với tệp mà chúng xuất hiện.

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: Cách đọc mã vạch và mã QR từ tài liệu đã quét.

Tại sao một bản quét cần bộ đọc mã vạch mà không phải bộ trích xuất văn bản?

Một trang đã quét không có lớp văn bản. extract_text trả về ít hoặc không có gì cho nó, điều này là một khẳng định đúng về tệp. Tuy nhiên, các mô hình của engine phát hiện mã trong hình ảnh raster, vì vậy extract_barcodes vẫn trả về số theo dõi được in trên phiếu giao hàng đã quét. Máy chủ không có OCR, vì vậy các từ được in vẫn là pixel; chỉ có các mã trở thành dữ liệu.

Công cụ trả về gì?

extract_barcodes trả về một dòng tiêu đề, Found N barcode(s) in ..., tiếp theo là một mảng JSON với một đối tượng cho mỗi mã, mỗi đối tượng có index, value, type, page, confidence và angle. Nó phát hiện Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec và nhiều ký hiệu khác, trong các định dạng PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF và các định dạng khác. Khi không tìm thấy gì, nó trả về thông báo “No barcodes found”.

Ví dụ phiên làm việc (rút gọn):

You:    Read the barcodes on page 1 of dn-2291.pdf and tell me which order it belongs to.
Agent:  [calls extract_barcodes with page 1]
        Found 1 barcode(s) in dn-2291.pdf
        [{"index": 1, "value": "SHP-884120377", "type": "Code128", "page": 1, "confidence": 0.98, "angle": 0}]
        The delivery note carries tracking number SHP-884120377.

Làm thế nào để chuyển một bản quét thành một bản ghi?

Giá trị đã giải mã thường là khóa nối: số theo dõi liên kết bản quét với một lô hàng, tham chiếu đơn hàng liên kết mẫu ký với một trường hợp, thẻ tài sản liên kết ảnh chụp với một bản ghi tồn kho. Khi tác nhân có được nó, hình ảnh trở thành một hàng.

Đối với mỗi bản quét, đọc mã vạch và cho tôi biết nó thuộc đơn hàng nào.

Tác nhân gọi extract_barcodes cho mỗi tệp và khớp mỗi giá trị với các đơn hàng bạn cung cấp. Truyền page để quét chỉ trang chứa nhãn, thay vì mọi trang của một tài liệu dài.

Làm thế nào để sắp xếp một lô hỗn hợp các bản quét và tệp số sinh ra?

Hãy để tác nhân phân nhánh dựa trên việc tệp có văn bản hay không.

Đối với mỗi tệp: thử trích xuất văn bản. Nếu kết quả trống, đọc mã vạch thay thế và cho tôi biết tệp nào cần điều đó.

Các tệp chuyển sang đọc mã vạch là các bản quét. Danh sách đó là một danh mục hữu ích nếu bạn đang lên kế hoạch cho dự án nhập liệu. Thêm một bước định tuyến ở trên, chẳng hạn “nhóm các tệp theo tiền tố của giá trị mã vạch”, và thư mục sẽ đã được sắp xếp.

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

Cả hai máy chủ đều có thể đọc mã vạch hoặc mã QR từ một bản quét: Parser với extract_barcodes, Signature với search_barcodes và search_qr_codes. Sử dụng GroupDocs.Parser.Mcp 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 một tệp. Sử dụng GroupDocs.Signature.Mcp khi mã là một yếu tố chữ ký bạn cũng thêm vào, hoặc khi tài liệu lưu chuyển cả hai chiều và bạn ký tài liệu gửi đi bằng một mã mới. Phần Signature được đề cập trong Từ Mã Vạch đến Bản Ghi: Tự động Tiếp nhận Tài liệu với Các Tác Nhân AI.

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

  • Giá trị đã giải mã là dữ liệu không đáng tin cậy. Người tạo tài liệu đã chọn nó. Hãy báo cáo, tra cứu, kiểm tra chéo, và không để tác nhân hành động dựa trên nó mà không được xem xét.
  • Các bản quét kém có thể không giải mã được. Mã lệch, độ phân giải thấp hoặc bị hỏng có thể không trả về gì. Kết quả trống có nghĩa là “không tìm thấy”, trong trường hợp bản quét kém không đồng nghĩa với “không tồn tại”.
  • Chế độ đánh giá có giới hạn. Không có giấy phép, việc trích xuất bị giới hạn; xem [trang cấp phép] của thư viện và yêu cầu tác nhân chạy get_license_status trước.
  • Chỉ Docker. Các mô hình được đóng gói trong image, vì vậy nó lớn. Không có lệnh dnx; container khởi động bằng docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, và các liên kết một-click cho VS Code và Cursor có trong Register in AI clients.

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

Claude có thể đọc mã vạch từ PDF đã quét không?
Có, thông qua công cụ extract_barcodes, công cụ này chạy trong một container cục bộ trên tệp đã quét. Claude nhận được giá trị đã giải mã, loại và trang.

Tôi có thể đọc mã QR trong tài liệu đã quét mà không cần OCR không?
Có. Việc phát hiện mã không phụ thuộc vào nhận dạng văn bản, vì vậy mã QR có thể giải mã ngay cả khi các từ được in trên trang không.

Làm thế nào để tự động sắp xếp tài liệu đã quét theo mã vạch?
Yêu cầu tác nhân đọc mã trên mỗi bản quét và nhóm hoặc đổi tên các tệp theo giá trị. Xem lại việc nhóm trước khi di chuyển tệp, vì các giá trị đã giải mã đến từ chính tài liệu.

Đi sâu hơn