代表ワークフロー

エージェントからCMO AI Proを使う典型的な組み立て方です。すべてのワークフローは、 確定・公開の手前で止まり、最後の判断を画面へ渡します。

漫画制作など長い工程では、作業前に get_workflow_guide（または MCP プロンプト manga / manga_short_video・資料 cmo-ai-pro://guides/<topic>）で手順書を読み、人の確認が必要な 箇所では必ず利用者に確認してから進めてください。

1. 案件と商品マスタを準備する

新しい商材の作業をMCPから始める場合は、最初に案件と商品マスタを作ります。

create_project                     案件を作成して project.id を取得する
  ↓
upsert_product_master              商品名、任意URL、任意メモを保存する
  ↓
get_project                        作成した案件の概要を確認する

既存案件から始める場合は list_projects で project_id を特定し、必要に応じて upsert_product_master だけ実行します。同じ作成操作を再試行するときは、必ず同じ idempotency_key を使ってください。

通常案件は作成時点から active で、案件自体に下書き状態はありません。作成した案件はAPIキー発行者の 個人領域ではなく、キーに固定された組織へ保存され、同じ組織のメンバーに共有されます。

2. リサーチをCMO AI Proへ蓄積する

エージェントが集めた情報を案件の材料にします。

list_projects                      案件IDを特定する
  ↓
save_material (input_type: "text")  収集した本文を保存する（消費なし）
save_material (input_type: "url")   URLを保存して文字起こしを開始する（30クレジット）
  ↓
get_job_status                     文字起こしの完了を確認する（URLの場合）
  ↓
list_materials                     状態が ready になったことを確認する

参考資料は1件ずつ保存します。まとめて保存するツールはありません。件数が多い場合は、 1分あたりの呼び出し上限に収まるよう間隔を空けてください。

3. リサーチ本文を作る・追記する

get_research_document              現在の本文と updatedAt を取得する
  ↓
start_fact_research (generate)     本文がなければ事実リサーチを開始する（400クレジット）
  または
append_research_document           エージェントの調査結果を追記する（消費なし）
  または
start_fact_research (append)       AIによる追加リサーチを開始する（400クレジット）
  ↓
get_job_status                     完了を確認する

追記は必ず get_research_document の直後に行ってください。 expected_updated_at に 取得した updatedAt を渡します。値が合わないと conflict になります。これは、他の人が 画面で編集した内容を、エージェントが上書きしてしまう事故を防ぐ仕組みです。

conflict が返ったら、読み直して内容を確認してから、追記内容を作りなおしてください。

記事LP動画を作る（MCP）

記事LP動画は、先に get_workflow_guide の article-video（または資料 cmo-ai-pro://guides/article-video）を読み、次の順で進めます。

list_article_video_templates       参考動画の型と枠を確認する
  ↓
start_article_video_asset_still    足りない静止画素材を用意する
list_article_video_assets          素材のプレビューを利用者へ渡す
  ↓
start_article_video                動画の版を作る（未動画化なら assets_pending）
  ↓ 利用者がプレビューを確認し、発言を user_confirmation に記録
start_article_video_assets_animation  未動画化素材をまとめて動画化する
  ↓
get_article_video                  完成動画と checks を取得する
repair_article_video / regenerate_article_video  必要なら新しい版を作る

checks は機械点検であり承認ではありません。外部AIは画像・動画を見られないため、完成動画の採用と記事LPへの配置は利用者が画面で判断します。素材画像は設定単価、動画は尺帯のクリップ単価と動き単価を使い、実際の設定値を優先します。

記事LPを組み立てる・別の記事を写す（MCP）

記事LPエディタが使える組織（Team・Agency・Enterpriseの契約中の組織）では、記事LPの下書きをMCPだけで作り、本文・素材・表示設定まで 組み立てられます。既にある記事LP（別の案件や別の環境で作ったもの）を、同じ内容で写すことも できます。ツールの詳細は記事LPエディタツールを参照してください。

create_project / list_projects     写し先の案件を決める（必要なら新しく作る）
  ↓
create_official_article            空の下書きを作る（revision 0）
get_official_article               allowedOperations・allowedSettingKeys・各種契約を読む
  ↓
prepare_official_article_asset_upload  素材ごとに一時アップロード先を準備する
  PUT uploadUrl                        requiredHeaders を付けて実体を1回送る
complete_official_article_asset_upload 確定して新しい assetId を受け取る
  ↓
update_official_article (insert)   ブロックを分けて順番に入れる（expected_revision を引き継ぐ）
update_official_article (updateSettings)  表示設定を最後に入れる
  ↓
get_official_article               入った内容を元と照らし合わせる
  ↓ 利用者が画面で見た目を確認し、ZIPに書き出す

