A text box와 부서 드롭다운, 행동 강령 체크 박스가 포함된 Word 양식과 30명의 신규 채용자를 담은 스프레드시트: 이것은 복사‑붙여넣기의 아침이거나 하나의 프롬프트입니다. 로컬에서 GroupDocs.Editor MCP 서버를 실행하면 Claude, Cursor 또는 Copilot이 먼저 양식에 어떤 필드가 있는지 물어보고, 각 행마다 복사본을 채워 사람 이름으로 저장합니다. 양식 레이아웃은 그대로이며, 일치하는 필드가 없는 값은 조용히 사라지는 대신 보고됩니다:

new-employee-form.docx를 읽고, new-hires.csv의 각 행마다 복사본을 채워 직원 이름으로 파일명을 지정하십시오.

단계별 버전은 문서에 있습니다: 데이터로 Word 양식 필드 채우기 (AI 에이전트 사용).

스프레드시트를 읽는 사람은?

에이전트가 읽으며, 이를 명확히 하는 것이 좋습니다. 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” 라인을 모두 모아 마지막에 한 번 보고서로 만들고, 첫 번째 오류에서 중단하지 않기.

첫 번째 행에만 작동하는 프롬프트

대부분의 배치 실패는 첫 번째 행에서 발생하고 이후 30번 반복됩니다. 먼저 드라이 런을 요청하세요:

new-employee-form.docx의 필드와 new-hires.csv의 헤더를 읽어라. 어떤 열이 어떤 필드에 매핑되는지, 어떤 열에 필드가 없는지 보여줘. 그런 다음 첫 번째 행만 채우고 멈춰라.

에이전트는 작은 매핑 표(Name -> FullName, Dept -> Department, Phone -> (no field))와 열 수 있는 채워진 양식을 반환합니다. 부서 철자나 날짜 형식이 잘못되었을 경우 한 번만 확인하고 지시를 수정한 뒤 나머지를 요청하면 됩니다. 이 검토 단계는 1분 정도 소요되며, 30개의 올바른 양식과 수작업 검토가 필요한 30개의 양식 사이의 차이를 만들어 줍니다.

또한 스프레드시트 자체로는 답할 수 없는 질문들을 해결합니다. 빈 “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 양식만 지원하며, 레거시 양식 필드만 지원합니다: Developer → Legacy Tools에서 Word가 삽입하는 텍스트, 체크‑박스 및 드롭다운 필드만 해당됩니다. 콘텐츠 컨트롤은 목록에 표시되지 않으며 채워지지 않습니다. PDF 양식(AcroForms)은 이 서버의 범위에 포함되지 않습니다.
  • 서버는 스프레드시트를 읽지 않으며, 에이전트가 값을 제공하므로 첫 번째 행에서 열 매핑을 확인한 뒤 전체 행을 실행하도록 해야 합니다.
  • 한 번의 호출은 한 개의 양식을 채웁니다. 30개의 배치는 30번의 호출이 필요합니다.
  • 평가 모드에서는 모든 채워진 복사본 상단에 배너 라인이 추가되어, 라이선스가 없는 출력은 초안으로 표시되며 신규 직원에게 보내서는 안 됩니다.

FAQ

에이전트는 어떻게 필드 이름을 알게 되나요?
에이전트가 get_form_fields를 호출하면 각 필드의 이름, 유형 및 현재 값, 그리고 모든 드롭다운 옵션을 반환합니다.

양식에 해당 필드가 없을 경우 값은 어떻게 처리되나요?
해당 값은 건너뛰고 응답에 (“Not found: Phone”) 형태로 이름이 표시되어 에이전트가 보고할 수 있습니다.

원본 양식이 변경되나요?
아니요. 각 채우기는 새 파일을 생성하고, 템플릿은 다음 행을 위해 그대로 비어 있습니다.

더 깊이 파고들기