“Make me the regional sales report from sales.csv” adalah permintaan yang akan dijawab dengan senang hati oleh model bahasa dengan mengetik tabel Markdown, membulatkan satu atau dua angka di sepanjang proses, dan mendeskripsikan diagram yang tidak dapat digambar. Dengan GroupDocs.Assembly.Mcp berjalan secara lokal (dnx GroupDocs.Assembly.Mcp --yes), Claude Desktop, Cursor, atau Copilot menyerahkan file data ke mesin sebagai gantinya: templat Word atau PowerPoint Anda berisi tabel, total, dan diagram nyata, dan server mengisinya dari CSV atau spreadsheet tanpa angka pernah melewati model:

Buat laporan penjualan regional dari sales.xlsx dengan sales-report.docx sebagai PDF, dan slide diagram dengan sales-chart.pptx.

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara membuat laporan dengan tabel dan diagram dari CSV atau spreadsheet dengan agen AI.

Mengapa angka harus melewati model?

Karena model adalah generator teks, dan laporan adalah aritmetika plus tata letak. Ketika agen membaca CSV dan menulis laporan sendiri, setiap nilai diketik ulang oleh prediksi token berikutnya. Kebanyakan muncul dengan benar. Yang tidak muncul tidak terlihat sampai seseorang memeriksanya terhadap sumber, yang tepatnya pekerjaan yang ingin dihemat laporan. Diagram lebih buruk: model dapat mendeskripsikan satu, atau menghasilkan kode untuk satu, tetapi diagram dalam deck kuartalan Anda adalah objek dalam file PowerPoint, yang ditata oleh seseorang di pemasaran.

Jadi bagi pekerjaan berdasarkan apa yang masing‑masing pihak kuasai. Templat menentukan tampilan laporan. Mesin membaca file dan melakukan perhitungan. Agen memilih templat dan data, serta memberi tahu Anda apa yang dihasilkan.

Apa yang diteruskan agen, dan apa yang dilihat mesin

Berikut pembagiannya dalam satu tabel:

the agent decides        the engine does            the template owns
-----------------------  -------------------------  -----------------------
which template           reads sales.xlsx/.csv      the table layout
which data file          types the columns          the chart and its style
output format (pdf)      sums, sorts, picks max     headings, fonts, logo
                         fills table rows, chart    what "total" means

Sebelum menghasilkan, agen dapat melihat file data. Untuk spreadsheet kami server melaporkan satu tabel dengan tiga kolom:

-> get_document_info {"file":{"filePath":"sales.xlsx"}}
<- { "dataKind": "table",
     "data": { "tableCount": 1, "tables": [ { "number": 1,
       "columns": [ "Region", "Quarter", "Revenue" ] } ] } }

Laporan tabel

Templat Word memiliki satu baris tabel dengan <<foreach [r in sales]>> di sel pertama dan <</foreach>> di sel terakhir, plus dua baris di bawahnya: <<[sales.Sum(r => r.Revenue)]>> dan <<[sales.OrderByDescending(r => r.Revenue).First().Region]>>. Satu panggilan:

-> assemble_document {"template":{"filePath":"sales-report.docx"},
     "data":{"filePath":"sales.xlsx"},"format":"pdf"}
<- Assembled 'sales-report.docx' with 'sales.xlsx' (table 1 (3
   column(s): Region, Quarter, Revenue) as 'sales') as PDF
   Saved to: .../sales-report_assembled.pdf

Laporan memiliki empat baris (North 182000, South 146500, East 98250, West 211900), “Total revenue: 638650 EUR” dan “Best region: West”. Server menamai data sales karena itulah yang dilalui templat; tidak ada yang harus menyebutkannya. Templat yang sama dengan sales.csv menghasilkan total yang sama; untuk CSV, hasHeaders dan csvDelimiter menangani file tanpa baris header atau dengan titik koma.

Diagram

Diagram dalam templat GroupDocs.Assembly adalah diagram biasa dengan tag di dua tempat. Judul diagram membaca Revenue by region<<foreach [r in sales]>><<x [r.Region]>>: loop melalui baris, satu kategori per wilayah. Nama seri membaca Revenue<<y [r.Revenue]>>: satu nilai per baris. Data placeholder di dalam diagram hanya ada agar perancang dapat melihatnya.

-> assemble_document {"template":{"filePath":"sales-chart.pptx"},
     "data":{"filePath":"sales.xlsx"}}
<- Assembled 'sales-chart.pptx' with 'sales.xlsx' (table 1 (3
   column(s): Region, Quarter, Revenue) as 'sales') as PPTX
   Saved to: .../sales-chart_assembled.pptx

Kami membuka hasilnya: diagram kolom berjudul Revenue by region, kategori North, South, East, dan West, nilai 182000, 146500, 98250, dan 211900, dengan tag hilang dan gaya templat tetap utuh. Tag yang sama berfungsi di diagram Word dan Excel.

Mengapa tidak meminta agen gambar diagram?

Anda bisa, dan untuk jawaban satu kali dalam obrolan itu baik-baik saja. Untuk laporan, hal ini memiliki tiga masalah: gambar adalah foto, jadi tidak ada yang dapat mengkliknya dan memeriksa nilai; gayanya apa saja yang dipilih kode plot secara default, bukan gaya perusahaan Anda; dan angka di dalamnya melewati model dalam proses. Diagram templat adalah objek diagram asli, diisi dari file, dan ditata sekali oleh pemilik templat.

Batasan Jujur

  • Tag tabel dan diagram harus sudah ada dalam templat; agen tidak merancangnya. get_template_fields menunjukkan data apa yang dibaca templat.
  • Mode evaluasi: setiap output dimulai dengan “Evaluation Only. Created with GroupDocs.Assembly 26.7…”, dan workbook yang disimpan mendapatkan lembar kerja tambahan.
  • Daftar yang kosong dalam data tidak memiliki tipe kolom, sehingga aritmetika atasnya gagal, bahkan dengan allowMissingMembers. Periksa bahwa filter yang Anda minta mengembalikan baris.
  • Templat presentasi di Linux memerlukan libgdiplus saat dijalankan melalui dnx; gambar Docker sudah menyertakannya.
  • Tanggal dalam file data: pertahankan sebagai tanggal atau ISO lengkap dengan waktu, dan formatlah dalam templat.

Tanya Jawab

Bisakah agen AI membuat diagram dari CSV saya tanpa mengunggahnya?
Ya. Server berjalan secara lokal, membaca CSV atau spreadsheet dari folder penyimpanan Anda dan menulis laporan di sana; angka berpindah langsung dari file ke dokumen tanpa melewati model.

File data apa yang dapat dibaca templat?
JSON, XML, CSV, dan TSV, serta tabel di dalam spreadsheet, dokumen Word atau PowerPoint; dataTable memilih tabel ketika ada beberapa.

Apakah laporan dapat berupa file Excel alih-alih PDF?
Ya, gunakan templat XLSX; tag masuk ke sel lembar kerja. Dalam mode evaluasi workbook yang disimpan mendapatkan lembar kerja tambahan.

Selami Lebih Dalam