素材は写し先の案件に入れ直します。 記事の画像・漫画・動画は、その記事と同じ案件の ready 素材しか使えません。元の記事の素材をダウンロードし、写し先の記事へアップロードして、返された 新しい assetId に置き換えます。同じ案件の中で写すときは、元の assetId をそのまま使えます。

• sha256 と byte_size は送る実体そのものから計算します。
• uploadUrl へは requiredHeaders（Content-Type など）を付けて1回だけ送ります。
• 動画（MP4）は確定時の検査に時間がかかり、complete が retryable: true のエラーを返すことが

あります。少し待ってから、同じ upload_id で complete をもう一度呼んでください。同じ idempotency_key で prepare を呼び直すと、state: "processing" のように現在の状態が返り、 uploadUrl は返りません。実体を送り直す必要はありません。

• 途中で止まってもやり直せるよう、「元の素材ID → 新しい assetId」の対応を手元に記録しながら進めます。

ブロックIDは新しく振ります。 写すときは、元のブロックごとに新しいUUIDを作り、対応表を 持ちます。本文の中でほかのブロックを指す値（settings.stickyCtaAfterBlockId、段階表示の targetBlockId、アンケートの移動先など）も、同じ対応表で新しいIDへ置き換えます。目印 （style.anchor）とページ内リンク #目印の名前 は名前で結ばれるので、そのままで構いません。

ブロックは分けて入れます。 1回の update_official_article で送れる操作は50件までです。 25件前後ずつ、afterId に直前に入れたブロックIDを指定して末尾へ足していきます。応答の revision を次の expected_revision に渡します。idempotency_key は呼び出しごとに変えます （例: 記事IDと何件目からかを組み合わせる）。

表示設定は最後に入れます。 updateSettings には、元の記事の settings から、 get_official_article の allowedSettingKeys にある項目だけを渡します。追従CTAの開始位置の ようにブロックを指す設定があるため、ブロックを入れ終わってから送ります。

最後に照らし合わせます。 get_official_article で取り直し、ブロック数・並び順・各ブロックの 中身・settings が、ID と assetId の対応を戻したうえで元と一致することを確認します。

• 検証に落ちたときは、error.details の operationIndex・blockId で場所が分かります。
• conflict が返ったときは、ほかの人が画面で同じ記事を編集しています。取り直してから続けてください。本文が「この操作は許可されていません。」のときは、組織のプランが条件を満たしていません。作業を止め、利用者にプランの条件を伝えてください。
• 写し先で使えない部品（保存先が未対応の装飾など）は保存時に拒否されます。get_official_article の

decorationContract.capabilities を先に確認してください。

MCPから記事の公開・削除はできません。仕上がりの確認とZIP書き出し（一般公開は準備中）、試しに作った記事のアーカイブは、 利用者が記事LPエディタの画面で行います。

4. 戦略仮説を用意する

start_strategy_generation          AIで1〜5案を生成する（60クレジット・案数によらず一律）
  ↓
get_job_status                     完了を確認する
  ↓
list_strategies                    生成された案を一覧で確認する
get_strategy                       気になる案の全文を読む

エージェント自身が組み立てた仮説を登録する場合は save_strategy を使います（消費なし）。

採用の確定はCMO AI Proの画面で行います。 どの仮説を採用するかは、内容を読んだ人が 決める工程です。

5. テンプレートを登録して解析する

prepare_banner_template_upload     署名付きアップロードURLを受け取る
  ↓
（署名付きURLへ画像を直接アップロード）
  ↓
confirm_banner_template_upload     実体を検証して登録する（status: collected）
  ↓
start_template_analysis            テンプレート化を開始する（15クレジット）
  ↓
get_job_status                     完了を確認する
  ↓
list_templates (status: "templated")  生成に使える状態になったことを確認する

既存のテンプレートから探す場合は list_templates または search_templates を使います。

6. バナーを生成する

先に list_projects と get_project で対象案件を確定し、商品情報・リサーチ・採用済みの戦略仮説を確認します。 通常はリサーチを確認し、使う戦略を画面で採用してから生成へ進みます。戦略の保存と採用は別です。 これは制作の推奨工程です。MCPの機械的な必須条件は案件に属する strategy_id で、採用状態自体を検査する引数ではありません。 テンプレートを使う場合は status: "templated" を確認してください。アップロードや登録だけでは生成に使えません。 MCPの template_ids は任意です。テンプレートを省略した生成に、テンプレートの新規アップロードを必須として案内しないでください。 接続成功だけを根拠に、すぐ生成を開始しないでください。

get_credit_balance                 残高を確認する
  ↓
start_banner_generation            戦略仮説 × テンプレートで生成を開始する
  ↓                                （max(テンプレート数, 1) × count × 60クレジット）
get_job_status                     完了を確認する
  ↓
get_banner_results                 結果と画像URLを取得する
  ↓
（CMO AI Proの画面で比較し、判定を確定して公開する）

