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

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

Пошаговая версия с настройкой и устранением неполадок находится в документации: How to extract QR code and barcode data from documents with 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 делают ответы большими и медленными.

Пример сеанса (сокращённый)

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

Агент:  [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 не содержит штрих‑кода на обработанных страницах.

Иллюстративный вывод: имена файлов и значения штрих‑кодов вымышлены. Инструмент возвращает описанные выше поля.

Signature или Parser: какой сервер читает код?

Используйте GroupDocs.Signature.Mcp, когда код является элементом подписи, который вы также добавляете, или когда документы движутся в обе стороны: прочитайте входящую ссылку, выполните работу, затем вызовите sign на исходящем документе с QR‑кодом, содержащим новую ссылку. Используйте GroupDocs.Parser.Mcp (доступен только как Docker‑образ; его инструмент extract_barcodes), когда вы извлекаете данные из произвольных сканов и также нуждаетесь в тексте, таблицах или метаданных из тех же файлов. Этот сервер читает подписи и коды. Он не извлекает макет, поля или таблицы.

Что не следует автоматизировать

  • Это не OCR. Эти инструменты читают символьные наборы кодов, а не печатный текст. Сканированная страница без кода ничего не возвращает, и это считается правильным ответом, а не ошибкой.
  • Декодированное значение — недоверенный ввод. Оно было предоставлено тем, кто создал документ. Зафиксируйте его, проверьте и сверните с другими данными. Не позволяйте агенту действовать на основе этого значения без проверки.

Ограничения оценки

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

FAQ

Может ли Claude прочитать QR‑код в этом PDF?
Да. При подключённом сервере Claude вызывает search_qr_codes и локально сообщает декодированный текст, страницу и позицию.

Как извлечь значение штрих‑кода из счета с помощью ИИ?
Попросите агента прочитать штрих‑коды в файле. Он вызывает search_barcodes и возвращает декодированное значение; добавьте фильтр text, если нужен конкретный код.

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

Углубиться