AI動画エージェント：多段階キャンバスを計画・実行する方法

成果物に依存関係がある場合、AI動画エージェントのワークフローが役立ちます。企画文がキー画像を導き、その画像が動画入力となり、確認後に次のショットを実行する流れです。NamiFusionのキャンバスはtext、image、video、assetノードと明示的なエッジで作業を表します。エージェントはWorkflow MCPから同じ保存済みキャンバスを読み書きし、対象ノードを実行して完了出力を取得できます。キャンバスは編集判断を代替しません。入力、来歴、再実行を見やすくしますが、権利、事実、費用、公開判断は利用者の責任です。

実行前にグラフを設計する

モデル呼び出しより先にショットリストを作ります。各ショットの目的、目標時間、比率、素材、プロンプト、維持点、承認条件を記録します。キャンバスを、textの企画、承認参照を置く永続asset、キー画像のimage、動きのvideo、レビュー記録のtextに分けます。実際の依存だけを接続します。レビュー文を入力に使わないならレンダーへつなぐ必要はありません。再実行が信頼済み素材を暗黙に置き換えないよう、実験枝と承認経路を分けます。

エージェントにグラフを編集させる前に、ローカル媒体を永続的なワークフローAssetとして準備します。各ファイルは対話型キャンバスからアップロードし、assetノードが保存されたことを確認してから、ワークフローと素材の情報をエージェントへ渡します。エージェントはworkflow_get_canvasで既存assetノードとIDを確認し、画像または動画の処理へ接続できます。ファイル転送は対応済みのキャンバス画面で行い、Workflow MCPは保存済みトポロジー、実行、run確認を担当します。

エージェントの実行順序

1. 必要なローカルファイルを対話型キャンバスからアップロードし、assetノードが保存されたことを確認します。
2. API Keysページでキーを作成し、Workflow MCPの https://www.namifusion.com/api/v1/workflow/mcp/ を設定します。キーは環境変数か秘密管理に置きます。
3. workflow_listで対象を選びます。
4. workflow_get_canvasでノード、エッジ、既存assetノードのID、現在のrevisionを取得します。
5. workflow_upsert_nodeで一度に一ノードを追加・更新し、常に最新revisionを渡します。
6. 変更後に再読込します。古いrevisionは仕様通り失敗します。
7. workflow_patch_topologyで既存assetノードを接続するか、他の明示的なエッジを変更します。
8. workflow_executeには今回必要なtarget_node_idsだけを渡し、意図的に再生成するノードだけをrerun_node_idsへ入れます。
9. run_idを保存し、workflow_wait_runまたはworkflow_get_runで終端まで確認します。
10. 完了出力を確認してから依存する編集枝を実行します。

1. workflow_list()
2. workflow_get_canvas(workflow_id)
3. workflow_upsert_node(workflow_id, revision, data, node_type, ...)
4. workflow_get_canvas(workflow_id)  # refresh revision
5. workflow_patch_topology(workflow_id, revision, add_edges=[...])
6. workflow_execute(workflow_id, target_node_ids=[...])
7. workflow_wait_run(run_id, timeout_seconds=30, poll_interval_seconds=2)

エージェントに編集契約を与える

有用なエージェント指示には、成果物、使用可能素材、対象ノード、維持点、停止条件、承認境界を含めます。例：「WORKFLOW_IDの現在のキャンバスを確認する。6秒横長の商品紹介用text briefを追加し、既存の承認済みボトルAssetを新しいvideoノードへ接続する。実行はしない。ラベル文字とボトル形状を維持する。ノード削除や承認経路の変更をしない。新ノードID、最新revision、入力要約を返す。」この練習は有料実行前で止めます。実行を許可するときは、対象ノードと再実行可能ノードを明記します。

Inspect workflow WORKFLOW_ID and its current revision.
Add a brief for a six-second landscape product reveal.
Connect the existing approved bottle asset to a new video node.
Preserve label text and bottle geometry.
Do not execute, delete nodes, or change the approved branch.
Return the new node ID, latest revision, and input summary.

実行確認と安全な復旧

完了ノードを入力と承認条件に照合します。画像は人物、配置、文字、破綻、動画は開始画像の忠実度、時間方向の形状、動き、カット、音声を確認します。下流実行前にキャンバスへ承認記録を残します。revisionが古い場合は別の書き手が変更しています。再取得して差分を調整し、新トークンで意図した変更を再試行します。workflow_executeで曖昧な通信失敗が出たら、実行済みの可能性があるため、再試行前にキャンバスとrun状態を確認します。無条件の再試行は有料処理を重複させます。workflow_wait_runが時間切れでもrun_idを保ち、後で照会します。クライアント側の時間切れは生成失敗を意味しません。

制約とコスト管理

Workflow MCP呼び出しはキャンバスを整理しますが、有料生成は通常の実行・クレジット規則に従います。モデルの提供状況、入力、時間、品質、処理時間はモデルで変わります。期限切れキーや、0以外に設定した月間枠を使い切ったキーは拒否されます。HTTPにも制限があり、429では高頻度に再試行せずRetry-Afterに従います。必要な対象だけを実行し、承認済み上流を再実行せず、run_id、対象ID、プロンプト版、Asset ID、確認結果を記録します。新しいグラフは全ショット前に一つの短い枝で検証します。