Formularz Word z polami tekstowymi, rozwijanym menu działu i polem wyboru kodeksu postępowania oraz arkusz kalkulacyjny z trzydziestoma nowymi pracownikami: to poranna sesja kopiuj‑wklej, albo jedno polecenie. Z uruchomionym lokalnie serwerem GroupDocs.Editor MCP, Claude, Cursor lub Copilot najpierw pyta formularz, jakie ma pola, a następnie wypełnia jedną kopię na wiersz i zapisuje każdą pod nazwą osoby. Układ formularza pozostaje niezmieniony, a każda wartość, która nie ma pasującego pola, jest zgłaszana zamiast cichego pominięcia:

Przeczytaj new-employee-form.docx, a następnie wypełnij jedną kopię dla każdego wiersza z new-hires.csv i nazwij każdy plik po imieniu pracownika.

The step-by-step version is in the documentation: Jak wypełnić pola formularza Word danymi przy pomocy agenta AI.

Kto czyta arkusz kalkulacyjny?

Agent to robi i warto być przy tym szczerym. Serwer Editor działa na formularzu Word; nie odczytuje Twojego CSV ani skoroszytu. Agent odczytuje wiersze własnymi narzędziami plikowymi, albo wklejasz je, a następnie wykonuje jedno wywołanie fill_form_fields na wiersz z outputName dla każdej osoby. Ten podział jest cechą: dane nigdy nie muszą być w formacie, który serwer rozumie, a agent może je oczyścić po drodze (rozdzielić pełne imię i nazwisko, znormalizować datę) zanim trafią do formularza.

Zapytaj najpierw formularz

Nazwy pól w formularzach Word rzadko są takie same, jak etykieta na stronie. Etykieta mówi „Full name:”, podczas gdy pole może mieć nazwę FullName, Text1 lub Name_Employee. Zgadywanie to sposób, w jaki formularze wracają w połowie puste. get_form_fields zwraca prawdziwe nazwy, typy i bieżące wartości. Pobrane z GroupDocs.Editor.Mcp 26.10.0 na syntetycznym formularzu onboardingowym (skrócony wynik):

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

Lista rozwijana przychodzi z własnymi opcjami, więc agent może dopasować „finance” z arkusza do dokładnego wpisu „Finance”, zamiast wymyślać szósty dział.

Następnie wypełnij jeden wiersz

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

Arkusz miał kolumnę telefonu, dla której formularz nie ma pola. Serwer wypełnił pięć istniejących pól i nazwał to, którego nie ma. Odczytanie wypełnionej kopii za pomocą get_form_fields pokazuje wartości na miejscu, "selected": "Finance" i "Agree": true włączone, a Newsletter nadal odznaczony, ponieważ wiersz nie zawierał innej instrukcji.

Cały zestaw

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

Trzy instrukcje sprawiają, że partia jest niezawodna: wywołaj get_form_fields raz i zmapuj kolumny na nazwy pól przed pierwszym wypełnieniem; nadaj każdemu wierszowi własny outputName, bo w przeciwnym razie kopie będą się kumulować jako new-employee-form_edited.docx, new-employee-form_edited (1).docx i tak dalej, bez imienia nikogo; oraz zbierz linie „Not found” w jeden raport na końcu zamiast przerywać przy pierwszej.

Prompt, który działa na pierwszym wierszu

Większość niepowodzeń w partii pojawia się w pierwszym wierszu i powtarza się trzydzieści razy. Najpierw poproś o próbny przebieg:

Przeczytaj pola new-employee-form.docx i nagłówek new-hires.csv. Pokaż mi, która kolumna trafia do którego pola i które kolumny nie mają pola. Następnie wypełnij tylko pierwszy wiersz i zatrzymaj się.

Agent odpowiada małą tabelą mapowania, Name -> FullName, Dept -> Department, Phone -> (no field), oraz jedną wypełnioną formą, którą możesz otworzyć. Jeśli pisownia działu lub format daty jest nieprawidłowy, zobaczysz to od razu, poprawisz instrukcję i poprosisz o resztę. Ten krok przeglądu kosztuje minutę i jest różnicą między trzydziestoma poprawnymi formularzami a trzydziestoma, które trzeba ręcznie sprawdzić.

Rozwiązuje także pytania, na które arkusz sam nie może odpowiedzieć. Czy pustą komórkę „Agree” należy traktować jako odznaczoną, czy pominąć wiersz? Czy „2026-12-01” ma trafić do pola daty tak, jak jest wpisane, czy jako „1 December 2026”? Agent wykona to, co powiesz, ale musi o tym zostać poinformowany.

Co jeszcze obsługują narzędzia formularza

Pola tekstowe, liczbowe i daty są wypełniane łańcuchami znaków; pola wyboru przyjmują "true" lub "false"; listy rozwijane przyjmują jedną z dostępnych opcji. format zapisuje wypełnioną kopię jako DOC, RTF lub ODT zamiast DOCX; wypełniony formularz jest zawsze dokumentem Word, więc PDF dla nowego pracownika to oddzielna konwersja po zakończeniu. Formularz zabezpieczony hasłem otwierany jest przy pomocy password i pozostaje chroniony. Wypełniona kopia jest tworzona przez silnik pól formularza, a nie przez HTML, więc nagłówki, stopki i numery stron zachowują się tak, jak były. Narzędzia odczytują formularze w formatach DOCX, DOC, DOCM, DOT, DOTX, RTF i ODT.

Szczere ograniczenia

  • Tylko formularze Word oraz jedynie pola legacy: tekst, pola wyboru i listy rozwijane, które Word wstawia z Developer → Legacy Tools. Kontrole treści nie są wymieniane ani wypełniane. Formularze PDF (AcroForms) nie są obsługiwane przez ten serwer.
  • Serwer nie odczytuje arkusza; agent dostarcza wartości, więc sprawdź mapowanie kolumn w pierwszym wierszu, zanim pozwolisz mu przejść przez wszystkie.
  • Jedno wywołanie wypełnia jeden formularz. Partia trzydziestu to trzydzieści wywołań.
  • Tryb ewaluacji dodaje linię banera na górze każdej wypełnionej kopii, więc nielicencjonowany wynik jest szkicem, a nie czymś, co można wysłać nowym pracownikom.

FAQ

Jak agent zna nazwy pól?
Pyta: get_form_fields zwraca nazwę każdego pola, jego typ i bieżącą wartość oraz opcje każdego pola rozwijanego.

Co się dzieje z wartością, dla której formularz nie ma pola?
Zostaje pominięta i wymieniona w odpowiedzi („Not found: Phone”), dzięki czemu agent może o tym poinformować.

Czy mój oryginalny formularz został zmieniony?
Nie. Każde wypełnienie zapisuje nowy plik; szablon pozostaje pusty dla kolejnego wiersza.

Zagłęb się