טופס Word עם תיבות טקסט, תפריט נפתח של מחלקה ותיבת סימון של קוד התנהגות, וגיליון אלקטרוני עם שלושים עובדים חדשים: זה בוקר של העתקה והדבקה, או פקודה אחת. עם שרת GroupDocs.Editor MCP הפועל מקומית, Claude, Cursor או Copilot שואלים תחילה את הטופס אילו שדות יש לו, ואז ממלאים עותק אחד לכל שורה ושומרים כל קובץ תחת שם האדם. פריסת הטופס נשארת ללא שינוי, וכל ערך שאין לו שדה תואם מדווח במקום שנשמט בשקט:

קרא new-employee-form.docx, ואז מלא עותק אחד לכל שורה של new-hires.csv וקרא לכל קובץ בשם העובד.

הגרסה הצעד‑אחר‑צעד נמצאת בתיעוד: How to fill Word form fields from data with an AI agent.

מי קורא את הגיליון?

הסוכן עושה זאת, וזה חשוב להיות ישיר לגבי זה. שרת ה‑Editor עובד על טופס ה‑Word; הוא אינו קורא את קובץ ה‑CSV או חוברת העבודה שלכם. הסוכן קורא את השורות עם כלי הקבצים שלו, או אתם מדביקים אותם, ואז מבצע קריאה אחת ל‑fill_form_fields לכל שורה עם outputName לכל אדם. חלוקה זו היא תכונה: הנתונים אף פעם לא צריכים להיות בפורמט שהשרת מבין, והסוכן יכול לנקות אותם בדרך (לפרק שם מלא, לנרמל תאריך) לפני שהם נכנסים לטופס.

שאלו את הטופס קודם

שמות השדות בטופסי Word לעיתים קרובות אינם תואמים לתווית על העמוד. התווית אומרת “Full name:”, בעוד שהשדה עשוי להיקרא FullName, Text1 או Name_Employee. ניחוש הוא איך טפסים חוזרים חצי ריקים. get_form_fields מחזיר את השמות האמיתיים, הסוגים והערכים הנוכחיים. נלקח מ‑GroupDocs.Editor.Mcp גרסה 26.10.0 נגד טופס קבלה סינתטי (פלט מקוצר):

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

התפריט הנפתח מגיע עם האפשרויות שלו, ולכן הסוכן יכול למפות את “finance” בגיליון לערך המדויק “Finance” במקום להמציא מחלקה שישית.

ואז למלא שורה אחת

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

לגיליון הייתה עמודת טלפון שהטופס אינו כולל שדה עבורו. השרת מילא את חמשת השדות הקיימים ושמו את השדה החסר. קריאת העותק המלא עם get_form_fields מציגה את הערכים במקומם, כולל "selected": "Finance" ו‑"Agree": true, ו‑Newsletter נשאר לא מסומן מכיוון שהשורה לא ציינה אחרת.

כל האצווה

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

שלוש הוראות הופכות את האצווה לאמינה: קראו get_form_fields פעם אחת ומפהו את העמודות לשמות השדות לפני המילוי הראשון; תנו לכל שורה outputName משלה, אחרת העותקים מצטברים כ‑new-employee-form_edited.docx, new-employee-form_edited (1).docx וכדומה, ללא שם של אף אחד; ואספו את השורות “Not found” לדוח אחד בסוף במקום לעצור על הראשונה.

פקודה שעובדת על השורה הראשונה

רוב הכשלונות באצווה מתרחשים בשורה הראשונה ואז חוזרים שלושים פעמים. בקשו הרצה יבשה תחילה:

קרא את השדות של new-employee-form.docx ואת הכותרת של new‑hires.csv. הצג לי איזו עמודה הולכת לאיזה שדה, ואילו עמודות אין להן שדה. לאחר מכן מלא רק את השורה הראשונה והפסק.

הסוכן משיב בטבלת מיפוי קטנה, Name -> FullName, Dept -> Department, Phone -> (no field), ומציג טופס ממולא שניתן לפתוח. אם האיות של המחלקה או פורמט התאריך שגויים, אתם רואים זאת פעם אחת, מתקנים את ההוראה, ואז מבקשים את השאר. שלב ביקורת זה לוקח דקה אחת והוא ההבדל בין שלושים טפסים נכונים ושלושים טפסים שצריך לבדוק ידנית.

זה גם פותר את השאלות שהגיליון אינו יכול לענות עליהן בעצמו. האם תא “Agree” ריק משמעותו לא מסומן, או שיש לדלג על השורה? האם "2026-12-01" נכנס לשדה התאריך כפי שהוקלד, או כ‑“1 December 2026”? הסוכן יעשה בדיוק מה שאתם אומרים, אך עליו לקבל זאת במפורש.

מה עוד כלי הטופס מתמודדים איתו

שדות טקסט, מספר ותאריך מתמלאים במחרוזות; תיבות סימון מקבלות "true" או "false"; תפריטים נפתחים מקבלים אחת מהאפשרויות שלהם. format שומר את העותק הממולא כ‑DOC, RTF או ODT במקום DOCX; טופס ממולא הוא תמיד מסמך Word, ולכן PDF עבור העובד החדש הוא המרה נפרדת לאחר מכן. טופס מוגן בסיסמה נפתח עם password ונשאר מוגן. העותק הממולא נכתב על‑ידי מנוע השדות ולא דרך HTML, ולכן כותרות, כותרות תחתונות ומספרי עמודים נשמרים כפי שהיו. הכלים קוראים טפסים בפורמטים DOCX, DOC, DOCM, DOT, DOTX, RTF ו‑ODT.

מגבלות כנות

  • טפסי Word בלבד, ושדות טפסים מדור קודם בלבד: שדות הטקסט, תיבות הסימון ותפריטי הנפתחים שה‑Word מוסיף מ‑Developer → Legacy Tools. פקדי תוכן אינם מופיעים ברשימה ולא מתמלאים. טפסי PDF (AcroForms) אינם בטווח של שרת זה.
  • השרת אינו קורא את הגיליון; הסוכן מספק את הערכים, ולכן יש לבדוק את מיפוי העמודות שלו על השורה הראשונה לפני שמריצים אותו על כולן.
  • קריאה אחת ממלאת טופס אחד. אצווה של שלושים היא שלושים קריאות.
  • מצב הערכה מוסיף שורת כותרת בראש כל עותק ממולא, כך שהפלט הלא מורשה הוא טיוטה, ולא משהו שיש לשלוח לעובדים החדשים.

שאלות נפוצות

איך הסוכן יודע את שמות השדות?
הוא שואל: get_form_fields מחזיר את שם כל שדה, סוגו והערך הנוכחי, וכן את האפשרויות של כל תפריט נפתח.

מה קורה לערך שאין לו שדה בטופס?
הוא מדולג ונרשם בתגובה (“Not found: Phone”), כך שהסוכן יכול לדווח עליו.

האם הטופס המקורי משתנה?
לא. כל מילוי יוצר קובץ חדש; התבנית נשארת ריקה לשורה הבאה.

צלילה עמוקה יותר