7. 記事画像を作る

preview_article_images               記事URLから取り込み候補を取得する
  ↓
ingest_article_image_templates       選択した候補を取り込みテンプレ化を開始する
  ↓                                  （15クレジット × candidates の件数）
get_job_status                       テンプレ化の完了を確認する
  ↓
list_article_images (status: "templated")  利用可能な記事画像を確認する
  ↓
start_article_creative_generation      記事LP画像生成を開始する（60クレジット）
  ↓
get_job_status                       完了を確認する
  ↓
get_article_creative_results         結果と画像URLを取得する
  ↓
（CMO AI Proの画面で候補を比較し、確定して公開する）

記事画像の確定・公開はCMO AI Proの画面で行います。

8. 漫画を作る

制作前に get_workflow_guide の manga を読む。ショート動画にする場合は manga-short-video も読む。

get_manga_style_candidates           参考漫画記事URLからコマ候補を取得する
  および/または
prepare_manga_style_image_upload     参考画像アップロード用URLを受け取る
  ↓ （署名付きURLへ画像を直接アップロード）
start_manga_style_creation           作画スタイル作成を開始する（50クレジット）
  ↓
get_job_status                       完了を確認する
  ↓
list_manga_styles (job_id)           作成された styleId を取得する
  ↓
duplicate_manga_style                公式スタイルの文字・吹き出し指示を変える場合は、先に自社のスタイルへ複製する
  ↓
update_manga_style_panel_text_instruction
                                     全コマ共通の文字・吹き出し指示を書く場合（文字のあるコマのコマ内容へ自動で付け足す）
  ↓
create_manga_work                    漫画作品を作成する
  ↓
start_manga_character_generation     キャラクター生成を開始する（30クレジット）
  ↓
get_job_status                       完了を確認する
  ↓
import_manga_panels                  コマ設定を投入する
  ↓
update_manga_panel                  コマ内容・登場人物・構図を直す場合
  ↓
start_manga_panel_generation         コマ生成を開始する（60クレジット × コマ数）
  ↓
get_manga_work                       進捗と結果を確認する
  ↓
（CMO AI Proの画面で採用・書き出し・公開する）

MCP経由の生成では完了時に結果が自動採用されます。コマの採用・書き出し・公開は画面で 行います。

9. 漫画をショート動画にする（MCP）

漫画作品をショート動画（静止コマ＋セリフに合わせた吹き出し表示。縦長 9:16・正方形 1:1・横長 16:9 から選ぶ）に仕上げる工程です。 ネーム・キャラクター・コマは手順書 manga（プロンプト manga / topic manga）に従い、 声以降は手順書 manga-short-video（プロンプト manga_short_video / get_workflow_guide の topic manga-short-video、資料 cmo-ai-pro://guides/manga-short-video）に従います。 漫画制作と動画工程を1つの制作として進め、動画工程だけを切り離して完結させないでください。

消費クレジットの単価はクレジットを参照してください（本節では重複して書きません）。

ツールの呼び出し順

（節8まで）漫画作品（work）を用意する
  ↓
create_manga_short_video             作品とコマ範囲から動画プロジェクトを作る
  ↓
list_voice_presets                   声プリセットと試聴URLを確認する
preview_voice                        1行試聴（0クレジット・1組織24時間200回まで。tags で演技を試聴）
  ↓
update_manga_short_video_settings    話者ごとの声・読み（reading_overrides_json）・行ごとの演技（line_directions）・
                                     間（audio_timing。min_panel_sec を含む）・BGM 区間（bgm_mode / bgm_sections_json 等）・
                                     効果音（sound_effects）・持ち込み音源（uploaded_audio）を保存する
  ↓
（BGM/効果音が未登録なら）
start_manga_short_video_sound_generation   kind: bgm または sfx で生成する
  または
prepare_manga_short_video_audio_upload     持ち込み mp3/wav 用の署名付きURLを受け取る
  → update_manga_short_video_settings で uploaded_audio を登録
  ↓
start_manga_short_video_build        stage: "audio" で音声を組み立てる
  ↓
get_job_status                       進捗を確認する（下記「ジョブの待ち方」）
  ↓
get_manga_short_video                ミックス・確認用パラパラ漫画・読み食い違いを確認する
  ↓
（利用者が音声を聴取・確認する — 下記「人が確認する7か所」）
  ↓
start_manga_short_video_build        stage: "video" + audio_build_id + audio_confirmation
  ↓
get_job_status
  ↓
get_manga_short_video                完成動画・panelReviewFlags・確認用画像を確認する
  ↓
（必要なら rebuild_panels / rebuild_expressions で該当コマだけ作り直し → 再度 get_job_status / get_manga_short_video）

