스캔된 청구서가 들어 있는 인박스를 상상해 보세요. 각 페이지에는 구매 주문을 나타내는 바코드가 붙어 있습니다. AI 에이전트는 폴더 내의 모든 코드를 로컬에서 읽어 업로드 없이 각 파일을 해당 레코드와 매칭하는 표를 제공할 수 있습니다. 에이전트는 Claude, Cursor 또는 GitHub Copilot이며, 읽기는 GroupDocs.Signature.Mcp 서버가 수행합니다. 하나의 프롬프트로 이를 처리합니다:

폴더에 있는 모든 PDF에 대해 바코드를 읽고 파일 이름, 바코드 값, 페이지가 포함된 표를 제공해 주세요.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: AI를 사용하여 문서에서 QR 코드 및 바코드 데이터 추출하기.

시나리오: 파일 더미에서 라우팅된 큐로

우편실, 결제팀 또는 케이스 관리 데스크는 대량의 문서를 받습니다. 각 문서는 바로 이 순간을 위해 배치된 기계 판독 가능한 코드를 가지고 있습니다. 자동화가 없으면 누군가가 값을 다음 시스템에 입력합니다. 에이전트를 사용하면 순서는 다음과 같습니다:

  1. 문서가 서버가 사용하도록 구성된 폴더(GROUPDOCS_MCP_STORAGE_PATH)에 들어옵니다.
  2. 에이전트가 각 파일에 대해 search_barcodes를 호출하고 디코딩된 값, 페이지 및 위치를 수집합니다.
  3. 에이전트가 표를 반환합니다. 그 표는 파일과 ERP, 창고 또는 케이스 시스템의 레코드 사이의 조인 키가 됩니다.
  4. 사람이거나 나중에 제어하는 자동화 단계가 조회와 라우팅을 수행합니다.

4단계는 의도적으로 에이전트 외부에 남겨 둡니다. 아래의 “자동화하지 말아야 할 것"을 참고하세요.

어떤 도구가 어떤 코드를 읽나요?

search_qr_codes는 QR 코드를 읽습니다. search_barcodes는 Code39, Code128 및 EAN과 같은 1차원 바코드를 읽습니다. 각각은 디코딩된 텍스트, 페이지 및 모든 히트의 위치를 반환합니다. 문서에 어떤 종류가 있는지 확실하지 않다면 두 가지 모두 요청하세요:

invoice.pdf의 QR 코드와 바코드를 읽고 그 내용이 무엇인지 알려 주세요.

여러 코드 중 하나를 어떻게 찾나요?

두 도구 모두 주어진 문자열을 포함하는 코드만 반환하는 text 필터를 지원합니다:

SHIP으로 시작하는 바코드를 찾아 해당 페이지를 알려 주세요.

수십 개의 코드가 있는 문서에서는 이것이 답변과 값의 벽 사이의 차이를 만듭니다.

응답을 작게 유지하기

두 도구 모두 returnImage를 지원합니다. 그래픽이 정말 필요하지 않다면 끄세요. 디코딩된 텍스트가 에이전트가 판단하는 내용이며, base64 이미지가 응답을 크고 느리게 만듭니다.

예시 세션 (축약)

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.

예시 출력: 파일 이름과 바코드 값은 임의로 만든 것입니다. 도구는 위에 설명된 필드를 반환합니다.

Signature 또는 Parser: 어떤 서버가 코드를 읽나요?

코드가 추가하는 서명 요소이거나 문서가 양방향으로 흐르는 경우에는 GroupDocs.Signature.Mcp를 사용하십시오: 들어오는 레퍼런스를 읽고 작업을 수행한 다음, 새 레퍼런스를 담은 QR 코드를 사용해 나가는 문서에 sign을 호출합니다. 임의의 스캔에서 데이터를 추출하고 동일한 파일에서 텍스트, 표 또는 메타데이터도 필요할 때는 GroupDocs.Parser.Mcp (Docker 이미지로만 제공; extract_barcodes 도구) 를 사용하십시오. 이 서버는 서명과 코드를 읽습니다. 레이아웃, 필드 또는 표는 추출하지 않습니다.

자동화하지 말아야 할 것

  • OCR이 아닙니다. 이 도구들은 인쇄된 텍스트가 아니라 코드 심볼을 읽습니다. 코드가 없는 스캔 페이지는 아무 것도 반환하지 않으며, 이는 실패가 아니라 올바른 답변입니다.
  • 디코딩된 값은 신뢰할 수 없는 입력입니다. 이는 문서를 만든 사람이 제공한 것입니다. 이를 보고하고, 조회하고, 교차 확인하십시오. 에이전트가 검토 없이 이를 기반으로 행동하도록 하지 마세요.

평가 제한

라이선스가 없으면 문서의 처음 2페이지만 처리되며, 모든 페이지에 시험 배지가 찍힙니다. 3페이지에 있는 코드는 단순히 발견되지 않으며, 빈 결과는 “코드 없음"처럼 보입니다. 빈 결과를 신뢰하기 전에 에이전트에게 get_license_status를 호출하도록 요청하세요.

FAQ

Claude가 이 PDF의 QR 코드를 읽을 수 있나요?
예. 서버가 연결된 상태에서 Claude는 search_qr_codes를 호출하고 디코딩된 텍스트, 페이지 및 위치를 로컬에서 보고합니다.

AI를 사용해 청구서에서 바코드 값을 어떻게 추출하나요?
에이전트에게 파일의 바코드를 읽도록 요청하세요. 에이전트는 search_barcodes를 호출하고 디코딩된 값을 반환합니다; 특정 코드를 원한다면 text 필터를 추가하세요.

문서 폴더에서 모든 QR 코드를 찾을 수 있나요?
예. 에이전트에게 폴더를 순회하면서 각 QR 코드에 대해 파일, 디코딩된 텍스트 및 페이지를 나열하도록 요청하세요. 라이선스가 없으면 각 파일의 처음 2페이지만 검사됩니다.

더 깊이 파고들기