Bütçenin üç çalışma sayfası var ve finans, ikincisindeki iki hücrenin değiştirilmesini istiyor. Tüm çalışma kitabını bir AI ajanına “Q3’ü güncelle” diye vermek, onu üç sayfayı da yeniden oluşturmak için davet eder. GroupDocs.Editor MCP sunucusu yerel olarak çalışırken, Claude, Cursor veya Copilot yalnızca o çalışma sayfasını düzenlenebilir HTML olarak çıkarır, istediğinizi değiştirir ve orijinal çalışma kitabının bir kopyasına geri kaydeder, böylece diğer sayfalar modelden hiç geçmez. Slaytlar da aynı şekilde çalışır:

budget.xlsx dosyasında, 2. çalışma sayfasında (Q3), Travel’ı 12.500 olarak ayarlayın ve Training’i “Training (external)” olarak yeniden adlandırın. Diğer sayfaları olduğu gibi bırakın.

Adım adım sürüm belgelerde yer alıyor: How to edit one worksheet or slide and splice it back into the original.

Neden tüm dosyayı ajana vermeyelim?

Çünkü bir model bir çalışma kitabını tutamaz. Metin tutabilir. Verdiğiniz her sayfa, modelin “yardımcı” bir şekilde yeniden ifade edebileceği bir sayfadır: sayılar yeniden biçimlendirilir, bir formül değeriyle değiştirilir, anlamadığı bir sütun atılır. Hiçbir şey yanlış gitmese bile, bunu yanıtından anlayamazsınız. Çözüm kapsamdır: ajana tam olarak değiştirmesini istediğiniz kısmı verin ve geri kalanını erişimin dışına tutun.

HTML, bu kısım için doğru formattır. Tablolar, stiller, yazı tipleri ve görseller içinde kalır, modeller onu iyi okur ve yazar, ve orijinal yapıya geri haritalanabilir. Düz metin biçimlendirmeyi kaybeder; ham .xlsx XML’i ise bir ajanın düzenlemesi gereken bir labirenttir.

Gidiş-dönüş

budget.xlsx  (3 worksheets: Summary, Q3, Q4)
   |-- extract_html {"file":{...},"worksheet":2} --> budget_worksheet2.html
   |        agent edits the HTML: Travel 9000 -> 12500,
   |        "Training" -> "Training (external)"
   '-- save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
                       "format":"xlsx",
                       "sourceFile":{"filePath":"budget.xlsx"},
                       "worksheet":2}
         --> budget-q3-revised.xlsx : worksheet 2 replaced, 1 and 3 untouched
evaluation mode: worksheets/slides 1-2 can be edited; the server refuses 3+

Sunucunun döndürdüğü

GroupDocs.Editor.Mcp 26.10.0 sürümüyle sentetik bir bütçe üzerinde yakalandı:

-> extract_html {"file":{"filePath":"budget.xlsx"},"worksheet":2}
<- Extracted worksheet 2 of 3 of 'budget.xlsx' as editable HTML
   Saved to: …/budget_worksheet2.html
   Next: edit the saved .html and call save_from_html to write it back
   as DOCX, XLSX, PPTX, PDF or another format.
   Preview (plain text): ... Cost centre Planned (EUR) Owner Hosting
   57600 IT Support 14400 IT Travel 9000 Sales Training 6000 HR

-> save_from_html {"htmlFile":{"filePath":"budget_worksheet2.html"},
     "format":"xlsx","sourceFile":{"filePath":"budget.xlsx"},
     "worksheet":2,"outputName":"budget-q3-revised.xlsx"}
<- Saved 'budget_worksheet2.html' into a copy of 'budget.xlsx',
   replacing worksheet 2 of 3 (XLSX)
   Saved to: …/budget-q3-revised.xlsx

Sonuç dosyasını açtığınızda kapsam doğrulanır: Q3’te Travel 12500 ve satır “Training (external)” olarak görünür; Hosting ve Support değişmemiştir; Summary ve Q4 olduğu gibi kalmıştır. Orijinal budget.xlsx değiştirilmemiştir.

Araçlar çalışma sayfalarını ve slaytları isim yerine numara ile adresler; get_document_info sayıyı döndürür, bu yüzden istem “worksheet 2 (Q3)” şeklinde. Çıkarma yanıtı düz metin bir önizleme içerir, böylece ajan düzenleme yapmadan önce doğru çalışma sayfasına sahip olduğunu kontrol edebilir ve “Next:” satırı hangi çağrının ardından gelmesi gerektiğini söyler. Ajanlar bu ipuçlarını iyi takip eder. Bir slayt için önizleme, “Click to edit Master title style” gibi ana slayt yer tutucu metniyle başlayabilir, bu yüzden ajan HTML’i kendisi kontrol etmelidir.

