AI 에이전트에게 “Contoso에 대한 서비스 계약서를 작성해 달라"고 요청하면, 에이전트는 자체적인 문구와 자체적인 제목을 사용하고, 머릿속에서 계산한 총액을 포함해서 작성합니다. 이는 잘못된 작업 분담입니다. GroupDocs.Assembly.Mcp를 로컬에서 실행하면 (dnx GroupDocs.Assembly.Mcp --yes), Claude Desktop, Cursor 또는 Copilot이 Word 템플릿에 어떤 필드가 필요한지 물어보고, 메모에서 해당 값을 채워 넣으며, 엔진이 레이아웃에 모델이 관여하지 않은 상태에서 계약서, 표 및 산술을 포함해 렌더링합니다.
이 주문에 대해 contract-template.docx를 사용하여 서비스 계약서를 만들고 PDF로 저장하십시오: Contoso Pharma, Keizersgracht 210 Amsterdam, 연락처 Dr. Lena Brandt; 관리형 호스팅 12개월 4,800 EUR, 지원 12개월 1,200 EUR, 온보딩 워크숍 1회 3,500 EUR; 5% 할인.
The step-by-step version with config and troubleshooting is in the documentation: AI 에이전트를 사용한 MCP로 템플릿에서 문서 생성 방법.
모델이 문서를 작성하면 안 되는 이유
생성된 문서는 눈에 잘 띄지 않는 방식으로 오류가 발생합니다. 레이아웃이 법적으로 승인된 것과 달라지고, 조항이 잘 읽히도록 바뀌면서 의미가 달라집니다. 총액이 곱셈이 아니라 다음 토큰 예측으로 산출됩니다. 또한 각 실행마다 약간씩 다르기 때문에 지난달 검토가 이번달 계약에 대해 아무런 정보를 제공하지 못합니다.
템플릿은 이를 반전시킵니다. 법무팀이 contract-template.docx를 소유하며, 그 안에 제목, 서명 블록 및 <<[customer.Name]>> 태그가 포함됩니다. 모델의 작업은 이메일이나 메모를 읽어 구조화된 값으로 변환하는 부분으로 축소됩니다. 엔진이 나머지를 매번 동일하게 수행합니다.
에이전트는 어떻게 채워야 할 내용을 알까요?
템플릿에 질의합니다. get_template_fields는 엔진을 실행하지 않고 태그를 읽어 템플릿이 사용하는 이름들, 읽은 모든 필드, 그리고 채워야 할 JSON 스켈레톤을 반환합니다. 아래는 서버가 우리 계약 템플릿에 대해 반환한 내용입니다:
-> get_template_fields {"template":{"filePath":"contract-template.docx"}}
<- { "tagCount": 17,
"dataSourceNames": [ "contract", "customer", "items" ],
"dataSkeleton": {
"contract": { "Number": "", "Date": "2026-01-31T00:00:00",
"Discount": "" },
"customer": { "Name": "", "Address": "", "Contact": "",
"Email": "" },
"items": [ { "Title": "", "Quantity": 0, "UnitPrice": 0 } ] } }
그 스켈레톤은 모델과 문서 사이의 계약입니다. 에이전트는 주문 텍스트에서 값을 채워 dataJson으로 반환합니다. 샘플 날짜에 주목하세요: 템플릿은 contract.Date를 날짜 형식으로 표시하므로 스켈레톤은 시간까지 포함된 ISO 날짜를 요구합니다.
에이전트가 필드를 놓쳤을 때는 어떻게 되나요?
정확히 알려줍니다. 테스트 실행 중 하나에서 에이전트의 첫 시도는 고객의 이메일 주소를 누락했습니다. 서버는 이를 거부하고 누락된 부분을 명시했습니다:
-> assemble_document {"template":{...},"dataJson":"{... no Email ...}"}
<- Document assembly failed for 'contract-template.docx': ...
Can not get the value of member 'Email' on type ''. The template
reads 'Email', which the data does not have. Check the spelling
(names are case-sensitive) with get_template_fields and add it to
the data. ... pass allowMissingMembers=true to output nothing for
missing members and empty lists.
모델이 자유 텍스트를 작성했다면 해당 줄을 조용히 생략했을 것입니다. 여기서는 에이전트가 주소를 물어보거나 해당 필드를 비워둘 수 있음을 사용자와 함께 결정할 수 있습니다. 해당 실행에서는 주소가 추가되었고, 계약 번호 아래 저장된 재시도가 성공했습니다:
-> assemble_document {"template":{"filePath":"contract-template.docx"},
"dataJson":"{...}","outputName":"SA-2026-118-contoso.docx"}
<- Assembled 'contract-template.docx' with inline JSON (JSON object)
as DOCX
Saved to: .../SA-2026-118-contoso.docx
전체 교환 과정
주문 텍스트에 모든 내용이 포함된 실행 예시가 아래와 같이 기록됩니다:
user agent Assembly MCP server
| "Make the contract for this order: ..." |
|-------------->| |
| |-- get_template_fields |
| | {"template":{"filePath": |
| | "contract-template.docx"}} ------------>|
| |<- dataSkeleton: contract, customer, items --|
| | (fills the skeleton from the order text) |
| |-- assemble_document {"dataJson":"{...}", |
| | "format":"pdf"} ----------------------->|
| |<- Saved to: .../contract-template_ |
| | assembled.pdf ----------------------------|
|<- "Contract ready: 3 items, total 75500 EUR, 5% discount." |
layout, table and arithmetic come from the template
마지막 호출 (데이터는 생략, 줄은 래핑됨):
-> assemble_document {"template":{"filePath":"contract-template.docx"},
"dataJson":"{...}","format":"pdf"}
<- Assembled 'contract-template.docx' with inline JSON (JSON object)
as PDF
Saved to: .../contract-template_assembled.pdf
문서에는 <<foreach>> 로 테이블 행을 만든 3행 요금 표, 템플릿(<<[item.Quantity * item.UnitPrice]>>)에 의해 계산된 금액, items.Sum(...) 로 구한 75,500 EUR 총액, 그리고 데이터에서 할인을 찾은 <<if>> 태그 때문에 존재하는 “5% 할인이 적용됩니다.” 라는 문장이 포함됩니다. 모델은 이 모든 것을 계산하지 않았습니다.
이것이 호스팅 템플릿 서비스보다 나은가요?
이는 다른 트레이드오프입니다. 호스팅 템플릿 서비스는 템플릿과 데이터를 HTTPS를 통해 받아 클라우드에서 렌더링하고 문서당 또는 크레딧당 요금을 부과합니다. 여기서는 템플릿, 데이터 및 출력이 모두 로컬 머신의 폴더에 남으며, 엔진은 프로세스 내에서 실행되는 GroupDocs.Assembly이며 포트를 열어두지 않습니다. 모델 제공자에게 전달되는 것은 붙여넣은 주문 텍스트와 에이전트가 채운 스켈레톤이며, 렌더링된 계약서는 전달되지 않습니다. 아키텍처에 대한 자세한 내용은 on-premise AI document processing 포스트를 참고하세요.
솔직한 제한 사항
- 평가 모드: 모든 생성된 문서는 “Evaluation Only. Created with GroupDocs.Assembly 26.7…” 라는 문장으로 시작하고, 저장된 워크북에는 추가 워크시트가 생기며, 이메일 템플릿은 본문 텍스트만 유지됩니다. 라이선스 파일이나 미터링 키를 사용하면 이 세 가지가 모두 제거됩니다.
- 템플릿 구문은
<<[name]>>입니다.{{name}}자리표시는 텍스트 그대로 남으며,get_template_fields가 이를 알려줍니다. - 템플릿은 신뢰된 입력으로 간주됩니다: 이미지 및 문서 태그는 표현식이 반환하는 경로나 URL을 로드합니다. 서버를 위해 하나의 폴더를 마운트하세요.
- 날짜:
2026-11-12T00:00:00형태로 작성하고 템플릿에서 (<<[contract.Date]:"d MMMM yyyy">>) 포맷합니다. 날짜만 있는"2026-11-12"는 UTC+2 환경에서 테스트 시 11 November 로 출력됩니다. - 에이전트가 데이터 소스입니다. 렌더링 전에 추출한 값을 나열하도록 요청하고 검토하세요.
FAQ
AI 에이전트가 템플릿을 업로드하지 않고 Word 템플릿을 채울 수 있나요?
예. 서버는 stdio를 통해 로컬에서 실행되며, 설정한 폴더에서 템플릿을 읽고 출력은 템플릿 옆에 작성됩니다.
템플릿은 어떤 형식이 가능한가요?
Word, Excel, PowerPoint, Markdown, HTML, 텍스트 및 이메일 템플릿; 각각을 자체 형식이나 PDF 등으로 저장할 수 있습니다. get_supported_formats가 템플릿별로 나열합니다.
템플릿이 다른 사람에 의해 관리된다면 어떻게 되나요?
바로 그 점이 핵심입니다. 템플릿을 소유한 사람이 조항과 레이아웃을 변경하면, 에이전트는 동일한 스켈레톤을 계속 채우고, get_template_fields는 다음 요청 시 새로운 필드를 보여줍니다.
더 깊이 파고들기
- 문서, 표준 가이드: AI 에이전트를 사용한 MCP로 템플릿에서 문서 생성 방법
- 이메일이나 메모를 문서로 변환: AI 에이전트를 사용해 메모 또는 이메일을 완성된 문서로 만드는 방법
- 문서 허브: GroupDocs.Assembly MCP Server
- GroupDocs.Assembly MCP 제품 페이지 — VS Code와 Cursor에 원클릭 설치, 기타 모든 클라이언트용 설정
- 관련: 한 프롬프트로 100개의 맞춤 PDF 만들기: AI 에이전트와 메일 머지
- 관련: 이 템플릿에 무엇이 필요한가? 물어보세요.
- 관련: 차트는 템플릿에서, 숫자는 데이터에서
- 관련: 레포에 이미 데이터가 있다면, 에이전트가 PDF를 생성하도록 하세요
- 엔진의 새로운 기능: GroupDocs.Assembly for .NET 26.7
- 온프레미스 및 보안 모델: AI 문서 처리용 3가지 아키텍처와 파일을 네트워크 내부에 보관하는 방법
- 질문: GroupDocs Assembly 포럼
- 소스: GroupDocs.Assembly.Mcp on GitHub · NuGet package