An agen AI tidak seharusnya membaca tabel. Ia harus memanggil alat yang mengembalikan tabel, lalu melakukan operasi aritmatika pada baris. Dengan GroupDocs.Parser.Mcp yang berjalan secara lokal di Docker, klien AI seperti Claude Desktop atau Cursor dapat mengekstrak tabel dari file PDF, Word, dan Excel serta menerima hasilnya dalam format JSON:

Ekstrak item baris dari invoice.pdf sebagai JSON dan jumlahkan kolom Amount.

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengekstrak tabel dari dokumen menjadi data terstruktur.

Apa yang salah ketika model membaca tabel itu sendiri?

Alur kerja umum adalah menempelkan PDF ke dalam obrolan dan meminta tabel. Model melihat aliran teks yang diratakan, menebak di mana kolom berada, dan menuliskan kembali baris‑barnya. Setiap sel kemudian menjadi prediksi. Kolom yang hilang, baris yang digabung, atau desimal yang bergeser tidak menghasilkan kesalahan; melainkan menghasilkan tabel yang tampak yakin dan terformat dengan baik namun sedikit salah. Untuk daftar buah hal itu tidak masalah. Untuk total faktur hal itu sangat penting.

Kegagalan sulit terdeteksi karena output terlihat benar. Tidak ada yang dalam balasan obrolan yang memberi tahu sel mana yang dibaca dari file dan mana yang direkonstruksi.

Apa alternatif selain membiarkan model menebak?

Pindahkan proses pembacaan keluar dari model. Alat extract_tables mendeteksi tabel dengan mesin dokumen dan mengembalikannya sebagai data:

  • Markdown secara default, sebagai bagian ### Table N (page N, R×C) yang langsung ditampilkan di obrolan, VS Code, dan GitHub.
  • JSON dengan format: "json", sebagai array objek { table, page, rows, columns, data }, di mana data adalah kisi string.

Model tidak pernah menyalin sel. Ia menerima data dan bekerja dengannya, sehingga tugasnya menyusut menjadi apa yang dapat dilakukannya dengan andal: menjumlahkan, membandingkan, menyaring, dan menjelaskan. Alat ini mendukung PDF, DOCX, XLSX, PPTX, dan HTML, sehingga prompt yang sama mencakup faktur pemasok, laporan Word, dan spreadsheet.

Bagaimana cara mendapatkan tabel dalam format JSON?

Nyatakan format dalam prompt.

Ekstrak item baris sebagai JSON dan jumlahkan kolom Amount.

Sesi contoh (disingkat)
Anda:    Ekstrak item baris dari invoice-014.pdf sebagai JSON dan jumlahkan kolom Amount.
Agen:    [calls extract_tables with format "json"]
        {"table": 1, "page": 1, "rows": 4, "columns": 3,
         "data": [["Item", "Qty", "Amount"],
                  ["Paper A4", "10", "48.00"],
                  ["Toner", "2", "170.00"],
                  ["Delivery", "1", "22.00"]]}
        Total kolom Amount: 240.00 untuk 3 item baris.

Karena agen menyimpan baris, langkah selanjutnya adalah pertanyaan biasa: baris mana yang terbesar, apakah total cocok dengan angka yang tercetak dalam teks, menulis baris ke CSV di folder output. Ketika aritmetika penting, minta agen untuk mencantumkan baris yang dijumlahkannya sehingga Anda dapat memeriksanya.

Kapan Anda harus meminta Markdown alih‑alih JSON?

Gunakan Markdown ketika orang akan membaca hasilnya selanjutnya, dan JSON ketika kode yang membacanya. Markdown adalah default dan cara tercepat untuk melihat tabel serta menilai apakah tabel tersebut ditemukan dengan benar. Beralih ke JSON untuk total, pemeriksaan silang, dan apa pun yang dimasukkan ke spreadsheet atau basis data. Jika Anda tahu di mana tabel berada, persempit pemanggilan:

Ekstrak tabel pada halaman 4.

Parameter page membatasi deteksi ke satu halaman, yang lebih cepat dan, di bawah lisensi bermeter, lebih murah.

Kasus mana yang masih memerlukan pemeriksaan manusia?

Batasan yang jujur lebih penting dengan tabel dibandingkan teks biasa.

  • Pemindaian tidak memiliki tabel untuk ditemukan. Tanpa lapisan teks tidak ada struktur tabel, dan ekstraksi kembali kosong. Tidak ada OCR di server ini.
  • Tata letak kompleks bervariasi. Sel yang digabung, tabel bersarang, dan tabel yang berlanjut ke halaman lain tidak selalu bertahan bersih seperti kisi sederhana. Lakukan pemeriksaan sampel pada satu dokumen sebelum menjalankan dua ratus.
  • Mode evaluasi terbatas. Tanpa lisensi, ekstraksi terbatas; batasan tepatnya ada di halaman lisensi perpustakaan. Minta agen untuk memanggil get_license_status sebelum menjalankan yang sebenarnya.

Instalasi dengan satu perintah

Server didistribusikan hanya sebagai image Docker, jadi tidak ada perintah dnx. Daftarkan di Claude Code seperti ini, ganti path dengan folder dokumen Anda:

claude mcp add groupdocs-parser -- docker run --rm -i \
  -v /path/to/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest

Cursor, Claude Desktop, VS Code dengan GitHub Copilot, Windsurf, Cline, dan Codex menggunakan kontainer yang sama dengan file konfigurasi khusus klien; masing‑masing tercantum di Daftar di klien AI.

FAQ

Apakah Claude membaca tabel PDF dengan akurat?
Itu tergantung pada file dan cara klien meratakan (flatten)nya, jadi periksa alih‑alih mengasumsikan. Dengan extract_tables baris berasal dari deteksi tabel mesin dokumen, dikembalikan sebagai kisi string, dan Claude bekerja dari situ.

Bagaimana cara mengekstrak tabel dari PDF ke Excel dengan AI?
Minta tabel dalam format JSON, lalu minta agen menulis baris ke CSV di folder output, yang dapat dibuka Excel. Konversi dari baris ke CSV adalah langkah agen; nilai sel berasal dari alat.

Apakah dapat mengekstrak tabel dari file Word dan Excel secara lokal?
Ya. extract_tables menangani DOCX dan XLSX serta PDF, dan kontainer membaca file dari folder yang Anda mount.

Selami Lebih Dalam