A document pack(例:取締役会資料、入札資料、クロージングバインダー)は、1 つの固定プロンプトから AI エージェントによって決まった順序で組み立てられ、ファイルはローカルマシンでマージされます。順序はファイル名から取得され、エージェントはラウンドごとにマージを実行し、送信前に結果を確認します。

私のドキュメントフォルダー内のすべての PDF をファイル名順に 1 つのパックに結合してください。4 つずつ結合し、各結果を次の呼び出しにチェーンし、最終的なファイル名を教えてください。

設定とトラブルシューティングを含むステップバイステップ版はドキュメントにあります: How to assemble a document pack with an AI agent.

ドキュメントパックがうまくいかない理由

パックは毎回同じ形をしています:固定順序、4 つ以上のパーツ、そして締め切り。失敗も同じです。パーツが欠落している、2 つのパーツが入れ替わっている、または最終ファイルが古いバージョンのセクションから組み立てられた、というケースです。

「ファイルをまとめて」と指示されたエージェントは文の表現から順序を推測しなければなりません。順序規則が与えられ、エージェントがチェックできる場合は推測が不要です。ここでの自動化は、推測を排除することであり、人間を排除することではありません。

ワークフローは何か、ステップバイステップで

  1. ファイル名を付けて順序が明確になるようにする。 数字のプレフィックスを使用します。
  2. まずライセンスを確認する。 エージェントにライセンス状態を尋ねます。
  3. ラウンドで組み立てを実行する。 merge ツールは 1 回の呼び出しで最大 4 文書まで処理します。
  4. ページ数を検証する。 結果をパーツの合計と比較します。
  5. 変換、マーキング、クリーンアップは別々のステップで行う。 他の MCP サーバーがそれらを処理します。

ステップ 1: ファイル名を付けて順序が明確になるようにする

D:/Storage/Documents/
  00-cover.pdf
  01-summary.pdf
  02-body.pdf
  03-appendix-a.pdf
  04-appendix-b.pdf
  05-annexes.pdf

数字のプレフィックスは、あなたとエージェントの両方に対してシーケンスの曖昧さを排除します。これは実装メカニズムです:ルールはフォルダーに存在し、プロンプトは月ごとに同じままです。再実行前に GROUPDOCS_MCP_OUTPUT_PATH を別フォルダーに設定します。デフォルトでは出力はストレージフォルダーに保存されるため、前月のパックや各ラウンドの中間結果が「my documents フォルダー内のすべての PDF」から取得されてしまいます。

ステップ 2: 本番実行前にライセンスを確認する

マージャーサーバーのライセンスステータスはどうなっていますか?

エージェントは引数も戻り値もない get_license_status を呼び出します。評価モードでは、すべてのマージ結果が最初の 3 ページに切り取られ、各ページにトライアルバッジが付与され、出力にその旨は表示されません。

ステップ 3: ラウンドで組み立てを実行する

冒頭の固定プロンプトを使用します。上記の 6 ファイルの場合、エージェントは merge を 2 回呼び出します:00〜03 が中間結果を生成し、その結果に 04 と 05 を加えて最終パックを作ります。パーツが増えるほどラウンドも増えます。順序はスロット順(file1 が最初、file4 が最後)で、チェーンされたラウンドは前回の結果を最初のスロットに入れます。

ステップ 4: ページ数を検証する

最終パックのページ数はいくつですか?

get_document_info は結果の pageCount を返します。欠落したパーツはページ数が不足していることで判明します。多数のページがあるはずなのに 3 ページと報告されたパックは、ライセンスなしで作成されたものです。

ステップ 5: 変換、マーキング、クリーンアップは別々のステップで行う

すべてのパーツが PDF とは限らず、パックには組み立て以外の処理が必要になることが多いです。merge は呼び出しごとに 1 つのフォーマットファミリーしか受け付けないため、Word セクションはまず GroupDocs.Conversion.Mcp で PDF に変換します。その後、同ファミリーのサーバーでパックに透かし(GroupDocs.Watermark)、署名(GroupDocs.Signature)またはメタデータ除去(GroupDocs.Metadata)を行えます。各サーバーは同じインストールパターンを持つ別個のサーバーです。デジタル署名が必要な場合は最後に適用してください。以降の変更(透かしやメタデータ除去を含む)は署名を無効にします。

エージェントが決定し、エンジンが実行すること

ステップ エージェント エンジン
ファイル選択 フォルダーを一覧表示し、数字プレフィックスを読み取る ストレージフォルダー内の各名前を解決
ラウンド計画 4 ファイルずつグループ化 なし
マージ スロット順で merge を呼び出す 文書を結合し、結果を保存
チェーン 前回の結果を次の呼び出しに渡す 次のファイルと結合
検証 get_document_info を呼び出し、カウントを比較 ページ数を返す

エンジンはシーケンスを決定しません。与えられたスロット順に従うだけです。したがって命名規則が重要になります。

例示セッション(抜粋)

ドキュメント化されたツール動作に基づくイラストであり、実際のスクリーンショットではありません。

You:   Merge every PDF in my documents folder into one pack, in
       file-name order. Merge four at a time, chaining each result
       into the next call, and tell me the final file name.

Agent: Found 6 PDFs, 00-cover.pdf to 05-annexes.pdf.
       [calls merge: 00-cover, 01-summary, 02-body, 03-appendix-a]
       [calls merge: previous result, 04-appendix-b, 05-annexes]
       The final pack is saved in your output folder. I can check its
       page count against the six parts if you like.

正直な制限

  • 評価モードではパックが 3 ページに切り取られます。 結果は最初の 3 ページにトリミングされ、各ページにトライアルバッジが付与されます。ライセンスなしでマージされたマルチパートパックは 3 ページとして返され、完成したように見えます。まず get_license_status を確認し、後でページ数を比較してください。
  • 1 回の呼び出しで 4 文書まで。 ラウンドで回避します。エージェントにチェーンさせる必要があります。
  • マージは 1 フォーマットファミリーのみ。 混在パーツは事前に変換してください。
  • 順序規則は慣例であり、ロックではありません。 ファイル名が誤っているとパックの順序も誤ります。ページ数チェックは欠落パーツは検出しますが、入れ替わりは検出しません。

FAQ

複数の文書を決まった順序で 1 つの PDF に結合するにはどうすればよいですか? ファイル名に数字プレフィックスを付け、エージェントに「ファイル名順で 4 つずつマージし、最終ファイル名を教えて」と指示します。merge ツールは file1 から file4 の入力順序を尊重します。

AI エージェントが毎月取締役会資料を作成できますか? はい。同じ命名規則を維持し、同じプロンプトを再利用します。GROUPDOCS_MCP_OUTPUT_PATH を別フォルダー(または前回の出力をクリアしたフォルダー)に設定すれば、古いパックが再度マージされることはありません。そのたびに結果のページ数を検証してください。

一部のパーツが Word ファイルだったらどうしますか? まず GroupDocs.Conversion.Mcp で PDF に変換し、次にマージします。両方のサーバーが登録されていれば、1 回の会話で完了します。

さらに深掘り