Picturez une boîte de réception de factures numérisées où chaque page porte un code‑barres qui indique le bon de commande. Un agent IA peut lire chaque code dans le dossier localement, sans téléchargement, et vous fournir un tableau qui associe chaque fichier à son enregistrement. L’agent est Claude, Cursor ou GitHub Copilot ; la lecture est effectuée par le serveur GroupDocs.Signature.Mcp. Une invite suffit :

Pour chaque PDF du dossier, lisez le code‑barres et donnez‑moi un tableau du nom de fichier, de la valeur du code‑barres et de la page.

La version étape par étape avec configuration et dépannage se trouve dans la documentation : How to extract QR code and barcode data from documents with AI.

Scénario : d’un tas de fichiers à une file d’attente routée

Un service de courrier, une équipe de comptes fournisseurs ou un bureau de gestion de dossiers reçoit des documents en masse. Chacun porte un code lisible par machine placé là pour ce moment précis. Sans automatisation, quelqu’un saisit la valeur dans le système suivant. Avec un agent, la séquence est :

  1. Les documents arrivent dans le dossier que le serveur est configuré à utiliser (GROUPDOCS_MCP_STORAGE_PATH).
  2. L’agent appelle search_barcodes sur chaque fichier et collecte les valeurs décodées, les pages et les positions.
  3. L’agent renvoie le tableau. Ce tableau constitue la clé de jointure entre les fichiers et les enregistrements de votre ERP, entrepôt ou système de dossiers.
  4. Une personne, ou une étape automatisée ultérieure que vous contrôlez, effectue la recherche et le routage.

L’étape 4 reste volontairement en dehors de l’agent. Voir « Ce qu’il ne faut pas automatiser » ci‑dessous.

Quel outil lit quel code ?

search_qr_codes lit les codes QR. search_barcodes lit les codes‑barres unidimensionnels tels que Code39, Code128 et EAN. Chaque outil renvoie le texte décodé, la page et la position de chaque occurrence. Si vous n’êtes pas sûr du type présent dans un document, demandez les deux :

Lisez les codes QR et les codes‑barres dans invoice.pdf et dites‑moi ce qu’ils contiennent.

Comment trouver un code parmi plusieurs ?

Les deux outils acceptent un filtre text qui ne renvoie que les codes contenant une chaîne donnée :

Trouvez le code‑barres qui commence par SHIP et indiquez‑moi sur quelle page il se trouve.

Sur un document contenant une douzaine de codes, cela fait la différence entre une réponse et un mur de valeurs.

Gardez les réponses courtes

Les deux outils acceptent returnImage. Désactivez‑le sauf si vous avez réellement besoin du graphique. Le texte décodé est ce sur quoi l’agent raisonne, et les images en base64 alourdissent et ralentissent les réponses.

Session d’exemple (abrégée)

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.

​Sortie illustrative : les noms de fichiers et les valeurs des codes‑barres sont inventés. L’outil renvoie les champs décrits ci‑dessus.

Signature ou Parser : quel serveur lit le code ?

Utilisez GroupDocs.Signature.Mcp lorsque le code est un élément de signature que vous ajoutez également, ou lorsque les documents circulent dans les deux sens : lisez la référence entrante, effectuez le traitement, puis appelez sign sur le document sortant avec un code QR contenant la nouvelle référence. Utilisez GroupDocs.Parser.Mcp (disponible uniquement sous forme d’image Docker ; son outil extract_barcodes) lorsque vous extrayez des données à partir de numérisations arbitraires et avez également besoin du texte, des tableaux ou des métadonnées des mêmes fichiers. Ce serveur lit les signatures et les codes. Il n’extrait pas la mise en page, les champs ou les tableaux.

Ce qu’il ne faut pas automatiser

  • Ce n’est pas de l’OCR. Ces outils lisent les symbologies de code, pas le texte imprimé. Une page numérisée sans code ne renvoie rien, ce qui constitue une réponse correcte plutôt qu’un échec.
  • Une valeur décodée est une entrée non fiable. Elle a été fournie par la personne qui a créé le document. Signalez‑la, recherchez‑la et vérifiez‑la. Ne laissez pas un agent agir dessus sans révision.

Limites d’évaluation

Sans licence, seules les deux premières pages d’un document sont traitées, et un badge d’essai est apposé sur chaque page. Un code situé à la page 3 n’est tout simplement pas trouvé, et un résultat vide apparaît alors comme « pas de code ». Demandez à l’agent d’appeler get_license_status avant de faire confiance à un résultat vide.

FAQ

Claude peut‑il lire le code QR dans ce PDF ?
Oui. Avec le serveur connecté, Claude appelle search_qr_codes et rapporte le texte décodé, la page et la position, localement.

Comment extraire la valeur d’un code‑barres d’une facture avec l’IA ?
Demandez à l’agent de lire les codes‑barres dans le fichier. Il appelle search_barcodes et renvoie la valeur décodée ; ajoutez un filtre text si vous souhaitez un code spécifique.

Puis‑je trouver chaque code QR dans un dossier de documents ?
Oui. Demandez à l’agent de parcourir le dossier et de lister le fichier, le texte décodé et la page pour chaque code QR. Sans licence, seules les deux premières pages de chaque fichier sont examinées.

Approfondir