A digitalização da sala de correspondência é uma imagem: ninguém pode pesquisá‑la, e um extrator de texto não encontra nada nela. O código de barras na página é a exceção. O servidor GroupDocs.Parser.Mcp roda localmente em Docker, e um agente de IA em um cliente como Claude Desktop, Cursor ou GitHub Copilot pode pedir que ele leia códigos de barras de documentos digitalizados e retorne os valores decodificados:

Leia os códigos de barras nestas notas de entrega digitalizadas e liste os valores com o arquivo de origem.

A versão passo a passo com configuração e solução de problemas está na documentação: Como ler códigos de barras e códigos QR de documentos digitalizados.

Por que uma digitalização precisa de um leitor de código de barras e não de um extrator de texto?

Uma página digitalizada não tem camada de texto. extract_text retorna pouco ou nada para ela, o que é uma afirmação verdadeira sobre o arquivo. Os modelos do mecanismo, porém, detectam códigos na imagem rasterizada, então extract_barcodes ainda retorna o número de rastreamento impresso em uma nota de entrega digitalizada. O servidor não possui OCR, portanto as palavras impressas permanecem como pixels; apenas os códigos se tornam dados.

O que a ferramenta retorna?

extract_barcodes retorna uma linha de cabeçalho, Found N barcode(s) in ..., seguida por um array JSON com um objeto por código, cada um contendo index, value, type, page, confidence e angle. Ele detecta Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec e muitas outras simbologias, em PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF e outros formatos. Quando nada é encontrado, ele retorna a mensagem “No barcodes found”.

Exemplo de sessão (abreviado):

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.

Como transformar uma digitalização em um registro?

O valor decodificado é geralmente a chave de junção: o número de rastreamento que vincula uma digitalização a um envio, a referência do pedido que vincula um formulário assinado a um caso, a etiqueta de ativo que vincula uma fotografia a um registro de inventário. Uma vez que o agente o possui, a imagem se torna uma linha.

Para cada digitalização, leia o código de barras e me diga a qual pedido ele pertence.

O agente chama extract_barcodes por arquivo e corresponde cada valor aos pedidos que você fornece. Passe page para digitalizar apenas a página que contém o rótulo, em vez de todas as páginas de um documento extenso.

Como ordenar um lote misto de digitalizações e arquivos nativos?

Deixe o agente ramificar com base em se um arquivo tem texto.

Para cada arquivo: tente a extração de texto. Se retornar vazio, leia os códigos de barras em vez disso e me diga quais arquivos precisaram disso.

Arquivos que passaram para a leitura de códigos de barras são as digitalizações. Essa lista é um inventário útil por si só se você está planejando um projeto de ingestão. Adicione uma etapa de roteamento acima, como “agrupar os arquivos pelo prefixo do valor do código de barras”, e a pasta chega já ordenada.

Qual servidor lê o código: Parser ou Signature?

Ambos os servidores podem ler um código de barras ou código QR de uma digitalização: Parser com extract_barcodes, Signature com search_barcodes e search_qr_codes. Use GroupDocs.Parser.Mcp quando você está extraindo dados de digitalizações arbitrárias e também precisa de texto, tabelas ou metadados dos mesmos arquivos. Use GroupDocs.Signature.Mcp quando o código é um elemento de assinatura que você também adiciona, ou quando os documentos circulam em ambas as direções e você assina o documento de saída com um novo código. O lado Signature é abordado em De Código de Barras a Registro: Automação de Entrada de Documentos com Agentes de IA.

Quais são os limites?

  • Um valor decodificado é um dado não confiável. Quem produziu o documento o escolheu. Relate‑o, pesquise, verifique cruzadamente e não deixe um agente agir sobre ele sem revisão.
  • Digitalizações ruins podem não decodificar. Códigos inclinados, de baixa resolução ou danificados podem não retornar nada. Um resultado vazio significa “não encontrado”, o que em uma digitalização ruim não é o mesmo que “não presente”.
  • O modo de avaliação é limitado. Sem uma licença, a extração é limitada; veja a página de licenciamento da biblioteca e peça ao agente para executar get_license_status primeiro.
  • Apenas Docker. Os modelos são empacotados na imagem, o que explica seu tamanho. Não há comando dnx; o contêiner inicia com docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, e links de um clique para VS Code e Cursor estão em Registrar em clientes de IA.

Perguntas Frequentes

Claude pode ler um código de barras de um PDF digitalizado?
Sim, através da ferramenta extract_barcodes, que roda em um contêiner local no arquivo digitalizado. Claude recebe o valor decodificado, o tipo e a página.

Posso ler um código QR em um documento digitalizado sem OCR?
Sim. A detecção de códigos não depende do reconhecimento de texto, portanto os códigos QR são decodificados mesmo quando as palavras impressas na página não são.

Como ordenar documentos digitalizados por código de barras automaticamente?
Peça ao agente para ler o código em cada digitalização e agrupar ou renomear os arquivos pelo valor. Revise o agrupamento antes de mover os arquivos, pois os valores decodificados vêm do próprio documento.

Aprofunde‑se