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ę
- Dokumentacja, kanoniczny przewodnik: Jak wypełnić pola formularza Word danymi przy pomocy agenta AI
- Centrum dokumentacji: GroupDocs.Editor MCP Server
- GroupDocs.Editor MCP product page — instalacja jednym kliknięciem dla VS Code i Cursor, konfiguracje dla każdego innego klienta
- Zacznij tutaj: Dlaczego agent AI nie powinien przepisywać Twojego dokumentu, aby zmienić trzy słowa
- Powiązane: Zmienianie nazwy podmiotu w 40 kontraktach bez dotykania formatowania
- Powiązane: Edytuj jeden arkusz, zachowaj skoroszyt: precyzyjne edycje z HTML round‑trip
- Powiązane: Edytować PDF przy pomocy agenta AI? Najpierw zamień go na Word, lokalnie
- Model on‑premise i bezpieczeństwa: 3 architektury przetwarzania dokumentów AI i ta, która trzyma pliki w Twojej sieci
- Pytania: GroupDocs Editor forum
- Źródło: GroupDocs.Editor.Mcp on GitHub · NuGet package