Budżet ma trzy arkusze, a dział finansów chce zmienić dwie komórki w drugim z nich. Przekazanie całego skoroszytu agentowi AI, aby „zaktualizował Q3”, zachęca go do przetworzenia wszystkich trzech. Przy uruchomionym lokalnie serwerze GroupDocs.Editor MCP, Claude, Cursor lub Copilot wyodrębniają tylko ten arkusz jako edytowalny HTML, wprowadzają żądane zmiany i zapisują go z powrotem do kopii oryginalnego skoroszytu, więc pozostałe arkusze nigdy nie przechodzą przez model. Slajdy działają w ten sam sposób:
W pliku budget.xlsx, w arkuszu 2 (Q3), ustaw Travel na 12 500 i zmień nazwę Training na „Training (external)”. Pozostałe arkusze pozostaw bez zmian.
Wersja krok po kroku znajduje się w dokumentacji: Jak edytować jeden arkusz lub slajd i wstawić go z powrotem do oryginału.
Dlaczego nie przekazywać agentowi całego pliku?
Ponieważ model nie może przechowywać skoroszytu. Może przechowywać tekst. Każdy arkusz, który mu przekażesz, może „pomocniczo” przekształcić: liczby sformatowane inaczej, formuła zamieniona na jej wartość, kolumna, której nie rozumiał, pominięta. Nawet gdy nic nie pójdzie nie tak, nie możesz tego stwierdzić na podstawie odpowiedzi. Rozwiązaniem jest ograniczenie zakresu: podaj agentowi dokładnie tę część, którą ma zmienić, i trzymaj resztę poza jego zasięgiem.
HTML jest odpowiednim formatem dla tej części. Tabele, style, czcionki i obrazy w nim przetrwają, modele dobrze go odczytują i zapisują, a on odzwierciedla pierwotną strukturę. Zwykły tekst straciłby formatowanie; surowy XML .xlsx to labirynt, którego żaden agent nie powinien edytować.
Podróż w dwie strony
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+
Co zwrócił serwer
Zarejestrowano z GroupDocs.Editor.Mcp 26.10.0 na syntetycznym budżecie:
-> 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
Otworzenie wyniku potwierdza zakres: w Q3 Travel wynosi 12500, a wiersz zawiera „Training (external)”; Hosting i Support pozostają niezmienione; Summary i Q4 są takie, jakie były. Oryginalny budget.xlsx nie został zmodyfikowany.
Narzędzia odwołują się do arkuszy i slajdów po numerze, a nie po nazwie; get_document_info zwraca ich liczbę, dlatego w zapytaniu pojawia się „worksheet 2 (Q3)”. Odpowiedź z wyodrębnieniem zawiera podgląd w zwykłym tekście, więc agent może sprawdzić, czy ma właściwy arkusz, zanim coś edytuje, oraz linię „Next:”, która wskazuje, które wywołanie następuje dalej. Agenci dobrze podążają za tymi wskazówkami. W przypadku slajdu podgląd może zaczynać się od tekstu zastępczego mastera („Click to edit Master title style”), więc agent powinien sprawdzić sam HTML.
Slajdy i jedna zasada dla prezentacji
Ten sam zestaw działa na prezentacji: extract_html z "slide": 2, edycja, save_from_html z "slide": 2 i oryginałem jako sourceFile. W naszym teście slajd 2 z trzy‑slajdowej prezentacji przeglądowej został wyeksportowany jako HTML, „12 percent” zmieniło się na „14 percent” i wrócił jako review-revised.pptx z nienaruszonymi slajdami 1 i 3.
Dla PowerPoint sourceFile nie jest opcjonalny. Sam HTML nie zawiera mastera slajdów, a serwer to zgłasza zamiast tworzyć uszkodzoną prezentację:
-> 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'.
Komunikat wymienia brakujący argument, więc agent sam poprawia wywołanie.
Kiedy podróż w dwie strony przewyższa znajdź i zamień
replace_text jest krótszą drogą dla pojedynczego słowa lub nazwy. Podróż w dwie strony służy do wszystkiego innego: zmiany kilku komórek jednocześnie, przekształcenia etykiety i liczby razem, restrukturyzacji tabeli na slajdzie lub frazy, której replace_text nie widzi, ponieważ jest podzielona na dwa fragmenty formatowania. To także sposób, w jaki agent najpierw odczytuje część, zanim zdecyduje, co zmienić.
Czytanie przed zapisem
Pierwsza połowa podróży w dwie strony jest przydatna sama w sobie. Agent zapytany „co jest zaplanowane na podróże w Q3 i kto jest za to odpowiedzialny?” może wyodrębnić arkusz Q3 i odpowiedzieć na podstawie HTML, nie dotykając niczego, a agent, który ma dokonać edycji, powinien najpierw zrobić to właśnie: przeczytać część, określić zamierzoną zmianę, a potem zapisać. Umieść tę kolejność w instrukcjach projektu, aby stała się domyślna:
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.
Ostatnie zdanie ma największe znaczenie. „Zmieniono Travel z 9000 na 12500 i zmieniono nazwę Training w Q3” to odpowiedź, którą recenzent może zweryfikować w pliku w ciągu kilku sekund.
Szczere ograniczenia
- Tryb ewaluacji edytuje tylko pierwsze dwa arkusze lub slajdy, a serwer odrzuca trzeci z powodu: „Evaluation mode edits only the first 2 visible worksheets of a workbook; worksheet 3 is beyond them.”
- Zapis bez licencji to wersje robocze: edytowany arkusz otrzymuje wiersz banera na górze, a skoroszyt dostaje dodatkowy arkusz „Evaluation Warning”.
- Wyodrębniony HTML z uruchomienia bez licencji zaczyna się od tej samej linii ewaluacji (pokazana w podglądzie powyżej), więc agent powinien edytować komórki, a nie tę linię.
- Numery arkuszy i slajdów są liczone od 1, wliczając ukryte. Ukryty slajd wymaga
showHidden: true; ukryty arkusz jest odrzucany niezależnie od wartościshowHidden, więc najpierw odmaskuj go w skoroszycie.
FAQ
Czy edycja jednego arkusza zmienia pozostałe?
Nie. Edytowany HTML zastępuje tylko wskazany arkusz w kopii oryginału; reszta jest przenoszona z pliku źródłowego.
Czy mogę to zrobić ze slajdami PowerPoint?
Tak, używając "slide" zamiast "worksheet" oraz przekazując oryginał jako sourceFile, co wymaga wyjście PowerPoint.
Gdzie trafia wynik?
Do nowego pliku w folderze storage, budget-q3-revised.xlsx tutaj, ponieważ podaliśmy outputName; oryginał pozostaje niezmieniony.
Zagłęb się
- Dokumentacja, kanoniczny przewodnik: Jak edytować jeden arkusz lub slajd i wstawić go z powrotem do oryginału
- Centrum dokumentacji: GroupDocs.Editor MCP Server
- GroupDocs.Editor MCP product page — instalacja jednym kliknięciem dla VS Code i Cursor, konfiguracje dla każdego innego klienta
- Zacznij tutaj: Dlaczego agent AI nie powinien przepisywać twojego dokumentu, aby zmienić trzy słowa
- Powiązane: Zmien nazwę strony w 40 kontraktach bez zmiany formatowania
- Powiązane: Wypełnij formularze Word z arkusza kalkulacyjnego przy użyciu agenta AI, lokalnie
- Powiązane: Edytować PDF przy pomocy agenta AI? Najpierw przekształć go w Word, lokalnie
- Na miejscu i model bezpieczeństwa: 3 architektury przetwarzania dokumentów AI i ta, która trzyma pliki w twojej sieci
- Pytania: GroupDocs Editor forum
- Źródło: GroupDocs.Editor.Mcp na GitHubie · pakiet NuGet