CMO AI Pro Developers
戦略ツール
戦略仮説の読み取り、保存、生成を行う4つのツールの仕様です。
最終更新日:2026年8月26日
戦略仮説の読み取り、保存、生成に使う4つのツールです。
戦略仮説の採用確定はMCPから実行できません。 保存・生成された仮説はすべて未採用の状態で、 どれを採用するかはCMO AI Proの画面で人が判断します。バナー生成には採用状態にかかわらず strategy_id を指定できますが、案件の正式な採用はUIの操作でのみ確定します。
list_strategies
案件の戦略仮説を表示順で取得します。本文は先頭400文字のみ返ります。全文が必要な場合は get_strategy を使ってください。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
include_archived | 真偽値 | 任意 | false | true でアーカイブ済みも含める |
応答
| フィールド | 内容 |
|---|---|
strategies[].id | 戦略仮説ID |
strategies[].conceptLabel | コンセプトの短いラベル |
strategies[].contentPreview | 本文の先頭400文字 |
strategies[].isAdopted | 採用済みか |
strategies[].userHypothesis | 生成時に与えられた仮説 |
strategies[].sortOrder | 表示順 |
strategies[].createdAt | 作成日時 |
strategies[].updatedAt | 更新日時 |
strategies[].archivedAt | アーカイブ日時。未アーカイブは null |
strategies[].contentPreview は外部由来として untrusted.fields に申告されます。
get_strategy
戦略仮説の全文を取得します。案件に属していることが確認されます。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
strategy_id | 文字列 | 必須 | — | UUID |
応答
| フィールド | 内容 |
|---|---|
strategy.id | 戦略仮説ID |
strategy.conceptLabel | コンセプトの短いラベル |
strategy.contentMd | 本文の全文(Markdown) |
strategy.isAdopted | 採用済みか |
strategy.userHypothesis | 生成時に与えられた仮説 |
strategy.sortOrder | 表示順 |
strategy.createdAt | 作成日時 |
strategy.updatedAt | 更新日時 |
strategy.archivedAt | アーカイブ日時 |
エラー
| code | 発生条件 |
|---|---|
not_found | 案件または戦略仮説が存在しない、組織外、案件に属していない |
strategy.contentMd は外部由来として untrusted.fields に申告されます。
save_strategy
エージェントが作った戦略仮説を、未採用の状態で保存します。クレジットは消費しません。 表示順は既存の末尾に追加されます。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
concept_label | 文字列 | 任意 | — | 20文字以内。省略時は 手動仮説 |
content_md | 文字列 | 任意 | — | 80,000文字以内。省略時は既定のひな形 |
idempotency_key | 文字列 | 必須 | — | 1〜128文字 |
concept_label を省略、または空文字にすると 手動仮説 になります。content_md を省略すると CMO AI Proの既定のひな形が入ります。
応答
| フィールド | 内容 |
|---|---|
strategy | 保存された戦略仮説(保存された行の内容) |
エラー
| code | 発生条件 |
|---|---|
not_found | 案件が存在しない、または組織外 |
internal_error | 保存に失敗した |
start_strategy_generation
戦略仮説の生成を開始します。完了は待ちません。
パラメータ
| パラメータ | 型 | 必須 | 既定値 | 制約 |
|---|---|---|---|---|
project_id | 文字列 | 必須 | — | UUID |
user_hypothesis | 文字列 | 任意 | 空文字 | 20,000文字以内 |
count | 整数 | 任意 | 3 | 1〜5 |
idempotency_key | 文字列 | 必須 | — | 1〜128文字 |
user_hypothesis には、エージェントが持っている仮説や方向性を渡せます。count は生成する案の数です。
応答
| フィールド | 内容 |
|---|---|
jobId | ジョブID |
reused | true なら既存ジョブを再利用(新規消費なし) |
status | queued |
エラー
| code | 発生条件 |
|---|---|
payment_required | クレジット不足、または日次上限 |
validation_error | 前提情報が足りない、入力が要件を満たしていない |
not_found | 案件が存在しない、または組織外 |
消費
60クレジットです。生成する案の数(count)にかかわらず一律です。
生成結果は get_job_status で完了を確認したあと、list_strategies で取得できます。