Um formulário Word com caixas de texto, um menu suspenso de departamento e uma caixa de seleção de código de conduta, e uma planilha com trinta novas contratações: isso é uma manhã de copiar e colar, ou um único prompt. Com o servidor GroupDocs.Editor MCP em execução localmente, Claude, Cursor ou Copilot primeiro perguntam ao formulário quais campos ele possui, depois preenchem uma cópia por linha e salvam cada uma com o nome da pessoa. O layout do formulário permanece intacto, e qualquer valor que não tenha um campo correspondente é relatado em vez de ser descartado silenciosamente:

Leia new-employee-form.docx, depois preencha uma cópia por linha de new-hires.csv e nomeie cada arquivo com o nome do funcionário.

A versão passo a passo está na documentação: Como preencher campos de formulário Word a partir de dados com um agente de IA.

Quem lê a planilha?

O agente o faz, e vale a pena ser direto sobre isso. O servidor Editor trabalha no formulário Word; ele não lê seu CSV ou planilha. O agente lê as linhas com suas próprias ferramentas de arquivo, ou você as cola, e então faz uma chamada fill_form_fields por linha com um outputName por pessoa. Essa divisão é um recurso: os dados nunca precisam estar em um formato que o servidor entenda, e o agente pode limpá‑los no caminho (dividir um nome completo, normalizar uma data) antes de inseri‑los no formulário.

Pergunte ao formulário primeiro

Os nomes dos campos em formulários Word raramente correspondem ao rótulo na página. O rótulo exibe “Full name:”, enquanto o campo pode ser chamado FullName, Text1 ou Name_Employee. Adivinhar é como os formulários retornam meio vazios. get_form_fields devolve os nomes reais, os tipos e os valores atuais. Capturado do GroupDocs.Editor.Mcp 26.10.0 contra um formulário sintético de integração (saída abreviada):

-> get_form_fields {"file":{"filePath":"new-employee-form.docx"}}
<- { "count": 6, "fields": [
     { "name": "FullName",   "type": "Text",     "value": "" },
     { "name": "Email",      "type": "Text",     "value": "" },
     { "name": "StartDate",  "type": "Text",     "value": "" },
     { "name": "Department", "type": "DropDown",
       "value": { "options": [ "Engineering", "Finance", "Sales",
                               "Operations" ], "selected": "Engineering" } },
     { "name": "Agree",      "type": "CheckBox", "value": false },
     { "name": "Newsletter", "type": "CheckBox", "value": false } ] }

O menu suspenso vem com suas opções, então o agente pode mapear “finance” na planilha para a entrada exata “Finance” em vez de inventar um sexto departamento.

Então preencha uma linha

-> fill_form_fields {"file":{"filePath":"new-employee-form.docx"},
     "values":{"FullName":"Amara Okafor",
               "Email":"amara.okafor@northwind.example",
               "StartDate":"2026-12-01","Department":"Finance",
               "Agree":"true","Phone":"+31 10 555 0100"}}
<- Updated 5 field(s) in 'new-employee-form.docx': FullName, Email,
   StartDate, Department, Agree.
   Not found: Phone. Call get_form_fields for the exact names.
   Saved to: …/new-employee-form_edited.docx

A planilha tinha uma coluna de telefone que o formulário não possui campo. O servidor preencheu os cinco campos que existem e nomeou o que não existe. Ler a cópia preenchida novamente com get_form_fields mostra os valores no lugar, "selected": "Finance" e "Agree": true incluídos, e Newsletter ainda desmarcado porque a linha não indicou o contrário.

O lote completo

new-hires.csv (agent reads it)          new-employee-form.docx
  Amara Okafor, Finance, ...  ---+
  Tomas Varga, Sales, ...     ---+      get_form_fields (once)
  ...                            |        -> FullName, Email, StartDate,
                                 |           Department, Agree, ...
                                 v
  fill_form_fields {"values":{...row...},
                    "outputName":"form-amara-okafor.docx"}   x one per row
     -> "Updated 5 field(s) ... Not found: Phone"
     -> form-amara-okafor.docx, form-tomas-varga.docx, ...

Três instruções tornam o lote confiável: chame get_form_fields uma vez e mapeie as colunas para os nomes dos campos antes do primeiro preenchimento; dê a cada linha seu próprio outputName, pois caso contrário as cópias se acumulam como new-employee-form_edited.docx, new-employee-form_edited (1).docx e assim por diante, sem o nome de ninguém; e colete as linhas “Not found” em um único relatório ao final, em vez de parar na primeira.

Um prompt que funciona na primeira linha

A maioria das falhas em lote ocorre na primeira linha e depois se repete trinta vezes. Peça um teste preliminar primeiro:

Leia os campos de new-employee-form.docx e o cabeçalho de new-hires.csv. Mostre-me qual coluna vai para qual campo, e quais colunas não têm campo. Em seguida, preencha apenas a primeira linha e pare.

O agente responde com uma pequena tabela de mapeamento, Name -> FullName, Dept -> Department, Phone -> (no field), e um formulário preenchido que você pode abrir. Se a ortografia do departamento ou o formato da data estiverem errados, você os vê uma vez, corrige a instrução e então pede o restante. Essa etapa de revisão custa um minuto e faz a diferença entre trinta formulários corretos e trinta formulários que precisam ser verificados manualmente.

Ela também resolve as questões que a planilha não pode responder sozinha. Uma célula vazia de “Agree” deve significar desmarcado, ou a linha deve ser ignorada? “2026-12-01” deve ser inserido no campo de data como digitado, ou como “1 de dezembro de 2026”? O agente seguirá o que você disser, mas precisa ser informado.

O que mais as ferramentas de formulário manipulam

Campos de texto, número e data são preenchidos com strings; caixas de seleção recebem "true" ou "false"; menus suspensos recebem uma de suas opções. format salva a cópia preenchida como DOC, RTF ou ODT em vez de DOCX; um formulário preenchido é sempre um documento Word, portanto um PDF para o novo contratado é uma conversão separada posteriormente. Um formulário protegido por senha é aberto com password e permanece protegido. A cópia preenchida é escrita pelo mecanismo de campos de formulário em vez de via HTML, então cabeçalhos, rodapés e números de página são mantidos como estavam. As ferramentas leem formulários DOCX, DOC, DOCM, DOT, DOTX, RTF e ODT.

Limites honestos

  • Apenas formulários Word, e apenas campos de formulário legados: os campos de texto, caixa de seleção e menu suspenso que o Word insere a partir de Developer → Legacy Tools. Controles de conteúdo não são listados nem preenchidos. Formulários PDF (AcroForms) não estão no escopo deste servidor.
  • O servidor não lê a planilha; o agente fornece os valores, portanto verifique o mapeamento de colunas na primeira linha antes de deixá‑lo percorrer todas elas.
  • Uma chamada preenche um formulário. Um lote de trinta é trinta chamadas.
  • O modo de avaliação adiciona uma linha de banner no topo de cada cópia preenchida, portanto a saída não licenciada é um rascunho, não algo para enviar aos novos funcionários.

Perguntas Frequentes

Como o agente conhece os nomes dos campos?
Ele pergunta: get_form_fields devolve o nome, tipo e valor atual de cada campo, e as opções de cada menu suspenso.

O que acontece com um valor que o formulário não tem campo?
Ele é ignorado e mencionado na resposta (“Not found: Phone”), para que o agente possa relatá‑lo.

Meu formulário original é alterado?
Não. Cada preenchimento grava um novo arquivo; o modelo permanece em branco para a próxima linha.

Aprofunde-se