コマを修正・再生成したあとは、同じ動画のまま stage: "audio" → stage: "video" の順に組み立て直します。組み立てはそのたびに各コマの採用中の画像を読み込むため、create_manga_short_video で新しい動画を作り直す必要はありません（作り直すと文字なし版・目と口の差分が全コマ再課金になります）。

効果音の lineIndex は、そのコマのセリフ（serif）だけを台本 order 順に数えた番号（1 始まり）です。 効果音の台本行は数えません。BGM を使わない場合は bgm_mode: "none" を利用者に確認のうえ明示します （黙って無音にしない）。

bgm_sections_json など JSON 文字列引数は、手順書 04-sound と同じ形の配列を文字列化して渡します。 例:

[{"assetId":"<BGM資産のID>","fromPanel":1,"toPanel":2,"fadeOutLastPanel":true,"fadeInSec":0},{"assetId":"<別BGMのID>","fromPanel":4,"toPanel":17}]

区間に含めないコマは BGM なしになります。

人が確認する7か所

手順書 manga-short-video の索引（00-index）と同じです。漫画制作（manga）では ネーム・キャラクター・コマ、動画工程では次の4点を、利用者が決めるまで次工程に進みません。

1. ネーム（manga）
2. キャラクター（manga）
3. コマ（manga）
4. 声の選択（manga-short-video-voice — 試聴と読み上げチェック）
5. BGM の選択（manga-short-video-sound — 音量バランスと尺。BGM なしは bgm_mode: "none" の明示）
6. 音声の OK（manga-short-video-audio — ミックスと確認用パラパラ漫画を聴取・確認）
7. 動画の OK（manga-short-video-video — 吹き出し切り抜きの確認画像・完成 mp4、panelReviewFlags

の確認。目・口の動きがオンなら確認シート confirmExpressionSignedUrl で動かす人物と 口・目も確認する。必要なら rebuild_panels / rebuild_expressions）

生成ジョブの成功、transcriptMismatches の有無、自動点検結果だけを「OK」と読み替えないでください。 AI の提案やツールの完了応答は、利用者の承認の代わりになりません（大原則2）。

音声確認と `audio_confirmation`

動画組み立て（stage: "video"）では、get_manga_short_video の recentBuilds で成功した音声組み立て（kind: "audio"）の id を audio_build_id に指定し、 利用者の確認を audio_confirmation で記録します。

• confirmed_by_user: リテラル true のみ有効
• user_message: 利用者の発言を引用（1〜500字）。利用者が確認の工程まで含めて任せている場合（例「完成まで全て任せる」）は、その委任の発言を引用する。制作の一部だけを任せる依頼なら、利用者の音声OKの発言を求める
• 確認を得ていないのに埋めない。未指定・confirmed_by_user が true でないときは 課金予約の前に 業務エラー audio_not_confirmed（retryable: false）で拒否される
• 形式不正（型・文字数超過など）は validation_error（retryable: false）

利用者にミックスと確認用パラパラ漫画を聴取・確認してもらい、その発言を user_message に入れてから stage: "video" を呼び出してください（確認の工程まで任されている場合は、上記のとおり委任の発言を引用します）。コマを直して音声を組み立て直した場合は、新しい audio_build_id について確認を取り直します。詳細は手順書 05-audio・06-video と ツールリファレンス（漫画）の start_manga_short_video_build を参照してください。

所要時間の目安

• 音声の組み立て（stage: "audio"）: 数分が目安です
• 動画の組み立て（stage: "video"）: 10分前後が目安です（コマ数と、文字なし版を新しく作るコマの数で変わります）
• BGM・効果音の生成: 数十秒から数分が目安です
• 待ち方は下記「ジョブの待ち方」を参照してください
• 完成尺の見積もり: 手順書 00-index の「尺の見積もり」（標準速さ 1.3 倍で約 6.5 字／秒、60 秒目安は

読み上げ本文おおよそ 350〜400 字）をネーム段階で参照してください

ジョブの待ち方

生成処理は数十秒から数分かかります。次を守ってください。

• get_job_status の呼び出しは間隔を空ける（1分あたり60回の上限があります）
• displayStatus が stale になったら、処理が中断した可能性があります。結果を確認してください
• 完了を待たずに次の生成を始めると、同時実行の上限（組織あたり32件）に達する場合があります

失敗したときのやり直し

エージェントに任せてよい範囲

CMO AI Proは、ユーザーのAPIキーで認証されたエージェントの操作を、そのユーザー本人の操作として 扱います。リサーチの保存から生成の開始までを、確認を挟まず連続して実行して構いません。

一方で、次の5つはツールとして存在しません。エージェントがどれだけ確信を持っていても実行できません。

• 戦略仮説の採用確定
• バナーの判定確定・公開
• 記事画像の確定・公開
• コマの採用・書き出し・公開
• データの削除

これが、成果物が人の確認なしに公開まで到達しないことの担保です。