A text kutuları, bir departman açılır menüsü ve bir davranış kuralları onay kutusu içeren bir Word formu ve otuz yeni işe alım içeren bir elektronik tablo: bu bir kopyala-yapıştır sabahı ya da tek bir istemdir. GroupDocs.Editor MCP sunucusu yerel olarak çalışırken, Claude, Cursor veya Copilot önce formun hangi alanlara sahip olduğunu sorar, ardından her satır için bir kopya doldurur ve her birini kişinin adıyla kaydeder. Formun düzeni dokunulmaz kalır ve eşleşen bir alanı olmayan herhangi bir değer sessizce atlanmak yerine raporlanır:

new-employee-form.docx dosyasını oku, ardından new-hires.csv dosyasının her satırı için bir kopya doldur ve her dosyayı çalışan adıyla adlandır.

Adım adım sürüm belgelerde yer alıyor: Veriyle Word form alanlarını bir AI ajanı ile doldurma.

Elektronik tabloyu kim okur?

Ajan okur ve bu konuda açık olmak gerekir. Editor sunucusu Word formu üzerinde çalışır; CSV ya da çalışma kitabınızı okumaz. Ajan, kendi dosya araçlarıyla satırları okur ya da siz yapıştırırsınız ve ardından her satır için bir fill_form_fields çağrısı yapar, kişi başına bir outputName verir. Bu bölünme bir özelliktir: verilerin sunucunun anlayabileceği bir formatta olması gerekmez ve ajan, form içine girmeden önce (tam adın bölünmesi, tarihin normalleştirilmesi gibi) veriyi temizleyebilir.

Önce formu sor

Word formlardaki alan adları sayfadaki etiketle nadiren aynı olur. Etiket “Full name:” (Tam ad:) şeklinde görünürken alan FullName, Text1 ya da Name_Employee olarak adlandırılmış olabilir. Tahmin etmek, formların yarı boş dönmesinin nedenidir. get_form_fields gerçek adları, tipleri ve mevcut değerleri döndürür. GroupDocs.Editor.Mcp 26.10.0 ile sentetik bir işe alım formu üzerinde yakalanan (kısaltılmış çıktı):

-> get_form_fields {"file":{"filePath":"new-employee-form.docx"}}
<- { "count": 6, "fields": [
     { "name": "FullName",   "type": "Text",     "value": "" },
     { "name": "Email",      "type": "Text",     "value": "" },
     { "name": "StartDate",  "type": "Text",     "value": "" },
     { "name": "Department", "type": "DropDown",
       "value": { "options": [ "Engineering", "Finance", "Sales",
                               "Operations" ], "selected": "Engineering" } },
     { "name": "Agree",      "type": "CheckBox", "value": false },
     { "name": "Newsletter", "type": "CheckBox", "value": false } ] }

Açılır menü seçenekleriyle birlikte gelir, böylece ajan elektronik tablodaki “finance” değerini tam olarak “Finance” girişine eşleyebilir, altıncı bir departman icat etmez.

Ardından bir satırı doldur

-> fill_form_fields {"file":{"filePath":"new-employee-form.docx"},
     "values":{"FullName":"Amara Okafor",
               "Email":"amara.okafor@northwind.example",
               "StartDate":"2026-12-01","Department":"Finance",
               "Agree":"true","Phone":"+31 10 555 0100"}}
<- Updated 5 field(s) in 'new-employee-form.docx': FullName, Email,
   StartDate, Department, Agree.
   Not found: Phone. Call get_form_fields for the exact names.
   Saved to: …/new-employee-form_edited.docx

Elektronik tabloda formun alanı olmayan bir telefon sütunu vardı. Sunucu mevcut beş alanı doldurdu ve olmayanı raporladı. Doldurulmuş kopyayı get_form_fields ile geri okuduğunuzda, "selected": "Finance" ve "Agree": true değerleri yerinde görülür; satır başka bir şey belirtmediği için Newsletter hâlâ işaretlenmemiştir.

Tüm toplu işlem

new-hires.csv (agent reads it)          new-employee-form.docx
  Amara Okafor, Finance, ...  ---+
  Tomas Varga, Sales, ...     ---+      get_form_fields (once)
  ...                            |        -> FullName, Email, StartDate,
                                 |           Department, Agree, ...
                                 v
  fill_form_fields {"values":{...row...},
                    "outputName":"form-amara-okafor.docx"}   x one per row
     -> "Updated 5 field(s) ... Not found: Phone"
     -> form-amara-okafor.docx, form-tomas-varga.docx, ...

