Seseorang memberi Anda templat Word dan tenggat waktu. Data apa yang dibutuhkan? Jawaban biasanya adalah membuka, menggulir, menebak, menjalankannya, membaca kesalahan, dan menjalankannya lagi. Dengan GroupDocs.Assembly.Mcp berjalan secara lokal (dnx GroupDocs.Assembly.Mcp --yes), Claude Desktop, Cursor, atau Copilot menanyakan langsung ke templat: get_template_fields mengembalikan setiap tag, nama data yang digunakannya, dan kerangka JSON untuk diisi, tanpa menjalankan mesin, dan ketika sebuah eksekusi gagal, kesalahan tersebut memberi tahu apa yang harus diubah:
Data apa yang dibutuhkan order-lines.docx? Jika tidak dapat menghasilkan, beri tahu saya mengapa dan bagaimana memperbaiki templatnya.
Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengetahui apa yang dibutuhkan sebuah template dan mengapa gagal.
Mengapa memeriksa sebelum mengisi?
Karena coba-coba adalah cara yang mahal untuk mempelajari skema. Agen yang menebak nama bidang dari teks yang terlihat pada dokumen akan menebak CustomerName ketika templat membaca customer.Name, dan setiap tebakan yang salah memakan satu putaran komunikasi serta menghasilkan kesalahan yang membingungkan. Sebuah templat bukan prosa; ia adalah program dengan kontrak data, dan kontrak tersebut dapat dibaca.
Itulah semua yang dilakukan get_template_fields. Ia mem-parsing tag <<…>>, menentukan nama-nama, dan membangun kerangka:
-> get_template_fields {"template":{"filePath":"order-lines.docx"}}
<- { "tagCount": 3,
"dataSourceNames": [ "lines" ],
"fields": [ "lines[].Title", "lines[].Quantity" ],
"dataSkeleton": { "lines": [ { "Title": "", "Quantity": "" } ] },
"notes": [ "fields and dataSkeleton are inferred from the tags,
not from the engine; values computed by Select/GroupBy
projections are not followed." ] }
Catatan tersebut jujur tentang metode: ini adalah inspeksi statis. Sebuah bidang yang dihasilkan di dalam proyeksi Select tidak diikuti. Untuk kontrak normal, surat atau templat faktur, kerangka tersebut adalah tepat apa yang harus diisi.
Kerangka juga mengubah percakapan dengan Anda. Alih-alih “Saya mencoba menghasilkan pesanan dan gagal”, agen dapat mengatakan “templat ini membutuhkan daftar baris, masing-masing dengan judul dan kuantitas; saya menemukan tiga dalam email Anda, ini dia”, dan baru kemudian menghasilkan. Inspeksi murah, tidak memerlukan data dan tidak menyentuh apa pun, sehingga ini panggilan pertama yang tepat untuk setiap templat yang belum pernah dilihat agen sebelumnya, dan panggilan yang tepat lagi setiap kali seseorang mengedit templat tersebut.
Tiga kegagalan, tiga jawaban
masalah templat apa yang dikatakan server solusinya
------------------------ ---------------------------- -------------------
{{name}} placeholder "2 '{{...}}' placeholder(s). tulis <<[name]>> ... tidak memproses sintaks itu"
<<foreach>> tidak pernah ditutup "Akhir templat yang tidak terduga. tambahkan <</foreach>> Tag blok tidak ditutup"
data tidak memiliki bidang "Templat membaca 'Email', tambahkan, atau data tidak memilikinya" allowMissingMembers
Sintaks yang salah. Banyak templat di dunia nyata ditulis untuk mesin lain dan menggunakan {{name}}. GroupDocs.Assembly membiarkannya sebagai teks, dan inspeksi memberi tahu hal itu sebelum siapa pun membuang waktu menjalankan:
-> get_template_fields {"template":{"filePath":"shipping-notice.docx"}}
<- { "tagCount": 0, "notes": [ "No <<…>> tags were found: ...",
"The template contains 2 '{{…}}' placeholder(s). GroupDocs.Assembly
does not process that syntax and leaves it as text; write
<<[name]>> instead." ] }
Blok yang tidak ditutup. order-lines.docx kami membuka <<foreach>> dan tidak pernah menutupnya. Inspeksi dengan senang hati mencantumkan tag-tag; generasi tidak:
-> assemble_document {"template":{"filePath":"order-lines.docx"},
"dataJson":"{\"lines\":[{\"Title\":\"Cable\",\"Quantity\":2}]}"}
<- Document assembly failed for 'order-lines.docx': ...
Unexpected end of template. A block tag is not closed: every
<<foreach>> needs <</foreach>> and every <<if>> needs <</if>>.
Bidang yang hilang. Ketika data tidak memiliki sesuatu yang dibaca templat, kesalahan menyebutkan bidang tersebut, menyatakan nama bersifat case-sensitive, dan menawarkan opsi: allowMissingMembers: true tidak menghasilkan apa pun untuk anggota yang hilang dan daftar kosong alih-alih gagal. Petunjuk itu lebih luas daripada mesin, seperti yang ditunjukkan pada bagian berikut: daftar kosong masih gagal ketika templat melakukan aritmetika pada anggotanya.
Ketika templat penuh dengan kesalahan
Beberapa templat memiliki beberapa kesalahan, dan memperbaikinya satu kali gagal pada satu waktu sangat lambat. inlineErrors: true mengubah templat menjadi laporan kesalahan sendiri: dokumen dihasilkan dan setiap tag yang salah mendapatkan pesannya ditulis di sebelahnya. Pada contoh templat dari contoh GroupDocs.Assembly:
-> assemble_document {"template":{"filePath":"inline-error.docx"},
"dataJson":"{\"name\":\"x\"}","inlineErrors":true}
<- Assembled 'inline-error.docx' ... The template has errors: each one
is written into the output next to its tag, starting with 'Error!'
Output berisi << var [name] Error! An assignment operator is expected. >>, di tempat dalam dokumen tempat tag berada. Buka file, perbaiki setiap tag yang ditandai, jalankan lagi tanpa flag.
Apa yang tidak dapat dilihat inspeksi
Templat Outlook biner adalah pengecualian. Tag file .msg tidak dapat dibaca tanpa menghasilkan, dan server memberi tahu hal itu alih-alih mengembalikan daftar kosong yang terlihat seperti “tidak ada bidang”:
-> get_template_fields {"template":{"filePath":"contracts-table.msg"}}
<- { "readable": false, "notes": [ "Tags cannot be read from a .msg
template without generating it. Save the template as DOCX, XLSX,
PPTX or EML to inspect it, or generate it with assemble_document
and inlineErrors=true to see which fields fail." ] }
Satu lagi jebakan yang kami temui: daftar yang kosong dalam data tidak memiliki tipe anggota. Templat kontrak kami mengalikan item.Quantity * item.UnitPrice; dengan "items": [] dan allowMissingMembers: true, generasi masih gagal dengan “Can not apply operator ‘’ to operands of type ‘System.Object’ and ‘System.Object’”*. Guard yang jelas, <<if [items.Any()]>> di sekitar tabel, tidak membantu: mesin memeriksa setiap ekspresi sebelum menjalankan apa pun. Yang berhasil adalah menjaga aritmetika di luar baris. Dengan jumlah sudah ada dalam data (<<[item.Amount]>>), daftar kosong yang sama dan allowMissingMembers: true menghasilkan dokumen, dan <<if [items.Count() == 0]>>No services ordered.<</if>> mencetak barisnya. Jika tidak, minta agen memeriksa bahwa daftar tidak kosong sebelum menghasilkan, dan tanyakan kepada Anda seperti apa kontrak kosong seharusnya.
Batasan jujur
- Inspeksi bersifat statis: proyeksi
SelectdanGroupBytidak diikuti, dan templat.msgtidak dapat dibaca. - Templat adalah input yang dipercaya; tag gambar dan dokumen memuat jalur dan URL yang dikembalikan oleh ekspresi mereka.
- Mode evaluasi: setiap output dimulai dengan “Evaluation Only. Created with GroupDocs.Assembly 26.7…”.
- Tanggal: kirim
2026-11-12T00:00:00dan format dalam templat dengan:"d MMMM yyyy"; string tanggal saja bergeser satu hari pada mesin UTC+2, dan"12.11.2026"dibaca sebagai 11 Desember.
FAQ
Bagaimana saya dapat melihat bidang apa yang dibutuhkan templat Word?
Minta agen untuk memanggil get_template_fields pada templat tersebut. Anda akan mendapatkan tag, nama data, dan kerangka JSON, secara lokal, tanpa menghasilkan apa pun.
Mengapa templat saya mencetak {{name}} alih-alih nilai?
Karena tag GroupDocs.Assembly adalah <<[name]>>. Inspeksi server menandai placeholder {{…}} dan memberi tahu apa yang harus ditulis sebagai gantinya.
Apakah Markdown dapat menjadi templat?
Ya. product-readme.md kami dengan tag <<[product]>> dan <<[description]>> diinspeksi seperti file Word dan dihasilkan langsung ke DOCX.
Selami lebih dalam
- Dokumentasi, panduan kanonik: Cara mengetahui apa yang dibutuhkan sebuah template dan mengapa gagal
- Pusat dokumentasi: GroupDocs.Assembly MCP Server
- Halaman produk GroupDocs.Assembly MCP — instalasi satu klik untuk VS Code dan Cursor, konfigurasi untuk setiap klien lainnya
- Mulai di sini: Biarkan model mengisi data, bukan menulis dokumen
- Terkait: Seratus PDF dipersonalisasi dari satu prompt: mail merge dengan agen AI
- Terkait: Grafik berasal dari templat, angka berasal dari data
- Terkait: Repositori Anda sudah memiliki data; biarkan agen membuat PDF
- Model on-premise dan keamanan: 3 arsitektur untuk pemrosesan dokumen AI, dan yang menyimpan file di dalam jaringan Anda
- Pertanyaan: Forum GroupDocs Assembly
- Sumber: GroupDocs.Assembly.Mcp di GitHub