O orçamento tem três planilhas, e o financeiro quer duas células alteradas na segunda. Passar a pasta de trabalho inteira para um agente de IA para “atualizar Q3” convida-o a reconstruir todas as três. Com o servidor GroupDocs.Editor MCP em execução localmente, Claude, Cursor ou Copilot extraem apenas essa planilha como HTML editável, fazem as alterações solicitadas e a salvam de volta em uma cópia da pasta de trabalho original, de modo que as outras planilhas nunca passam pelo modelo. Slides funcionam da mesma forma:

No budget.xlsx, na planilha 2 (Q3), defina Viagem para 12.500 e renomeie Treinamento para “Treinamento (externo)”. Deixe as outras planilhas inalteradas.

A versão passo a passo está na documentação: Como editar uma planilha ou slide e inseri‑lo de volta no original.

Por que não entregar o agente o arquivo inteiro?

Porque um modelo não pode manter uma pasta de trabalho. Ele pode manter texto. Cada planilha que você lhe dá é uma planilha que ele pode “ajudosamente” reformular: números reformatados, uma fórmula transformada em seu valor, uma coluna que ele não entendeu descartada. Mesmo quando nada dá errado, você não pode perceber isso na resposta. A solução é delimitar o escopo: forneça ao agente exatamente a parte que ele foi solicitado a mudar e mantenha o resto fora do seu alcance.

HTML é o formato correto para essa parte. Tabelas, estilos, fontes e imagens permanecem nele, os modelos leem e escrevem bem, e ele mapeia de volta para a estrutura original. Texto simples perderia a formatação; o XML bruto do .xlsx é um labirinto que nenhum agente deveria editar.

A ida‑e‑volta

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+

O que o servidor retornou

Capturado do GroupDocs.Editor.Mcp 26.10.0 contra um orçamento sintético:

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

Abrir o resultado confirma o escopo: em Q3, Viagem está 12500 e a linha lê “Treinamento (externo)”; Hospedagem e Suporte permanecem inalterados; Resumo e Q4 estão como estavam. O budget.xlsx original não foi modificado.

As ferramentas tratam planilhas e slides por número, não por nome; get_document_info devolve a contagem, por isso o prompt diz “worksheet 2 (Q3)”. A resposta de extração traz uma pré‑visualização em texto simples, para que o agente verifique se tem a planilha correta antes de editar qualquer coisa, e uma linha “Next:” que indica qual chamada vem a seguir. Os agentes seguem essas dicas muito bem. Para um slide, a pré‑visualização pode começar com o texto de espaço reservado do mestre (“Click to edit Master title style”), então o agente deve conferir o próprio HTML.

Slides, e a única regra para apresentações

O mesmo par funciona em um deck: extract_html com "slide": 2, editar, save_from_html com "slide": 2 e o documento original como sourceFile. No nosso teste, o slide 2 de um deck de revisão de três slides foi exportado como HTML, “12 percent” virou “14 percent”, e voltou como review-revised.pptx com os slides 1 e 3 intactos.

Para PowerPoint o sourceFile não é opcional. HTML sozinho não carrega o mestre de slides, e o servidor informa isso em vez de produzir um deck quebrado:

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

A mensagem indica o argumento ausente, de modo que o agente corrige a chamada por conta própria.

Quando a ida‑e‑volta supera localizar‑e‑substituir

replace_text é o caminho mais curto para uma palavra ou nome. A ida‑e‑volta serve para tudo o mais: mudar várias células de uma vez, reformular um rótulo e um número juntos, reestruturar uma tabela em um slide, ou uma frase que replace_text não vê porque está dividida em duas execuções de formatação. Também é como o agente lê uma parte antes de decidir o que mudar.

Ler antes de escrever

A primeira metade da ida‑e‑volta é útil por si só. Um agente perguntado “o que está planejado para viagem em Q3 e quem é o responsável?” pode extrair a planilha Q3 e responder a partir do HTML sem tocar em nada, e um agente que está prestes a editar deve fazer exatamente isso primeiro: ler a parte, declarar a mudança que pretende fazer, então escrever. Insira essa ordem nas instruções do seu projeto para que se torne o padrão:

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.

A última linha é a mais importante. “Eu alterei Viagem de 9000 para 12500 e renomeei Treinamento em Q3” é uma resposta que um revisor pode conferir no arquivo em segundos.

Limites honestos

  • O modo de avaliação edita apenas as duas primeiras planilhas ou slides, e o servidor recusa a terceira com a razão: “Evaluation mode edits only the first 2 visible worksheets of a workbook; worksheet 3 is beyond them.”
  • Salvamentos sem licença são rascunhos: a planilha editada ganha uma linha de banner no topo e a pasta de trabalho ganha uma planilha extra “Evaluation Warning”.
  • O HTML extraído de uma execução sem licença começa com a mesma linha de avaliação (a pré‑visualização acima a mostra), portanto o agente deve editar as células, não essa linha.
  • Números de planilha e slide são baseados em 1, incluindo as ocultas. Um slide oculto requer showHidden: true; uma planilha oculta é recusada independentemente do que showHidden indique, então desoculte‑a na pasta de trabalho primeiro.

Perguntas frequentes

Editar uma planilha altera as outras?
Não. O HTML editado substitui apenas a planilha que você nomeou, em uma cópia do original; o resto é mantido a partir do arquivo fonte.

Posso fazer isso com slides do PowerPoint?
Sim, usando "slide" em vez de "worksheet" e passando o original como sourceFile, que a saída do PowerPoint exige.

Onde o resultado é salvo?
Em um novo arquivo na pasta de armazenamento, budget-q3-revised.xlsx neste caso porque passamos outputName; o original permanece intacto.

Aprofunde