Bayangkan sebuah kotak masuk berisi faktur yang dipindai di mana setiap halaman memiliki barcode yang menyebutkan nomor pesanan pembelian. Sebuah agen AI dapat membaca setiap kode di folder secara lokal, tanpa mengunggah, dan memberikan Anda tabel yang mencocokkan setiap file dengan catatannya. Agennya adalah Claude, Cursor, atau GitHub Copilot; pembacaan dilakukan oleh server GroupDocs.Signature.Mcp. Satu prompt mencakup hal ini:

Untuk setiap PDF di folder, baca barcode, dan berikan saya tabel nama file, nilai barcode, halaman.

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengekstrak data kode QR dan barcode dari dokumen dengan AI.

Skenario: dari tumpukan file ke antrian yang diarahkan

Ruang surat, tim akun‑payable, atau meja manajemen kasus menerima dokumen secara massal. Setiap dokumen membawa kode yang dapat dibaca mesin yang ditempatkan di sana untuk momen ini. Tanpa otomatisasi, seseorang mengetik nilai tersebut ke sistem berikutnya. Dengan agen, urutannya adalah:

  1. Dokumen masuk ke folder yang dikonfigurasi untuk digunakan oleh server (GROUPDOCS_MCP_STORAGE_PATH).
  2. Agen memanggil search_barcodes pada setiap file dan mengumpulkan nilai yang didekode, halaman, dan posisi.
  3. Agen mengembalikan tabel. Tabel tersebut menjadi kunci penggabungan antara file dan catatan di ERP, gudang, atau sistem kasus Anda.
  4. Seorang manusia, atau langkah otomatis selanjutnya yang Anda kontrol, melakukan pencarian dan pengarahan.

Langkah 4 sengaja tetap di luar agen. Lihat “Apa yang tidak harus diotomatisasi” di bawah.

Alat mana yang membaca kode apa?

search_qr_codes membaca kode QR. search_barcodes membaca barcode satu dimensi seperti Code39, Code128, dan EAN. Masing‑masing mengembalikan teks yang didekode, halaman, dan posisi setiap temuan. Jika Anda tidak yakin jenis apa yang dimiliki dokumen, minta keduanya:

Baca kode QR dan barcode dalam invoice.pdf dan beri tahu saya apa isinya.

Bagaimana cara menemukan satu kode di antara banyak kode?

Kedua alat menerima filter text yang mengembalikan hanya kode yang mengandung string tertentu:

Temukan barcode yang dimulai dengan SHIP dan beri tahu saya halaman mana berada.

Pada dokumen dengan selusin kode, itu menjadi perbedaan antara sebuah jawaban dan dinding nilai.

Jaga respons tetap kecil

Kedua alat menerima returnImage. Matikan kecuali Anda benar‑benar membutuhkan gambar. Teks yang didekode adalah apa yang dipertimbangkan agen, dan gambar base64 membuat respons menjadi besar dan lambat.

Contoh sesi (disingkat)

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.

Output ilustratif: nama file dan nilai barcode dibuat‑buat. Alat mengembalikan bidang yang dijelaskan di atas.

Signature atau Parser: server mana yang membaca kode?

Gunakan GroupDocs.Signature.Mcp ketika kode tersebut merupakan elemen tanda tangan yang juga Anda tambahkan, atau ketika dokumen mengalir dua arah: baca referensi masuk, lakukan pekerjaan, lalu panggil sign pada dokumen keluar dengan kode QR yang membawa referensi baru. Gunakan GroupDocs.Parser.Mcp (disediakan hanya sebagai image Docker; alat extract_barcodes‑nya) ketika Anda mengekstrak data dari pemindaian acak dan juga membutuhkan teks, tabel, atau metadata dari file yang sama. Server ini membaca tanda tangan dan kode. Ia tidak mengekstrak tata letak, bidang, atau tabel.

Apa yang tidak harus diotomatisasi

  • Bukan OCR. Alat‑alat ini membaca simbol kode, bukan teks tercetak. Halaman yang dipindai tanpa kode tidak mengembalikan apa‑apa, dan itu merupakan jawaban yang benar, bukan kegagalan.
  • Nilai yang didekode adalah masukan yang tidak dapat dipercaya. Nilai tersebut disediakan oleh siapa pun yang membuat dokumen. Laporkan, cari, dan periksa silang. Jangan biarkan agen bertindak atasnya tanpa ditinjau.

Batas evaluasi

Tanpa lisensi hanya dua halaman pertama dari sebuah dokumen yang diproses, dan lencana percobaan ditempelkan pada setiap halaman. Kode pada halaman 3 tidak ditemukan, dan hasil kosong kemudian terlihat seperti “tidak ada kode”. Minta agen memanggil get_license_status sebelum Anda mempercayai hasil kosong.

FAQ

Bisakah Claude membaca kode QR dalam PDF ini?
Ya. Dengan server terhubung, Claude memanggil search_qr_codes dan melaporkan teks yang didekode, halaman, dan posisi, secara lokal.

Bagaimana cara mengekstrak nilai barcode dari faktur dengan AI?
Minta agen membaca barcode dalam file. Ia memanggil search_barcodes dan mengembalikan nilai yang didekode; tambahkan filter text jika Anda menginginkan satu kode tertentu.

Bisakah saya menemukan setiap kode QR dalam folder dokumen?
Ya. Minta agen mengulang folder dan mencantumkan file, teks yang didekode, dan halaman untuk setiap kode QR. Tanpa lisensi, hanya dua halaman pertama setiap file yang diperiksa.

Selami lebih dalam