Anggaran memiliki tiga lembar kerja, dan keuangan menginginkan dua sel diubah pada lembar kerja kedua. Menyerahkan seluruh buku kerja ke agen AI untuk “memperbarui Q3” mengundangnya untuk membangun ulang ketiganya. Dengan server GroupDocs.Editor MCP yang berjalan secara lokal, Claude, Cursor, atau Copilot mengekstrak hanya lembar kerja itu sebagai HTML yang dapat diedit, mengubah apa yang Anda minta, dan menyimpannya kembali ke salinan buku kerja asli, sehingga lembar lain tidak pernah melewati model. Slide berfungsi dengan cara yang sama:

Di budget.xlsx, pada lembar kerja 2 (Q3), setel Travel menjadi 12.500 dan ganti nama Training menjadi “Training (external)”. Biarkan lembar lain tidak berubah.

Versi langkah‑demi‑langkah ada dalam dokumentasi: How to edit one worksheet or slide and splice it back into the original.

Mengapa tidak menyerahkan seluruh file ke agen?

Karena model tidak dapat menampung sebuah buku kerja. Ia hanya dapat menampung teks. Setiap lembar yang Anda berikan kepadanya adalah lembar yang mungkin “dengan baik” ia ulangi: angka diformat ulang, formula diubah menjadi nilainya, kolom yang tidak dipahaminya dihapus. Bahkan ketika tidak ada yang salah, Anda tidak dapat mengetahuinya dari balasannya. Solusinya adalah mempersempit ruang lingkup: berikan agen tepat bagian yang diminta untuk diubah dan jauhkan sisanya.

HTML adalah bentuk yang tepat untuk bagian itu. Tabel, gaya, font, dan gambar tetap ada di dalamnya, model dapat membaca dan menulisnya dengan baik, dan ia dapat dipetakan kembali ke struktur asli. Teks biasa akan kehilangan pemformatan; XML .xlsx mentah adalah labirin yang tidak boleh diedit oleh agen.

Siklus bolak‑balik

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+

Apa yang dikembalikan server

Diambil dari GroupDocs.Editor.Mcp 26.10.0 terhadap anggaran sintetis:

-> 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

Membuka hasilnya mengonfirmasi ruang lingkup: pada Q3, Travel menjadi 12500 dan barisnya berbunyi “Training (external)”; Hosting dan Support tidak berubah; Summary dan Q4 tetap seperti semula. budget.xlsx asli tidak dimodifikasi.

Alat‑alat tersebut menangani lembar kerja dan slide berdasarkan nomor, bukan nama; get_document_info mengembalikan jumlahnya, itulah mengapa prompt menyebutkan “worksheet 2 (Q3)”. Respons ekstraksi menyertakan pratinjau teks biasa, sehingga agen dapat memeriksa bahwa ia memiliki lembar kerja yang tepat sebelum mengedit apa pun, serta baris “Next:” yang memberi tahu panggilan apa yang harus dilakukan selanjutnya. Agen mengikuti petunjuk itu dengan baik. Untuk slide, pratinjau mungkin dimulai dengan teks placeholder master (“Click to edit Master title style”), jadi agen harus memeriksa HTML itu sendiri.

Slide, dan satu aturan untuk presentasi

Pasangan yang sama bekerja pada dek: extract_html dengan "slide": 2, edit, save_from_html dengan "slide": 2 dan dokumen asli sebagai sourceFile. Pada percobaan kami, slide 2 dari dek tiga slide tinjauan diekspor sebagai HTML, “12 percent” menjadi “14 percent”, dan kembali sebagai review-revised.pptx dengan slide 1 dan 3 tetap utuh.

Untuk PowerPoint, sourceFile tidak opsional. HTML saja tidak membawa master slide, dan server memberi tahu hal itu alih‑alih menghasilkan dek yang rusak:

-> 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'.

Pesan tersebut menyebutkan argumen yang hilang, sehingga agen memperbaiki panggilan tersebut sendiri.

Ketika siklus bolak‑balik mengalahkan temukan‑dan‑ganti

replace_text adalah jalur yang lebih singkat untuk satu kata atau nama. Siklus bolak‑balik digunakan untuk segala hal lainnya: mengubah beberapa sel sekaligus, merombak label dan angka bersama, menyusun ulang tabel pada slide, atau frasa yang replace_text tidak dapat lihat karena terpecah menjadi dua run pemformatan. Ini juga cara agen membaca bagian sebelum memutuskan apa yang akan diubah.

Membaca sebelum menulis

Separuh pertama siklus bolak‑balik berguna sendiri. Agen yang ditanya “apa yang direncanakan untuk travel di Q3, dan siapa pemiliknya?” dapat mengekstrak lembar Q3 dan menjawab dari HTML tanpa menyentuh apa pun, dan agen yang akan mengedit sebaiknya melakukan hal itu terlebih dahulu: membaca bagian, menyatakan perubahan yang akan dilakukan, lalu menulis. Masukkan urutan itu ke dalam instruksi proyek Anda sehingga menjadi standar:

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.

Baris terakhir paling penting. “I changed Travel from 9000 to 12500 and renamed Training on Q3” adalah balasan yang dapat diperiksa reviewer terhadap file dalam hitungan detik.

Batasan yang jujur

  • Mode evaluasi hanya mengedit dua lembar kerja atau slide pertama, dan server menolak yang ketiga dengan alasan: “Evaluation mode edits only the first 2 visible worksheets of a workbook; worksheet 3 is beyond them.”
  • Penyimpanan tanpa lisensi menghasilkan draf: lembar yang diedit mendapatkan baris banner di bagian atas dan buku kerja mendapatkan lembar tambahan “Evaluation Warning”.
  • HTML yang diekstrak pada run tanpa lisensi dimulai dengan baris evaluasi yang sama (pratinjau di atas memperlihatkannya), jadi agen harus mengedit sel, bukan baris itu.
  • Nomor lembar kerja dan slide dimulai dari 1, termasuk yang tersembunyi. Slide tersembunyi memerlukan showHidden: true; lembar kerja tersembunyi ditolak apa pun nilai showHidden, jadi munculkan dulu di buku kerja.

FAQ

Apakah mengedit satu lembar mengubah yang lain?
Tidak. HTML yang diedit menggantikan hanya lembar kerja yang Anda sebutkan, dalam salinan file asli; sisanya dibawa dari file sumber.

Bisakah saya melakukan ini dengan slide PowerPoint?
Ya, dengan "slide" alih‑alih "worksheet", dan file asli diberikan sebagai sourceFile, yang diperlukan untuk output PowerPoint.

Ke mana hasilnya disimpan?
Ke file baru di folder penyimpanan, budget-q3-revised.xlsx di sini karena kami menyertakan outputName; file asli tetap tidak tersentuh.

Selami lebih dalam