Bir AI ajanına “Contoso için hizmet sözleşmesini yaz” komutunu verin ve o, kendi kelimeleriyle, kendi başlıklarıyla ve kafasından hesapladığı bir toplamla yanıt verir. Bu, yanlış bir iş bölümü olur. GroupDocs.Assembly.Mcp yerel olarak çalıştırıldığında (dnx GroupDocs.Assembly.Mcp --yes), Claude Desktop, Cursor veya Copilot, Word şablonunuzun hangi alanlara ihtiyacı olduğunu sorar, notlarınızdan doldurur ve motor, modeli düzeni dokunmadan sözleşmeyi, tabloyu ve aritmetiği dahil ederek PDF olarak oluşturur:
Bu sipariş için contract-template.docx dosyasını kullanarak hizmet sözleşmesini oluşturun ve PDF olarak kaydedin: Contoso Pharma, Keizersgracht 210 Amsterdam, iletişim Dr. Lena Brandt; 12 ay yönetilen barındırma 4.800 EUR, 12 ay destek 1.200 EUR, bir onboarding atölyesi 3.500 EUR; %5 indirim.
Adım adım yapılandırma ve sorun giderme sürümü belgelerde bulunabilir: AI ajanlarıyla şablonlardan belge oluşturma (MCP).
Modelin belgeyi yazmaması neden gerekir?
Üretilen bir belge, fark edilmesi zor hatalar içerir. Düzen, yasal olarak onaylanmış olandan sapar. Bir madde, iyi okunup başka bir anlam taşıyan bir şekilde yeniden ifade edilir. Toplam, çarpma yerine bir sonraki token tahminiyle ortaya çıkar. Ve her çalıştırma biraz farklıdır, bu yüzden geçen ayki inceleme bu ayki sözleşme hakkında hiçbir şey söylemez.
Bir şablon bu durumu tersine çevirir. Legal, contract-template.docx dosyasının başlıklarını, imza bloğunu ve <<[customer.Name]>> etiketlerini kontrol eder. Modelin işi, iyi olduğu bölüme küçülür: bir e‑posta ya da notlar kümesini okuyup yapılandırılmış değerler haline getirmek. Motor geri kalanını yapar, her seferinde aynı şekilde.
Ajan neyi dolduracağını nasıl bilir?
Şablona sorar. get_template_fields motoru çalıştırmadan etiketleri okur ve şablonun kullandığı adları, okunan tüm alanları ve doldurulacak bir JSON iskeletini döndürür. İşte sunucunun sözleşme şablonumuz için döndürdüğü:
-> get_template_fields {"template":{"filePath":"contract-template.docx"}}
<- { "tagCount": 17,
"dataSourceNames": [ "contract", "customer", "items" ],
"dataSkeleton": {
"contract": { "Number": "", "Date": "2026-01-31T00:00:00",
"Discount": "" },
"customer": { "Name": "", "Address": "", "Contact": "",
"Email": "" },
"items": [ { "Title": "", "Quantity": 0, "UnitPrice": 0 } ] } }
Bu iskelet, model ile belge arasındaki sözleşmedir. Ajan, sipariş metninden doldurur ve dataJson olarak geri gönderir. Örnek tarih: şablon contract.Date değerini tarih olarak biçimler, bu yüzden iskelet bir zaman içeren ISO tarih ister.
Ajan bir alanı unutursa ne olur?
Tam olarak bildirilir. Test çalıştırmalarımızdan birinde, ajanın ilk denemesi müşterinin e‑posta adresini atladı. Sunucu reddetti ve eksikliği belirtti:
-> assemble_document {"template":{...},"dataJson":"{... no Email ...}"}
<- Document assembly failed for 'contract-template.docx': ...
Can not get the value of member 'Email' on type ''. The template
reads 'Email', which the data does not have. Check the spelling
(names are case-sensitive) with get_template_fields and add it to
the data. ... pass allowMissingMembers=true to output nothing for
missing members and empty lists.
Serbest metin yazan bir model bu satırı sessizce atardı. Burada ajan sizden adresi sorabilir ya da alanın boş kalabileceğine sizinle karar verebilir. O çalıştırmada adres eklendi ve anlaşma numarasıyla kaydedilen yeniden deneme başarılı oldu:
-> assemble_document {"template":{"filePath":"contract-template.docx"},
"dataJson":"{...}","outputName":"SA-2026-118-contoso.docx"}
<- Assembled 'contract-template.docx' with inline JSON (JSON object)
as DOCX
Saved to: .../SA-2026-118-contoso.docx
Tüm iletişim
Sipariş metninin her şeyi içerdiği bir çalıştırma, kayıtlarda şöyle:
user agent Assembly MCP server
| "Make the contract for this order: ..." |
|-------------->| |
| |-- get_template_fields |
| | {"template":{"filePath": |
| | "contract-template.docx"}} ------------>|
| |<- dataSkeleton: contract, customer, items --|
| | (fills the skeleton from the order text) |
| |-- assemble_document {"dataJson":"{...}", |
| | "format":"pdf"} ----------------------->|
| |<- Saved to: .../contract-template_ |
| | assembled.pdf ----------------------------|
|<- "Contract ready: 3 items, total 75500 EUR, 5% discount." |
layout, table and arithmetic come from the template
Son çağrısı (veri gizlenmiş, satırlar kaydırılmış):
-> assemble_document {"template":{"filePath":"contract-template.docx"},
"dataJson":"{...}","format":"pdf"}
<- Assembled 'contract-template.docx' with inline JSON (JSON object)
as PDF
Saved to: .../contract-template_assembled.pdf
Belge, tablo satırındaki bir <<foreach>> ile oluşturulan üç satırlık ücret tablosu, şablondaki (<<[item.Quantity * item.UnitPrice]>>) hesaplanan tutarlar, items.Sum(...) ile elde edilen 75500 EUR toplamı ve veride bir indirim bulunduğunda <<if>> etiketi sayesinde ortaya çıkan “A discount of 5 percent applies.” satırını içerir. Model bunların hiç birini hesaplamamıştır.
Bu, barındırılan şablon hizmetinden daha iyi mi?
Farklı bir takas söz konusudur. Barındırılan şablon hizmetleri şablonunuzu ve verinizi HTTPS üzerinden alır, bulutlarında işler ve belge başına ya da kredi başına ücretlendirir. Burada şablon, veri ve çıktı makinenizdeki bir klasörde kalır; motor, süreç içinde çalışan GroupDocs.Assembly’dır ve hiçbir şey bir port üzerinden dinlemez. Model sağlayıcınıza gönderilen sadece yapıştırdığınız sipariş metni ve ajanın doldurduğu iskelet, render edilmiş sözleşme değildir. Mimari, [on‑premise AI document processing] (https://blog.groupdocs.com/total/on-premise-ai-document-processing-mcp/) başlıklı aile gönderisinde açıklanmıştır.
Dürüst sınırlamalar
- Değerlendirme modu: her oluşturulan belge “Evaluation Only. Created with GroupDocs.Assembly 26.7…” satırıyla başlar, kaydedilen çalışma kitapları ekstra bir çalışma sayfası kazanır ve e‑posta şablonları yalnızca düz metin gövdesini tutar. Bir lisans dosyası ya da ölçülen anahtarlar bu üçünü de kaldırır.
- Şablon sözdizimi
<<[name]>>.{{name}}yer tutucular metin olarak kalır;get_template_fieldsbunu söyler. - Şablonlar güvenilir girdi olarak kabul edilir: resim ve belge etiketleri, ifadesi döndürdüğü yol ya da URL’yi yükler. Sunucu için bir klasör bağlayın.
- Tarihler:
2026-11-12T00:00:00şeklinde yazın ve şablonda biçimlendirin (<<[contract.Date]:"d MMMM yyyy">>). Sadece tarih"2026-11-12"UTC+2 makinede testimizde 12 Kasım olarak basıldı. - Ajan veri kaynağıdır. Render etmeden önce çıkardığı değerleri listelemesini isteyin ve gözden geçirin.
SSS
Bir AI ajanı Word şablonumu yüklemeden doldurabilir mi?
Evet. Sunucu yerel olarak stdio üzerinden çalışır ve yapılandırdığınız klasörden şablonu okur; çıktı yanına yazılır.
Şablon hangi formatlarda olabilir?
Word, Excel, PowerPoint, Markdown, HTML, metin ve e‑posta şablonları; her biri kendi formatına ya da PDF ve diğerlerine kaydedilebilir. get_supported_formats her şablon için bunları listeler.
Şablon başka biri tarafından yönetiliyorsa ne olur?
Tam da bu amaçla. Şablonu kim sahiplenirse o madde ve düzeni değiştirir; ajan aynı iskeleti doldurmaya devam eder ve get_template_fields bir sonraki sefer yeni bir alan varsa onu gösterir.
Daha derine in
- Dokümantasyon, resmi nasıl‑yapılır: AI ajanlarıyla şablonlardan belge oluşturma (MCP)
- Bir e‑posta ya da nottan belgeye: Notları ya da bir e‑postayı AI ajanıyla tamamlanmış belgeye dönüştürme
- Dokümantasyon merkezi: GroupDocs.Assembly MCP Server
- GroupDocs.Assembly MCP ürün sayfası — VS Code ve Cursor için tek‑tık kurulum, diğer istemciler için yapılandırmalar
- İlgili: Bir istemden yüzlerce kişiselleştirilmiş PDF: AI ajanıyla posta birleştirme
- İlgili: Bu şablon neye ihtiyaç duyuyor? Sorun.
- İlgili: Grafik şablondan, sayılar veriden gelir
- İlgili: Depoda zaten veri var; ajan PDF’yi oluştursun
- Motorun yenilikleri: GroupDocs.Assembly for .NET 26.7
- Yerel ve güvenlik modeli: AI belge işleme için 3 mimari ve dosyaları ağınız içinde tutanı
- Sorular: GroupDocs Assembly forumu
- Kaynak: GroupDocs.Assembly.Mcp GitHub’da · NuGet paketi