Immagina una casella di posta di fatture scannerizzate in cui ogni pagina porta un codice a barre che indica l’ordine d’acquisto. Un agente IA può leggere ogni codice nella cartella localmente, senza upload, e fornirti una tabella che associa ogni file al suo record. L’agente è Claude, Cursor o GitHub Copilot; la lettura è eseguita dal server GroupDocs.Signature.Mcp. Un prompt lo copre:

Per ogni PDF nella cartella, leggi il codice a barre e forniscimi una tabella con nome file, valore del codice a barre, pagina.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come estrarre dati QR code e codice a barre dai documenti con IA.

Scenario: da un mucchio di file a una coda instradata

Una sala posta, un team di contabilità fornitori o una scrivania di gestione dei casi ricevono documenti in blocco. Ognuno porta un codice leggibile dalla macchina posizionato lì per esattamente questo momento. Senza automazione qualcuno digita il valore nel sistema successivo. Con un agente, la sequenza è:

  1. I documenti arrivano nella cartella che il server è configurato per usare (GROUPDOCS_MCP_STORAGE_PATH).
  2. L’agente chiama search_barcodes su ogni file e raccoglie i valori decodificati, le pagine e le posizioni.
  3. L’agente restituisce la tabella. Quella tabella è la chiave di collegamento tra i file e i record nel tuo ERP, magazzino o sistema di gestione dei casi.
  4. Una persona, o un passaggio automatizzato successivo che controlli, esegue la ricerca e l’instradamento.

Il passaggio 4 rimane fuori dall’agente di proposito. Vedi “Cosa non automatizzare” di seguito.

Quale strumento legge quale codice?

search_qr_codes legge i QR code. search_barcodes legge i codici a barre unidimensionali come Code39, Code128 ed EAN. Ognuno restituisce il testo decodificato, la pagina e la posizione di ogni risultato. Se non sei sicuro di quale tipo contenga un documento, chiedi entrambi:

Leggi i QR code e i codici a barre in invoice.pdf e dimmi cosa contengono.

Come trovare un codice tra molti?

Entrambi gli strumenti accettano un filtro text che restituisce solo i codici contenenti una determinata stringa:

Trova il codice a barre che inizia con SHIP e dimmi su quale pagina si trova.

Su un documento con una dozzina di codici, questa è la differenza tra una risposta e un muro di valori.

Mantieni le risposte piccole

Entrambi gli strumenti accettano returnImage. Lascia spento a meno che non ti serva davvero la grafica. Il testo decodificato è ciò su cui ragiona un agente, e le immagini base64 rendono le risposte grandi e lente.

Sessione di esempio (abbreviata)

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.

Output illustrativo: i nomi dei file e i valori dei codici a barre sono inventati. Lo strumento restituisce i campi descritti sopra.

Signature o Parser: quale server legge il codice?

Usa GroupDocs.Signature.Mcp quando il codice è un elemento di firma che aggiungi anche, o quando i documenti fluiscono in entrambe le direzioni: leggi il riferimento in ingresso, esegui il lavoro, poi chiama sign sul documento in uscita con un QR code che trasporta il nuovo riferimento. Usa GroupDocs.Parser.Mcp (disponibile solo come immagine Docker; il suo strumento extract_barcodes) quando estrai dati da scansioni arbitrarie e hai anche bisogno di testo, tabelle o metadati dagli stessi file. Questo server legge firme e codici. Non estrae layout, campi o tabelle.

Cosa non automatizzare

  • Non è OCR. Questi strumenti leggono le simbologie dei codici, non il testo stampato. Una pagina scannerizzata senza codice non restituisce nulla, e questa è una risposta corretta piuttosto che un errore.
  • Un valore decodificato è un input non attendibile. È stato fornito da chi ha creato il documento. Segnalalo, cercalo e verifica la corrispondenza. Non lasciare che un agente agisca su di esso senza revisione.

Limiti di valutazione

Senza licenza vengono elaborate solo le prime 2 pagine di un documento, e un badge di prova è stampato su ogni pagina. Un codice a pagina 3 semplicemente non viene trovato, e un risultato vuoto appare come “nessun codice”. Chiedi all’agente di chiamare get_license_status prima di fidarti di un risultato vuoto.

FAQ

Claude può leggere il QR code in questo PDF?
Sì. Con il server connesso, Claude chiama search_qr_codes e segnala il testo decodificato, la pagina e la posizione, localmente.

Come estraggo il valore di un codice a barre da una fattura con IA?
Chiedi all’agente di leggere i codici a barre nel file. Chiama search_barcodes e restituisce il valore decodificato; aggiungi un filtro text se vuoi un codice specifico.

Posso trovare tutti i QR code in una cartella di documenti?
Sì. Chiedi all’agente di scorrere la cartella e elencare file, testo decodificato e pagina per ogni QR code. Senza licenza, solo le prime 2 pagine di ogni file sono esaminate.

Approfondisci