Üç talimat toplu işlemi güvenilir kılar: get_form_fields bir kez çağrılır ve sütunlar alan adlarıyla eşlenir; her satıra kendi outputNamei verilir, aksi takdirde kopyalar new-employee-form_edited.docx, new-employee-form_edited (1).docx gibi birikerek kimsenin adı olmadan kalır; ve “Not found” satırları işlem sonunda tek bir raporda toplanır, ilk hatada durmaz.

İlk satırda çalışan bir istem

Çoğu toplu hata birinci satırda ortaya çıkar ve ardından otuz kez tekrarlanır. Önce kuru bir deneme yapın:

new-employee-form.docx dosyasının alanlarını ve new-hires.csv dosyasının başlığını oku. Hangi sütunun hangi alana gittiğini ve hangi sütunların alanı olmadığını göster. Ardından sadece ilk satırı doldur ve dur.

Ajan, Name -> FullName, Dept -> Department, Phone -> (no field) gibi küçük bir eşleme tablosu ve açabileceğiniz doldurulmuş bir form ile yanıt verir. Departman yazımı ya da tarih formatı yanlışsa, bir kez görür, talimatı düzeltir ve ardından geri kalanı sorarsınız. Bu inceleme adımı bir dakikalık bir maliyetle otuz doğru form ile otuz elle kontrol gerektiren form arasındaki farkı yaratır.

Ayrıca elektronik tablonun tek başına yanıtlayamadığı soruları da çözer. Boş bir “Agree” hücresi işaretsiz mi olmalı, yoksa satır atlanmalı mı? “2026-12-01” tarih alanına olduğu gibi mi, yoksa “1 December 2026” olarak mı girilmeli? Ajan ne söylerseniz onu uygular, ancak ona söylemeniz gerekir.

Form araçları başka ne yapar

Metin, sayı ve tarih alanları dize olarak doldurulur; onay kutuları "true" ya da "false" alır; açılır menüler seçeneklerinden birini alır. format doldurulmuş kopyayı DOC, RTF ya da ODT olarak kaydeder, DOCX yerine. Doldurulmuş bir form her zaman bir Word belgesidir, bu yüzden yeni çalışan için PDF ayrı bir dönüşümle elde edilir. Şifre korumalı bir form password ile açılır ve korumalı kalır. Doldurulmuş kopya HTML üzerinden değil, form‑alanı motoru tarafından yazıldığı için başlıklar, altbilgiler ve sayfa numaraları olduğu gibi korunur. Araçlar DOCX, DOC, DOCM, DOT, DOTX, RTF ve ODT formlarını okur.

Dürüst sınırlamalar

  • Sadece Word formları ve yalnızca eski (legacy) form alanları: Word’ün Developer → Legacy Tools menüsünden eklediği metin, onay‑kutusu ve açılır‑menü alanları. İçerik denetimleri listelenmez ya da doldurulmaz. PDF formları (AcroForms) bu sunucunun kapsamı dışındadır.
  • Sunucu elektronik tabloyu okumaz; ajan değerleri sağlar, bu yüzden tüm satırları çalıştırmadan önce ilk satırdaki sütun eşlemesini kontrol edin.
  • Bir çağrı bir formu doldurur. Otuzluk bir toplu işlem otuz çağrı demektir.
  • Değerlendirme modu, her doldurulmuş kopyanın üstüne bir banner satırı ekler; lisanssız çıktı bir taslaktır, yeni çalışanlara gönderilecek bir şey değildir.

SSS

Ajan alan adlarını nasıl öğrenir?
Şunu sorar: get_form_fields her alanın adını, tipini ve mevcut değerini, ayrıca her açılır menünün seçeneklerini döndürür.

Formun alanı olmayan bir değer ne olur?
Atlanır ve yanıt içinde (“Not found: Phone”) raporlanır, böylece ajan bunu bildirebilir.

Orijinal formum değiştirildi mi?
Hayır. Her doldurma yeni bir dosya yazar; şablon bir sonraki satır için boş kalır.

Daha derine in