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 が次回の問い合わせ時に新しいフィールドを示します。

詳細を見る