Wyobraź sobie skrzynkę odbiorczą ze zeskanowanymi fakturami, w której każda strona zawiera kod kreskowy określający numer zamówienia. Agent AI może odczytać każdy kod w folderze lokalnie, bez przesyłania, i dostarczyć tabelę dopasowującą każdy plik do jego rekordu. Agent to Claude, Cursor lub GitHub Copilot; odczyt odbywa się na serwerze GroupDocs.Signature.Mcp. Jeden prompt obejmuje to:

Dla każdego PDF w folderze odczytaj kod kreskowy i podaj mi tabelę z nazwą pliku, wartością kodu kreskowego, stroną.

Wersja krok po kroku z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: How to extract QR code and barcode data from documents with AI.

Scenariusz: od sterty plików do skierowanej kolejki

Poczta, zespół rozliczeń lub biuro obsługi spraw otrzymuje dokumenty masowo. Każdy z nich zawiera kod maszynowo czytelny umieszczony właśnie na tę chwilę. Bez automatyzacji ktoś wpisuje wartość do kolejnego systemu. Z agentem sekwencja wygląda tak:

  1. Dokumenty trafiają do folderu, którego używa serwer (GROUPDOCS_MCP_STORAGE_PATH).
  2. Agent wywołuje search_barcodes dla każdego pliku i zbiera odszyfrowane wartości, strony i pozycje.
  3. Agent zwraca tabelę. Ta tabela jest kluczem łączenia między plikami a rekordami w Twoim ERP, magazynie lub systemie spraw.
  4. Osoba lub późniejszy zautomatyzowany krok, którym sterujesz, wykonuje wyszukiwanie i kierowanie.

Krok 4 pozostaje poza agentem celowo. Zobacz „Co nie warto automatyzować” poniżej.

Które narzędzie odczytuje który kod?

search_qr_codes odczytuje kody QR. search_barcodes odczytuje jednowymiarowe kody kreskowe, takie jak Code39, Code128 i EAN. Każde z nich zwraca odszyfrowany tekst, stronę i pozycję każdego trafienia. Jeśli nie masz pewności, jaki rodzaj kodu znajduje się w dokumencie, poproś o oba:

Odczytaj kody QR i kody kreskowe w invoice.pdf i powiedz mi, co zawierają.

Jak znaleźć jeden kod wśród wielu?

Oba narzędzia akceptują filtr text, który zwraca tylko kody zawierające podany ciąg znaków:

Znajdź kod kreskowy zaczynający się od SHIP i powiedz mi, na której stronie się znajduje.

W dokumencie z tuziną kodów to różnica między odpowiedzią a ścianą wartości.

Trzymaj odpowiedzi małe

Oba narzędzia akceptują returnImage. Wyłącz tę opcję, chyba że naprawdę potrzebujesz grafiki. Odszyfrowany tekst jest tym, nad czym agent rozważa, a obrazy w formacie base64 powiększają i spowalniają odpowiedzi.

Przykładowa sesja (skrócona)

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.

Ilustracyjny wynik: nazwy plików i wartości kodów kreskowych są wymyślone. Narzędzie zwraca pola opisane powyżej.

Signature czy Parser: który serwer odczytuje kod?

Użyj GroupDocs.Signature.Mcp, gdy kod jest elementem podpisu, który również dodajesz, lub gdy dokumenty przepływają w obie strony: odczytaj przychodzącą referencję, wykonaj pracę, a następnie wywołaj sign na wychodzącym dokumencie z kodem QR zawierającym nową referencję. Użyj GroupDocs.Parser.Mcp (dostępny wyłącznie jako obraz Docker; jego narzędzie extract_barcodes), gdy wyodrębniasz dane z dowolnych skanów i potrzebujesz także tekstu, tabel lub metadanych z tych samych plików. Ten serwer odczytuje podpisy i kody. Nie wyodrębnia układu, pól ani tabel.

Co nie warto automatyzować

  • To nie jest OCR. Te narzędzia odczytują symbologie kodów, a nie drukowany tekst. Zeskanowana strona bez kodu nie zwraca nic, co jest prawidłową odpowiedzią, a nie błędem.
  • Odszyfrowana wartość jest niezweryfikowanym wejściem. Została dostarczona przez osobę, która stworzyła dokument. Zgłoś ją, sprawdź i zweryfikuj. Nie pozwól agentowi działać na niej bez przeglądu.

Limity oceny

Bez licencji przetwarzane są tylko pierwsze 2 strony dokumentu, a na każdej stronie znajduje się znak próbny. Kod na stronie 3 po prostu nie zostanie znaleziony, a pusty wynik wygląda wtedy jak „brak kodu”. Poproś agenta o wywołanie get_license_status przed zaufaniem pustemu wynikowi.

FAQ

Czy Claude może odczytać kod QR w tym PDF?
Tak. Po podłączeniu serwera Claude wywołuje search_qr_codes i zgłasza odszyfrowany tekst, stronę oraz pozycję, lokalnie.

Jak wyodrębnić wartość kodu kreskowego z faktury przy użyciu AI?
Poproś agenta o odczytanie kodów kreskowych w pliku. Wywoła search_barcodes i zwróci odszyfrowaną wartość; dodaj filtr text, jeśli potrzebujesz konkretnego kodu.

Czy mogę znaleźć każdy kod QR w folderze dokumentów?
Tak. Poproś agenta o przeiterowanie folderu i wypisanie pliku, odszyfrowanego tekstu i strony dla każdego kodu QR. Bez licencji sprawdzane są tylko pierwsze 2 strony każdego pliku.

Zagłęb się