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 パーセントの割引。
設定とトラブルシューティングを含むステップバイステップのバージョンはドキュメントにあります: How to generate documents from templates with AI agents using 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
| "この注文の契約書を作成してください: ..." |
|-------------->| |
| |-- get_template_fields |
| | {"template":{"filePath": |
| | "contract-template.docx"}} ------------>|
| |<- dataSkeleton: contract, customer, items --|
| | (注文テキストからスケルトンを埋める) |
| |-- assemble_document {"dataJson":"{...}", |
| | "format":"pdf"} ----------------------->|
| |<- Saved to: .../contract-template_ |
| | assembled.pdf ----------------------------|
|<- "契約書が完成しました: 3 アイテム、合計 75500 EUR、5% 割引。" |
レイアウト、表、計算はテンプレートから生成されます
最後の呼び出し(データは省略、行は折り返し):
-> 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(...) による合計 75500 EUR、そして “5 パーセントの割引が適用されます。” という行が含まれます。この行はデータに割引があることを <<if>> タグが検出したために存在し、モデルは一切計算していません。
これはホスト型テンプレートサービスより優れているか?
これは別のトレードオフです。ホスト型テンプレートサービスはテンプレートとデータを HTTPS 経由で受け取り、クラウドでレンダリングし、文書ごとまたはクレジットごとに課金します。一方、ここではテンプレート、データ、出力がすべてローカルのフォルダーに残り、エンジンはプロセス内で実行される GroupDocs.Assembly で、ポートをリッスンするものはありません。モデルプロバイダーに送られるのは貼り付けた注文テキストとエージェントが埋めたスケルトンだけで、レンダリングされた契約書は送られません。アーキテクチャは on-premise AI document processing の記事にあります。
正直な制限
- 評価モード: 生成されたすべての文書は “Evaluation Only. Created with GroupDocs.Assembly 26.7…” という行で始まり、保存されたワークブックには余分なシートが追加され、メールテンプレートはプレーンテキストの本文だけが残ります。ライセンスファイルまたは従量課金キーを使用すればこれらすべてが削除されます。
- テンプレート構文は
<<[name]>>です。{{name}}プレースホルダーはテキストとして残り、get_template_fieldsがそれを示します。 - テンプレートは信頼できる入力とみなされます:画像や文書タグは式が返す任意のパスまたは URL をロードします。サーバー用にフォルダーを1つマウントしてください。
- 日付:
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 が次回の問い合わせ時に新しいフィールドを示します。
詳細を見る
- ドキュメント、標準的なハウツー: How to generate documents from templates with AI agents using MCP
- メールやメモから文書へ: How to turn notes or an email into a finished document with an AI agent
- ドキュメントハブ: GroupDocs.Assembly MCP Server
- GroupDocs.Assembly MCP product page — VS Code と Cursor 用のワンクリックインストール、他のクライアント用設定
- 関連: A hundred personalised PDFs from one prompt: mail merge with an AI agent
- 関連: What does this template need? Ask it.
- 関連: The chart comes from the template, the numbers come from the data
- 関連: Your repo already has the data; let the agent make the PDF
- エンジンの新機能: GroupDocs.Assembly for .NET 26.7
- オンプレミスとセキュリティモデル: 3 architectures for AI document processing, and the one that keeps files inside your network
- 質問: GroupDocs Assembly forum
- ソース: GroupDocs.Assembly.Mcp on GitHub · NuGet package