“Rename ACME Corp to Globex in this contract” je třísekundová práce pro člověka a past pro AI agenta. Zřejmá cesta – přečíst dokument a napsat nový – zahodí styly, okraje tabulek, záhlaví a jistotu recenzenta, že se nic jiného nepřesunulo. S lokálně běžícím serverem GroupDocs.Editor MCP, Claude, Cursor nebo Copilot upravují soubor místo přepisování: najdou slova, nahradí je na místě, zachovají formátování a řeknou vám, kolik změn provedli:

Přejmenujte ACME Corp na Globex Ltd v souboru contract.docx a zachovejte formátování.

Verze krok za krokem se nastavením, výzvami a řešením problémů je v dokumentaci: Jak upravovat dokumenty pomocí AI agentů s MCP.

Co se pokazí, když model přepíše soubor?

Jazykový model neobsahuje .docx. Obsahuje text. Když ho požádáte o „aktualizaci smlouvy“, přirozená cesta je přečíst slova, změnit je a vytvořit nový dokument ze své vlastní kopie. Na cestě se ztratí tři věci.

Formátování. Tučné názvy stran, číslované nadpisy, čáry mřížky tabulky, šířky sloupců tabulky poplatků, zápatí s čísly stránek: nic z toho není součástí textu, který model přečetl, takže to nepřežije cestu, pokud to někdo neobnoví.

Všechno, co model neměl upravovat. Regenerace znamená, že každá věta projde modelem znovu. Klauzule může být „uklizená“, číslo přeformátováno, věta vynechána, protože se zaplnilo okno kontextu. Recenzent nyní musí porovnat celý dokument, aby důvěřoval trojslovné změně.

Auditní stopa. „Aktualizoval jsem smlouvu“ je stejná odpověď, ať model změnil jedno jméno nebo sedm. Neexistuje žádný počet a žádný způsob, jak rozlišit pečlivou úpravu od sebejisté.

Servery pro úpravu pouze DOCX, které již existují, vyřešily první problém pro Word. Další dva a každý formát, který není Word, jsou stále otevřené.

Jak vypadá cílená úprava?

Dvě volání. Zachyceno z GroupDocs.Editor.Mcp 26.10.0 proti syntetické smlouvě o službách, ve které se „ACME Corp“ objevuje sedmkrát:

-> get_document_info {"file":{"filePath":"contract.docx"}}
<- { "family": "WordProcessing", "pageCount": 1, "canEdit": true,
     "canSaveTo": [ "docx", "doc", "rtf", "odt", "pdf", "md", ... ] }

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

-> replace_text {"file":{"filePath":"contract.docx"},
                 "find":"Initech","replace":"Globex Ltd"}
<- Text replacement found no matches for 'Initech' in 'contract.docx'.
   No file was written.

Upravená kopie zachovává tučný název strany, styly nadpisů a tabulku poplatků. Originál zůstává nedotčen; výsledek je nový soubor contract_edited.docx ve složce úložiště.

Proč šest a ne sedm?

Toto je detail, který stojí za přečtení dvakrát. Sedmé „ACME Corp“ se nachází v klauzuli oznámení, kde „ACME“ je kurzívou a „ Corp“ není. V souboru jsou to dva formátovací úseky a replace_text hledá v rámci jednoho úseku. Nehádal a nesloučil styly, aby vynutil shodu; nahlásil šest a sedmé je stále „ACME Corp“.

To je chování, které chcete od nástroje upravujícího smlouvy. Počet nižší, než jste očekávali, je výzvou k prozkoumání; tichý „úplný“ přepis není. Agent může pokračovat druhou cestou, kterou server nabízí: extrahovat tuto část jako HTML, upravit ji a uložit zpět. Příspěvek o round-trip to pokrývá.

Volání v pořadí

user              agent                        Editor MCP server
 |  "Rename ACME Corp to Globex Ltd in contract.docx"          |
 |---------------->|                                           |
 |                 |-- get_document_info {"file":...} -------->|
 |                 |<- WordProcessing, 1 page, canEdit --------|
 |                 |-- replace_text {"find":"ACME Corp",       |
 |                 |     "replace":"Globex Ltd",               |
 |                 |     "wholeWord":true} ------------------->|
 |                 |<- "Replaced 6 occurrence(s) ...           |
 |                 |    Saved to: .../contract_edited.docx" ---|
 |<- "6 changed; one more is split across formatting - check  |
 |    the notices clause. The original is kept."               |
      (a find that matches nothing: 'No file was written.')

Proč je to víc než trik pro Word

Stejné volání funguje na listu, snímku, PDF nebo textovém souboru. V našem testu "worksheet": 1 přejmenoval dodavatele na souhrnném listu rozpočtu a ponechal ostatní dva listy nedotčeny; "slide": 1 udělal totéž na prezentačním decku. "format": "pdf" upravuje a převádí v jednom volání, takže „opravit jméno a poslat mi PDF“ je jeden krok. "regex": true zpracovává vzory jako řetězce verzí.

Před úpravou get_document_info informuje agenta, s čím pracuje: rodinu, počet stránek, listů nebo snímků, zda je soubor chráněn heslem, a do jakých formátů může ukládat. Opatrný agent to zavolá jako první a můžete ho požádat.

Nastavení

dnx GroupDocs.Editor.Mcp --yes

s GROUPDOCS_MCP_STORAGE_PATH ukazujícím na složku, kterou může agent upravovat, nebo Docker image ghcr.io/groupdocs-editor/editor-net-mcp. Konfigurace pro jednotlivé klienty je v dokumentačním hubu. Co se změnilo v samotném enginu, je v poznámkách k vydání GroupDocs.Editor pro .NET 26.6.

Upřímná omezení

  • replace_text hledá v rámci jednoho formátovacího úseku; fráze rozdělená napříč styly není nalezena a počet to ukazuje.
  • Žádné sledované změny a žádné komentáře: výsledek je upravená kopie, ne červená linie.
  • Evaluační režim: každý výstup začíná řádkem s evaluačním bannerem, uložené sešity získají extra list a pouze první dva listy nebo snímky lze upravovat. Server třetí odmítne a vysvětlí proč.
  • Úprava PDF je konverze na editovatelné HTML nebo Word a zpět; nejde o úpravu PDF na místě.

Často kladené otázky

Přepíše agent můj originální soubor?
Ne. Každá úprava zapíše nový soubor, <name>_edited.<ext> ve výchozím nastavení nebo outputName, který zadáte, do složky úložiště.

Co se stane, pokud text v dokumentu není?
Nic se nezapíše. Server odpoví „nenalezeny žádné shody … Žádný soubor nebyl zapsán.“, takže agent vám to může sdělit místo vrácení nezměněné kopie.

Funguje to bez nainstalovaného Wordu?
Ano. Server běží lokálně s enginem GroupDocs.Editor; není potřeba instalace Office ani nahrávání.

Prohloubení