Slaytlar ve sunumlar için tek kural

Aynı çift bir sunumda da çalışır: "slide": 2 ile extract_html, düzenle, "slide": 2 ve sourceFile ile save_from_html. Bizim çalıştırmamızda üç slaytlık bir inceleme sunumunun 2. slaytı HTML olarak dışa aktarıldı, “12 percent” “14 percent” olarak değiştirildi ve review-revised.pptx olarak slayt 1 ve 3 aynı kaldı.

PowerPoint için sourceFile isteğe bağlı değildir. HTML tek başına bir slayt ana sayfası taşımaz ve sunucu bozuk bir sunum üretmek yerine bunu söyler:

-> save_from_html {"htmlFile":{"filePath":"review_slide2.html"},
                   "format":"pptx"}
<- Save from HTML failed for 'review_slide2.html' (-> pptx): 'pptx' output
   cannot be created from HTML alone; pass the original document as
   'sourceFile'.

Mesaj eksik argümanı adlandırır, böylece ajan kendi başına çağrıyı düzeltir.

Gidiş-dönüşün bul‑ve‑değiştirme yerine tercih edilmesi

replace_text bir kelime ya da isim için daha kısa yoldur. Gidiş‑dönüş ise diğer her şey için uygundur: birden fazla hücreyi aynı anda değiştirmek, bir etiketi ve sayıyı birlikte yeniden kelimelemek, bir slayt tablosunu yeniden yapılandırmak ya da replace_text iki biçimleme akışı arasında bölündüğü için göremediği bir ifadeyi değiştirmek. Ayrıca ajan, neyi değiştireceğine karar vermeden önce bir bölümü okur.

Yazmadan önce okuma

Gidiş‑dönüşün ilk yarısı tek başına faydalıdır. “Q3’te seyahat için planlanan nedir ve sorumlusu kim?” diye sorulan bir ajan, Q3 sayfasını çıkarıp HTML’den yanıtlayabilir, hiçbir şeyi dokunmadan. Düzenleme yapacak bir ajan da önce bunu yapmalıdır: bölümü oku, yapacağı değişikliği belirt, ardından yaz. Bu sıralamayı proje talimatlarınıza ekleyin, böylece varsayılan hâle gelsin:

To change a worksheet or slide, use the groupdocs-editor MCP server:
extract_html for that one part, edit the HTML, save_from_html with the
original as sourceFile and the same worksheet/slide number. Never rebuild
the whole workbook or deck. Say which cells or text you changed.

Son satır en önemlisidir. “Travel’ı 9000’den 12500’e değiştirdim ve Q3’te Training’i yeniden adlandırdım” gibi bir yanıt, bir gözden geçirenin dosyayı saniyeler içinde kontrol etmesini sağlar.

Dürüst sınırlamalar

  • Değerlendirme modu yalnızca ilk iki çalışma sayfasını veya slaytı düzenler, üçüncüye bir neden göstererek reddeder: “Evaluation mode edits only the first 2 visible worksheets of a workbook; worksheet 3 is beyond them.”
  • Lisanssız kaydetmeler taslak olur: düzenlenen sayfa en üstte bir banner satırı alır ve çalışma kitabına ekstra bir “Evaluation Warning” çalışma sayfası eklenir.
  • Lisanssız bir çalıştırmanın çıkarılan HTML’i aynı değerlendirme satırıyla başlar (önizleme yukarıda gösterildiği gibi), bu yüzden ajan hücreleri o satır yerine düzenlemelidir.
  • Çalışma sayfası ve slayt numaraları 1‑tabanlıdır, gizli olanlar da sayılır. Gizli bir slayt için showHidden: true gerekir; gizli bir çalışma sayfası ise showHidden ne olursa olsun reddedilir, bu yüzden önce çalışma kitabında gizliliği kaldırın.

SSS

Bir sayfayı düzenlemek diğerlerini değiştirir mi?
Hayır. Düzenlenen HTML yalnızca adını verdiğiniz çalışma sayfasını, orijinalin bir kopyasına yerleştirir; geri kalan kaynak dosyadan aktarılır.

Bunu PowerPoint slaytlarıyla yapabilir miyim?
Evet, "worksheet" yerine "slide" kullanarak ve PowerPoint çıktısı için gerekli olan sourceFileı geçirerek.

Sonuç dosyası nereye gider?
Depolama klasöründe yeni bir dosya olarak, burada budget-q3-revised.xlsx olarak (outputName verdiğimiz için) kaydedilir; orijinal doküman dokunulmaz.

Daha derine inin