Уявіть собі вхідну скриньку зі сканованими рахунками, де кожна сторінка містить штрих‑код, що називає замовлення на закупівлю. AI‑агент може читати кожен код у папці локально, без завантаження, і надати вам таблицю, що співставляє кожен файл з його записом. Агентом може бути Claude, Cursor або GitHub Copilot; читання виконує сервер GroupDocs.Signature.Mcp. Один запит охоплює це:

Для кожного PDF у папці прочитайте штрих‑код і дайте мені таблицю з назвою файлу, значенням штрих‑коду, сторінкою.

Версія крок за кроком з налаштуваннями та усуненням проблем знаходиться в документації: Як витягнути дані QR‑коду та штрих‑коду з документів за допомогою AI.

Сценарій: від купи файлів до маршрутизованої черги

Поштове відділення, команда з обробки рахунків або стіл управління справами отримують документи масово. Кожен з них містить машинно‑зчитуваний код, розташований саме для цього моменту. Без автоматизації хтось вводить значення у наступну систему. За допомогою агента послідовність виглядає так:

  1. Документи потрапляють у папку, яку сервер налаштовано використовувати (GROUPDOCS_MCP_STORAGE_PATH).
  2. Агент викликає search_barcodes для кожного файлу і збирає декодовані значення, сторінки та позиції.
  3. Агент повертає таблицю. Ця таблиця є ключем з’єднання між файлами та записами у вашій ERP, складській чи системі справ.
  4. Людина або пізніший автоматизований крок, яким ви керуєте, виконує пошук і маршрутизацію.

Крок 4 залишено поза агентом навмисно. Дивіться розділ «Що не варто автоматизувати» нижче.

Який інструмент читає який код?

search_qr_codes читає QR‑коди. search_barcodes читає одновимірні штрих‑коди, такі як Code39, Code128 і EAN. Кожен повертає декодований текст, сторінку та позицію кожного збігу. Якщо ви не впевнені, який тип коду міститься у документі, запитайте обидва:

Прочитайте QR‑коди та штрих‑коди у invoice.pdf і повідомте, що вони містять.

Як знайти один код серед багатьох?

Обидва інструменти приймають фільтр 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, коли код є елементом підпису, який ви також додаєте, або коли документи проходять в обох напрямках: читаєте вхідне посилання, виконуєте роботу, потім викликаєте sign на вихідному документі з QR‑кодом, що несе нове посилання. Використовуйте GroupDocs.Parser.Mcp (доступний лише як Docker‑образ; його інструмент extract_barcodes), коли ви витягуєте дані з довільних сканів і також потребуєте текст, таблиці або метадані з тих самих файлів. Цей сервер читає підписи та коди. Він не витягує макет, поля чи таблиці.

Що не варто автоматизувати

  • Це не OCR. Ці інструменти читають символьні коди, а не надрукований текст. Сканована сторінка без коду нічого не повертає, і це правильна відповідь, а не помилка.
  • Декодоване значення — недовірений ввід. Воно було надане тим, хто створив документ. Зафіксуйте його, перевірте та зіставте. Не дозволяйте агенту діяти на його підставі без перевірки.

Обмеження оцінки

Без ліцензії обробляються лише перші 2 сторінки документа, і на кожну сторінку ставиться позначка trial. Код на 3‑й сторінці просто не знаходиться, і порожній результат виглядає як «немає коду». Попросіть агента викликати get_license_status перед тим, як довіряти порожньому результату.

FAQ

Чи може Claude прочитати QR‑код у цьому PDF?
Так. При підключеному сервері Claude викликає search_qr_codes і локально повідомляє декодований текст, сторінку та позицію.

Як витягнути значення штрих‑коду з рахунку за допомогою AI?
Попросіть агента прочитати штрих‑коди у файлі. Він викликає search_barcodes і повертає декодоване значення; додайте фільтр text, якщо потрібен конкретний код.

Чи можу я знайти кожен QR‑код у папці документів?
Так. Попросіть агента пройти по папці і перелічити файл, декодований текст і сторінку для кожного QR‑коду. Без ліцензії перевіряються лише перші 2 сторінки кожного файлу.

Поглибити