Imagine uma caixa de entrada de faturas digitalizadas onde cada página contém um código de barras que nomeia a ordem de compra. Um agente de IA pode ler cada código na pasta localmente, sem upload, e fornecer uma tabela que corresponde cada arquivo ao seu registro. O agente é Claude, Cursor ou GitHub Copilot; a leitura é feita pelo servidor GroupDocs.Signature.Mcp. Um prompt cobre isso:

Para cada PDF na pasta, leia o código de barras e me dê uma tabela com nome do arquivo, valor do código de barras, página.

A versão passo a passo com configuração e solução de problemas está na documentação: Como extrair dados de QR code e código de barras de documentos com IA.

Cenário: de um monte de arquivos para uma fila roteada

Um correio interno, uma equipe de contas a pagar ou um balcão de gerenciamento de casos recebe documentos em massa. Cada um traz um código legível por máquina colocado ali exatamente para este momento. Sem automação, alguém digita o valor no próximo sistema. Com um agente, a sequência é:

  1. Os documentos chegam na pasta que o servidor está configurado para usar (GROUPDOCS_MCP_STORAGE_PATH).
  2. O agente chama search_barcodes em cada arquivo e coleta os valores decodificados, páginas e posições.
  3. O agente devolve a tabela. Essa tabela é a chave de junção entre os arquivos e os registros no seu ERP, armazém ou sistema de casos.
  4. Uma pessoa, ou uma etapa automatizada posterior que você controla, faz a busca e o roteamento.

O passo 4 permanece fora do agente intencionalmente. Veja “O que não automatizar” abaixo.

Qual ferramenta lê qual código?

search_qr_codes lê códigos QR. search_barcodes lê códigos de barras unidimensionais como Code39, Code128 e EAN. Cada um devolve o texto decodificado, a página e a posição de cada ocorrência. Se você não tem certeza de qual tipo um documento contém, peça ambos:

Leia os códigos QR e códigos de barras em invoice.pdf e me diga o que eles contêm.

Como encontrar um código entre muitos?

Ambas as ferramentas aceitam um filtro text que retorna apenas códigos contendo uma determinada string:

Encontre o código de barras que começa com SHIP e me diga em qual página ele está.

Em um documento com uma dúzia de códigos, isso faz a diferença entre uma resposta e uma parede de valores.

Mantenha as respostas pequenas

Ambas as ferramentas aceitam returnImage. Deixe desativado a menos que você realmente precise do gráfico. O texto decodificado é o que o agente analisa, e imagens em base64 tornam as respostas grandes e lentas.

Sessão de exemplo (abreviada)

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.

Saída ilustrativa: nomes de arquivos e valores de códigos de barras são inventados. A ferramenta devolve os campos descritos acima.

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

Use GroupDocs.Signature.Mcp quando o código é um elemento de assinatura que você também adiciona, ou quando os documentos circulam nos dois sentidos: leia a referência recebida, faça o trabalho, então chame sign no documento de saída com um código QR que contém a nova referência. Use GroupDocs.Parser.Mcp (disponível apenas como imagem Docker; sua ferramenta extract_barcodes) quando você está extraindo dados de digitalizações arbitrárias e também precisa de texto, tabelas ou metadados dos mesmos arquivos. Este servidor lê assinaturas e códigos. Ele não extrai layout, campos ou tabelas.

O que não automatizar

  • Não é OCR. Essas ferramentas leem simbologias de código, não texto impresso. Uma página escaneada sem código não retorna nada, e isso é uma resposta correta, não uma falha.
  • Um valor decodificado é entrada não confiável. Ele foi fornecido por quem criou o documento. Relate-o, procure e verifique cruzadamente. Não deixe um agente agir sobre ele sem revisão.

Limites de avaliação

Sem uma licença, apenas as duas primeiras páginas de um documento são processadas, e um selo de avaliação é estampado em cada página. Um código na página 3 simplesmente não é encontrado, e um resultado vazio parece então “nenhum código”. Peça ao agente para chamar get_license_status antes de confiar em um resultado vazio.

Perguntas Frequentes

Claude pode ler o código QR neste PDF?
Sim. Com o servidor conectado, Claude chama search_qr_codes e relata o texto decodificado, página e posição, localmente.

Como extrair o valor de um código de barras de uma fatura com IA?
Peça ao agente para ler os códigos de barras no arquivo. Ele chama search_barcodes e devolve o valor decodificado; adicione um filtro text se quiser um código específico.

Posso encontrar todos os códigos QR em uma pasta de documentos?
Sim. Peça ao agente para percorrer a pasta e listar arquivo, texto decodificado e página para cada código QR. Sem licença, apenas as duas primeiras páginas de cada arquivo são examinadas.

Aprofunde-se