Una scansione della posta è un’immagine: nessuno può cercarla e un estrattore di testo non trova nulla al suo interno. Il codice a barre sulla pagina è l’eccezione. Il server GroupDocs.Parser.Mcp viene eseguito localmente in Docker, e un agente IA in un client come Claude Desktop, Cursor o GitHub Copilot può chiedergli di leggere i codici a barre dai documenti scansionati e restituire i valori decodificati:

Leggi i codici a barre in queste note di consegna scansionate e elenca i valori con il file da cui provengono.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come leggere i codici a barre e i codici QR da documenti scansionati.

Perché una scansione ha bisogno di un lettore di codici a barre e non di un estrattore di testo?

Una pagina scansionata non ha alcuno strato di testo. extract_text restituisce poco o nulla, il che è una dichiarazione corretta sul file. I modelli del motore, tuttavia, rilevano i codici nell’immagine rasterizzata, quindi extract_barcodes restituisce comunque il numero di tracciamento stampato su una nota di consegna scansionata. Il server non dispone di OCR, quindi le parole stampate rimangono pixel; solo i codici diventano dati.

Cosa restituisce lo strumento?

extract_barcodes restituisce una riga di intestazione, Found N barcode(s) in ..., seguita da un array JSON con un oggetto per codice, ciascuno con index, value, type, page, confidence e angle. Rileva Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec e molte altre simbologie, in PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF e altri formati. Quando non viene trovato nulla restituisce il messaggio “No barcodes found”.

Esempio di sessione (abbreviato):

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.

Come trasformare una scansione in un record?

Il valore decodificato è solitamente la chiave di join: il numero di tracciamento che collega una scansione a una spedizione, il riferimento ordine che collega un modulo firmato a un caso, il tag dell’asset che collega una fotografia a un record di inventario. Una volta che l’agente lo possiede, l’immagine diventa una riga.

Per ogni scansione, leggi il codice a barre e dimmi a quale ordine appartiene.

L’agente chiama extract_barcodes per file e confronta ogni valore con gli ordini che gli fornisci. Passa page per scansionare solo la pagina che contiene l’etichetta, invece di ogni pagina di un documento lungo.

Come ordinare un lotto misto di scansioni e file nativi digitali?

Fai in modo che l’agente si ramifichi in base al fatto che un file contenga testo.

Per ogni file: prova l’estrazione del testo. Se il risultato è vuoto, leggi invece i codici a barre e dimmi quali file ne hanno avuto bisogno.

I file che sono passati alla lettura dei codici a barre sono le scansioni. Quella lista è un inventario utile di per sé se stai pianificando un progetto di ingestione. Aggiungi un passaggio di instradamento sopra, come “raggruppa i file per il prefisso del valore del loro codice a barre”, e la cartella arriverà già ordinata.

Quale server legge il codice: Parser o Signature?

Entrambi i server possono leggere un codice a barre o un codice QR da una scansione: Parser con extract_barcodes, Signature con search_barcodes e search_qr_codes. Usa GroupDocs.Parser.Mcp quando estrai dati da scansioni arbitrarie e hai anche bisogno di testo, tabelle o metadati dagli stessi file. Usa GroupDocs.Signature.Mcp quando il codice è un elemento di firma che aggiungi, o quando i documenti fluiscono in entrambe le direzioni e firmi il documento in uscita con un nuovo codice. La parte Signature è trattata in Da codice a record: automazione dell’acquisizione dei documenti con agenti IA.

Quali sono i limiti?

  • Un valore decodificato è un dato non attendibile. Chi ha prodotto il documento lo ha scelto. Segnalalo, controllalo, verifica la corrispondenza e non permettere a un agente di agire su di esso senza revisione.
  • Scansioni di scarsa qualità potrebbero non decodificare. Codici inclinati, a bassa risoluzione o danneggiati possono restituire nulla. Un risultato vuoto significa “non trovato”, che su una scansione cattiva non è lo stesso di “non presente”.
  • La modalità di valutazione è limitata. Senza licenza, l’estrazione è limitata; consulta la pagina di licenza della libreria e chiedi all’agente di eseguire prima get_license_status.
  • Solo Docker. I modelli sono inclusi nell’immagine, motivo per cui è grande. Non esiste il comando dnx; il contenitore si avvia con docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, e i collegamenti a un click per VS Code e Cursor sono in Registrati nei client IA.

FAQ

Claude può leggere un codice a barre da un PDF scansionato?
Sì, tramite lo strumento extract_barcodes, che viene eseguito in un contenitore locale sul file scansionato. Claude riceve il valore decodificato, il tipo e la pagina.

Posso leggere un codice QR in un documento scansionato senza OCR?
Sì. Il rilevamento del codice non dipende dal riconoscimento del testo, quindi i codici QR si decodificano anche quando le parole stampate sulla pagina non lo fanno.

Come posso ordinare automaticamente i documenti scansionati per codice a barre?
Chiedi all’agente di leggere il codice su ogni scansione e di raggruppare o rinominare i file in base al valore. Rivedi il raggruppamento prima di spostare i file, poiché i valori decodificati provengono dal documento stesso.

Approfondisci