Sken poštovní schránky je obrázek: nikdo jej nemůže prohledávat a extraktor textu v něm nic nenajde. Čárový kód na stránce je výjimkou. Server GroupDocs.Parser.Mcp běží lokálně v Dockeru a AI agent v klientovi jako Claude Desktop, Cursor nebo GitHub Copilot ho může požádat, aby četl čárové kódy ze skenovaných dokumentů a vrátil dekódované hodnoty:

Přečtěte čárové kódy v těchto naskenovaných dodacích listech a uveďte hodnoty spolu se souborem, ze kterého pocházejí.

Verze krok za krokem s konfigurací a řešením problémů je v dokumentaci: Jak číst čárové kódy a QR kódy ze skenovaných dokumentů.

Proč sken potřebuje čtečku čárových kódů a ne extraktor textu?

Naskenovaná stránka nemá textovou vrstvu. extract_text vrací málo nebo nic, což je pravdivé pro daný soubor. Modely engine však detekují kódy v rasterizovaném obrázku, takže extract_barcodes stále vrací sledovací číslo vytištěné na naskenovaném dodacím listu. Server nemá OCR, takže tištěná slova zůstávají pixely; pouze kódy se stávají daty.

Co nástroj vrací?

extract_barcodes vrací řádek záhlaví, Found N barcode(s) in ..., následovaný polem JSON s jedním objektem pro každý kód, který obsahuje index, value, type, page, confidence a angle. Detekuje Code128, QR Code, PDF417, DataMatrix, EAN‑13, EAN‑8, UPC, Aztec a mnoho dalších symbologií v PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF a dalších formátech. Když nic nenajde, vrátí zprávu „No barcodes found“.

Příklad relace (zkrácený):

Vy:    Přečtěte čárové kódy na stránce 1 souboru dn-2291.pdf a řekněte mi, ke které objednávce patří.
Agent:  [volá extract_barcodes s stránkou 1]
        Nalezen 1 čárový kód v dn-2291.pdf
        [{"index": 1, "value": "SHP-884120377", "type": "Code128", "page": 1, "confidence": 0.98, "angle": 0}]
        Dodací list obsahuje sledovací číslo SHP-884120377.

Jak převést sken na záznam?

Dekódovaná hodnota je obvykle spojovací klíč: sledovací číslo, které spojuje sken s zásilkou, reference objednávky, která spojuje podepsaný formulář s případem, nebo štítek majetku, který spojuje fotografii s inventárním záznamem. Jakmile jej agent získá, obrázek se stane řádkem.

Pro každý sken přečtěte čárový kód a řekněte mi, ke které objednávce patří.

Agent volá extract_barcodes pro každý soubor a porovnává každou hodnotu s objednávkami, které mu poskytnete. Předejte parametr page, aby se skenovala jen stránka nesoucí štítek, místo každé stránky dlouhého dokumentu.

Jak seřadit smíšenou dávku skenů a digitálně vytvořených souborů?

Nechte agenta rozhodnout na základě toho, zda soubor obsahuje text.

Pro každý soubor: zkuste extrakci textu. Pokud vrátí prázdný výsledek, místo toho přečtěte čárové kódy a řekněte mi, které soubory to vyžadovaly.

Soubory, které přešly na čtení čárových kódů, jsou skeny. Tento seznam je užitečný inventář sám o sobě, pokud plánujete projekt ingestování. Přidejte nad něj krok směrování, například „seskupit soubory podle předpony jejich hodnoty čárového kódu“, a složka tak dorazí již seřazená.

Který server čte kód: Parser nebo Signature?

Oba servery mohou číst čárový kód nebo QR kód ze skenu: Parser pomocí extract_barcodes, Signature pomocí search_barcodes a search_qr_codes. Použijte GroupDocs.Parser.Mcp, když extrahujete data z libovolných skenů a zároveň potřebujete text, tabulky nebo metadata ze stejných souborů. Použijte GroupDocs.Signature.Mcp, když je kód podpisovým prvkem, který také přidáváte, nebo když dokumenty proudí oběma směry a podepisujete odchozí dokument novým kódem. Strana Signature je pokryta v From Barcode to Record: Document Intake Automation with AI Agents.

Jaká jsou omezení?

  • Dekódovaná hodnota je nedůvěryhodná data. Kdo dokument vytvořil, si ji zvolil. Nahlaste ji, ověřte ji, zkřížově zkontrolujte a nenechte agenta jednat na základě ní bez revize.
  • Špatné skeny nemusí být dekódovatelné. Šikmé, nízké rozlišení nebo poškozené kódy mohou vrátit nic. Prázdný výsledek znamená „nenalezeno“, což u špatného skenu není totéž jako „neexistuje“.
  • Režim hodnocení je omezený. Bez licence je extrakce omezena; viz stránka knihovny s licencí a požádejte agenta, aby nejprve spustil get_license_status.
  • Pouze Docker. Modely jsou zabalené v obrazu, což je důvod, proč je velký. Neexistuje příkaz dnx; kontejner se spouští pomocí docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest a odkazy pro jedním kliknutím pro VS Code a Cursor jsou v Registraci v AI klientech.

Často kladené otázky

Umí Claude přečíst čárový kód ze skenovaného PDF?
Ano, pomocí nástroje extract_barcodes, který běží v lokálním kontejneru na skenovaném souboru. Claude získá dekódovanou hodnotu, typ a stránku.

Mohu přečíst QR kód v naskenovaném dokumentu bez OCR?
Ano. Detekce kódu nezávisí na rozpoznávání textu, takže QR kódy lze dekódovat i když tištěná slova na stránce chybí.

Jak automaticky seřadit skenované dokumenty podle čárového kódu?
Požádejte agenta, aby přečetl kód na každém skenu a soubory seskupil nebo přejmenoval podle hodnoty. Před přesunem souborů zkontrolujte seskupení, protože dekódované hodnoty pocházejí přímo z dokumentu.

Další informace