Váš dodavatel byl převzat a „ACME Corp“ je nyní „Globex Ltd“ v každé smlouvě, plánu, rozpočtu a prezentaci, která ho zmiňuje. S lokálně běžícím serverem GroupDocs.Editor MCP, Claude Desktop, Cursor nebo Copilot to provádí jako dávku: pro každý soubor ve složce zavolá replace_text, zachová formátování, nahlásí, kolik výskytů změnil, a pro soubory, které starý název nikdy nezmiňovaly, nic nezapíše. Nic není nahráváno a žádný originál není přepsán:

Přejmenujte ACME Corp na Globex Ltd v každém dokumentu ve složce contracts, zachovejte formátování a dejte mi počet na soubor.

Verze krok za krokem je v dokumentaci: Jak najít a nahradit text napříč složkou dokumentů bez poškození formátování.

Proč je to úkol pro nástroj a ne pro model?

Protože výsledek musí být ověřitelný. Čtyřicet dokumentů je příliš mnoho na vizuální porovnání a model, který „aktualizoval všechny smlouvy“, vám nedává nic, proti čemu byste mohli kontrolovat. Nástroj pro hledání a nahrazování vám poskytne číslo pro každý soubor. Čísla tvoří auditní stopu: víte, které soubory se změnily, o kolik, a které nebyly potřeba měnit.

Musí být také nudný správným způsobem. Tučný název strany zůstane tučný, tabulka poplatků si zachová mřížku, nadpisy si ponechají své styly. Model nikdy nepřepisuje dokument: engine jej otevře, nahradí slova a zapíše kopii. Jedna úskalí na serveru 26.10.0: tato kopie je vytvořena z HTML editačního modelu engine a footer ve Wordu se nepřenáší. Smlouva, která uvádí dodavatele v patičce, potřebuje místo toho paginovaný HTML round‑trip; FAQ uvádí, co Word dokument zachovává.

Co agent vidí

Zachyceno z GroupDocs.Editor.Mcp 26.10.0 na malé syntetické sadě: smlouva o službách, NDA, uvítací dopis, rozpočet o třech listech a prezentační balíček o třech slidech.

-> replace_text {"file":{"filePath":"contracts/msa-northwind.docx"},
     "find":"ACME Corp","replace":"Globex Ltd","wholeWord":true}
<- Replaced 6 occurrence(s) of 'ACME Corp' in 'msa-northwind.docx'
   Saved to: …/msa-northwind_edited.docx

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"}, ...}
<- Replaced 1 occurrence(s) of 'ACME Corp' in 'nda-northwind.docx'

-> replace_text {"file":{"filePath":"contracts/welcome-letter.docx"}, ...}
<- Text replacement found no matches for 'ACME Corp' in
   'welcome-letter.docx'. No file was written.

-> replace_text {"file":{"filePath":"budget.xlsx"}, ..., "worksheet":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in worksheet 1 of 3 of
   'budget.xlsx'

-> replace_text {"file":{"filePath":"review.pptx"}, ..., "slide":1}
<- Replaced 1 occurrence(s) of 'ACME Corp' in slide 1 of 3 of
   'review.pptx'

Zpráva agenta se napíše sama: šest ve smlouvě, jedna v NDA, žádná v uvítacím dopise, jedna v souhrnu rozpočtu, jedna na první slide.

Smyčka

contracts/ + budget.xlsx + review.pptx
   |
   +-- for each file:
   |      replace_text {"find":"ACME Corp","replace":"Globex Ltd",
   |                    "wholeWord":true}   (+ "worksheet"/"slide")
   |         -> "Replaced N occurrence(s) ..."  -> <name>_edited.<ext>
   |         -> "found no matches ... No file was written."
   |
   '-- report: file -> count; files with 0 listed separately

Dvě návyky dělají smyčku spolehlivou. Používejte wholeWord: true pro jména, aby „ACME Corp“ neodpovídalo uvnitř „ACME Corporation Holdings“. A požádejte agenta, aby vypsal soubory s nulovým počtem shod, protože nula v souboru, kde jste očekávali změnu, je to, co stojí za druhý pohled.

Kontrola dávky před jakýmkoli nahrazením

Upravené kopie leží vedle originálů, dokud se nerozhodnete jinak, a právě v tom okamžiku je čas na kontrolu. Tři levné kontroly zachytí téměř každý problém. Porovnejte počty na soubor s tím, co jste očekávali: smlouva, která uvádí dodavatele na každé stránce, by neměla hlásit jen jeden výskyt. Nespoléhejte se na opakované spuštění stejné náhrady: fráze rozdělená mezi formátování bude i podruhé přehlédnuta a „found no matches“ bude vypadat jako čistý výsledek. Požádejte agenta, aby místo toho spustil extract_html na každou upravenou kopii; jeho náhled v prostém textu spojuje formátovací úseky, takže zbylý „ACME Corp“ se objeví. Variantní pravopisy („Acme Corp.“ s tečkou, „ACME Corporation“) si zaslouží vlastní průchod s matchCase: false nebo regulárním výrazem. A otevřete jeden upravený soubor každého typu – smlouvu, sešit a prezentaci – abyste potvrdili, že formátování i patička přežily. Teprve poté přesuňte soubory _edited přes originály, nebo nechte váš dokumentační systém verzovat.

Vzory, velikost písmen a formát v jednom volání

Přejmenování je běžný případ, ale stejný nástroj pokrývá i zbytek rodiny „udělat text konzistentní“. Ve stejném testovacím běhu:

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
     "find":"v2\\.3\\b","replace":"v2.4","regex":true,
     "outputName":"nda-northwind-v2.4.docx"}
