本文へ移動
CMO AI Pro
ログイン

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真偽値任意falsetrue でアーカイブ済みも含める

応答

フィールド内容
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整数任意31〜5
idempotency_key文字列必須—1〜128文字

user_hypothesis には、エージェントが持っている仮説や方向性を渡せます。count は生成する案の数です。

応答

フィールド内容
jobIdジョブID
reusedtrue なら既存ジョブを再利用(新規消費なし)
statusqueued

エラー

code発生条件
payment_requiredクレジット不足、または日次上限
validation_error前提情報が足りない、入力が要件を満たしていない
not_found案件が存在しない、または組織外

消費

60クレジットです。生成する案の数(count)にかかわらず一律です。

生成結果は get_job_status で完了を確認したあと、list_strategies で取得できます。