購買段階ごとの質問を設定する
認知・比較・購入判断の質問とブランド評価の質問を整理し、確認したものを登録します。
この依頼で使う
「新しいブランドの計測を、検討初期から購入判断まで始めたい」
取得前に決める
ブランド、顧客層、提供商品、対象地域と言語、AI、測定頻度を確認します。エージェントが質問候補を作る前に、サービスのモデル・地域カタログと既存プロンプトを取得します。
CLI クイックスタートで認証を済ませ、orc workspace current --json で対象を確認します。例の ID・URL・日付・設定値は対象に置き換えます。書き込みは承認済みの変更に限ります。
1. 計測チャンネルと地域を確認する
サービスから現在のチャンネルと地域のカタログを取得します。チャンネルは返却された安定した id、地域は返却された code を使います。チャンネルの一覧に掲載されていても、プランや認証情報による利用権限を保証しません。
orc channels list --json
orc regions list --json以降の計測は、channels list → prompts create --platforms <channel> → runs create --model-channel-id <channel> --wait → answers list の順に進めます。
2. 既存の対象を取得する
ブランド、トピック、質問を取得し、購買段階と意図の表を作ります。商品固有の質問は商品情報を根拠にします。
orc brands get YOUR_BRAND_ID --json
orc topics list --brand-id YOUR_BRAND_ID --json
orc prompts list --jsonbrands get の notes（説明）、offerings（サービス）、audience（対象者・説明・割合）を質問候補の根拠にします。別のペルソナ一覧を作り直す必要はありません。有効な対象者と割合を参考に候補を配分します。情報が不足する場合はブランドプロフィールを編集するで修正してから進みます。
3. 候補を作って一件ずつ検証する
エージェントが抜けている段階の質問を提案し、登録する候補を決めます。preview は保存せずに設定を解決します。YOUR_REQUEST_KEY はこのリクエスト用の一意な値に置き換えます。
orc prompts create --topic-id YOUR_TOPIC_ID --text 'YOUR_APPROVED_QUESTION' --platforms YOUR_CHANNEL_ID --region-id YOUR_REGION_CODE --preview true --idempotency-key YOUR_REQUEST_KEY --json4. 確認済みの質問を登録して読み戻す
意図した計測条件を確認してから、preview を外して新しいリクエストキーで作成します。返却された ID で読み戻し、必要なら tags update で既存タグを設定します。一括置換なので残すタグも含めます。
orc prompts create --topic-id YOUR_TOPIC_ID --text 'YOUR_APPROVED_QUESTION' --platforms YOUR_CHANNEL_ID --region-id YOUR_REGION_CODE --idempotency-key YOUR_CREATE_REQUEST_KEY --json
orc prompts get YOUR_CREATED_PROMPT_ID --json
orc prompts tags update YOUR_CREATED_PROMPT_ID --tag-ids YOUR_TAG_IDS --config-revision YOUR_CONFIG_REVISION --json保存した質問をチャンネルで実行し、回答を同じチャンネルで絞り込んで読み戻します。
orc runs create --prompt-id YOUR_CREATED_PROMPT_ID --model-channel-id YOUR_CHANNEL_ID --region-id YOUR_REGION_CODE --idempotency-key YOUR_RUN_REQUEST_KEY --wait --json
orc answers list --prompt-id YOUR_CREATED_PROMPT_ID --platform YOUR_CHANNEL_ID --json持ち帰る結果
段階・意図・質問文・設定・作成 ID の一覧。未計測の段階と追加しなかった候補の理由も残します。
取得に失敗した場合は、エラーと対象条件を残します。空のデータ、ページング途中、権限不足を完了した調査に含めません。
次の作業
失敗が残る場合は、失敗を報告して再検証するで、このワークフローと失敗した手順を報告へ添えます。