<- Replaced 1 occurrence(s) of 'v2\.3\b' in 'nda-northwind.docx'

-> replace_text {"file":{"filePath":"contracts/nda-northwind.docx"},
     "find":"acme corp","replace":"Globex Ltd","matchCase":false,
     "format":"pdf"}
<- Replaced 1 occurrence(s) of 'acme corp' in 'nda-northwind.docx'
   Saved to: …/nda-northwind_edited.pdf

regex: true používá .NET regulární výraz, což je způsob, jakým se verze nebo změna formátu data provádí napříč složkou. matchCase: false zachytí nekonzistentní kapitalizaci. format: "pdf" upravuje a převádí v jednom kroku, pro kopii, která jde na druhou stranu.

Všimnutí pro programovací agenty

Stejný vzor funguje v repozitáři. Poznámky k vydání v DOCX a specifikace v XLSX jsou pro sed neviditelné; Claude Code s tímto serverem může zvýšit verzi řetězce v obou jako součást úkolu vydání. Vložte pravidlo do instrukcí projektu, aby agent používal nástroj místo pokusu rozbalit Office soubory:

To change wording in .docx/.xlsx/.pptx/.pdf files in this repo, use the
groupdocs-editor MCP server's replace_text (wholeWord for names, regex for
versions). Report the count per file. Never rewrite an Office file by hand.

Upřímná omezení

  • Shoda probíhá v rámci jednoho formátovacího úseku. V naší smlouvě byl sedmý „ACME Corp“ s „ACME“ v kurzívě nenahrazen a počet šesti to ukázal. Fráze rozdělené mezi styly potřebují HTML round‑trip.
  • Každý výsledek končí v kořenovém adresáři výstupní složky jako <name>_edited.<ext>, i když originál byl v podadresáři. Nic není přepsáno: pokud je jméno již obsazeno, získá číslo (msa-northwind_edited (1).docx), takže použijte outputName, když by mohlo dojít ke kolizi.
  • Na serveru 26.10.0 upravená kopie Word dokumentu ztrácí patičku a obsahové ovládací prvky jsou zploštěny na prostý text. Zkontrolujte dokumenty, které mají starý název v patičce.
  • Tabulky a prezentace jsou upravovány po jednom listu nebo slideu na volání. V evaluačním režimu lze upravit jen první dva, a server to oznamuje: „Evaluation mode edits only the first 2 slides of a presentation; slide 3 is beyond them.“
  • Evaluační režim také přidává bannerovou řádku ke každému výstupu a PDF delší než dvě stránky je odmítnut.

FAQ

Může nahradit text ve Wordu, Excelu a PowerPointu v jedné dávce?
Ano. Agent volá stejný nástroj pro každý soubor a přidá worksheet nebo slide pro sešity a prezentace.

Jak zjistím, které soubory byly změněny?
Každé volání vrátí počet a soubory bez shody nejsou vůbec zapsány. Požádejte agenta o tabulku po souborech.

Budou originály přepsány?
Ne. Každá úprava zapíše nový soubor; originály zůstávají tak, jak byly, dokud je sami nepřepíšete.

Jděte hlouběji