はじめに

​
商品と顧客像から質問を設定する

商品カテゴリー、比較対象、顧客像と検討段階を組み合わせ、商品に対応する質問を作ります。

​
この依頼で使う

「主力商品の比較・おすすめ質問を、顧客層ごとに計測したい」

​
取得前に決める

対象商品、商品仕様、比較相手、顧客像、地域、AI を確認します。観測商品一覧を自社の全商品マスターと同一視せず、不足する商品は依頼者の承認済みカタログで補います。

CLI クイックスタートで認証を済ませ、orc workspace current --json で対象を確認します。例の ID・URL・日付・設定値は対象に置き換えます。書き込みは承認済みの変更に限ります。

​
1. 計測チャンネルを確認する

利用可能な安定したチャンネルを取得します。返却されたチャンネル id を YOUR_CHANNEL_ID として、プロンプト作成・実行・回答取得の全工程で同じ値を使います。

orc channels list --json

計測は、channels list → prompts create --platforms <channel> → runs create --model-channel-id <channel> --wait → answers list の順に進めます。

​
2. 承認済みの商品カタログを同期する

カスタム属性キーを確認し、不足する商品を一括登録します。created と rejected を別々に確認し、拒否された項目を成功として扱いません。

orc products attribute-keys list --workspace YOUR_WORKSPACE_ID --json
printf '%s' '{"products":[{"external_id":"YOUR_EXTERNAL_ID","brand_id":"YOUR_BRAND_ID","name":"YOUR_PRODUCT_NAME","attributes":{"category":"YOUR_CATEGORY"}}]}' \
  | orc products create --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_CREATE_REQUEST_KEY --json
orc products list --brand-id YOUR_BRAND_ID --workspace YOUR_WORKSPACE_ID --json
orc products get YOUR_PRODUCT_ID --workspace YOUR_WORKSPACE_ID --json

商品を修正するときは、updated、skipped、rejected の各項目を確認します。

printf '%s' '{"products":[{"id":"YOUR_PRODUCT_ID","name":"YOUR_UPDATED_PRODUCT_NAME"}]}' \
  | orc products update --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_UPDATE_REQUEST_KEY --json

​
3. 商品と既存の質問を読む

商品 ID、観測済みの競合と質問、顧客像を取得します。未観測の商品属性を推測して比較文に入れません。

orc products list --brand-id YOUR_BRAND_ID --json
orc products competitors list YOUR_PRODUCT_ID --json
orc products prompts list YOUR_PRODUCT_ID --json
orc personas list --json

​
4. 顧客像と意図の組み合わせを埋める

エージェントがカテゴリー検索、商品比較、用途別の推薦を提案します。既存質問を再利用し、優先する商品から確認済み候補をプレビューします。

orc prompts create --topic-id YOUR_TOPIC_ID --text 'YOUR_APPROVED_SHOPPING_QUESTION' --persona-ids YOUR_PERSONA_ID --platforms YOUR_CHANNEL_ID --country-code JP --preview true --idempotency-key YOUR_REQUEST_KEY --json

​
5. 登録結果と商品対応を確認する

確認した質問を新しいリクエストキーで登録し、返却された ID を読み戻します。質問の登録はショッピング画面での観測成功を意味しません。商品と質問の対応は表にも残します。保存した質問をチャンネルで実行し、回答を同じチャンネルで絞り込みます。

orc prompts create --topic-id YOUR_TOPIC_ID --text 'YOUR_APPROVED_SHOPPING_QUESTION' --persona-ids YOUR_PERSONA_ID --platforms YOUR_CHANNEL_ID --country-code JP --idempotency-key YOUR_CREATE_REQUEST_KEY --json
orc prompts get YOUR_CREATED_PROMPT_ID --json
orc runs create --prompt-id YOUR_CREATED_PROMPT_ID --model-channel-id YOUR_CHANNEL_ID --idempotency-key YOUR_RUN_REQUEST_KEY --wait --json
orc answers list --prompt-id YOUR_CREATED_PROMPT_ID --platform YOUR_CHANNEL_ID --json

​
6. 廃止した商品をカタログから除く

承認済みカタログで廃止が確定した商品だけを論理削除します。まず --dry-run で本文とワークスペースを確認し、非対話実行では --yes を付けます。deleted と skipped を別々に確認してください。

printf '%s' '{"ids":["YOUR_RETIRED_PRODUCT_ID"]}' \
  | orc products delete --workspace YOUR_WORKSPACE_ID --stdin --dry-run --json
printf '%s' '{"ids":["YOUR_RETIRED_PRODUCT_ID"]}' \
  | orc products delete --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_DELETE_REQUEST_KEY --yes --json

​
持ち帰る結果

商品 × 顧客像 × 意図の表、質問 ID、優先順位、対象に含めなかった商品・観測条件。

取得に失敗した場合は、エラーと対象条件を残します。空のデータ、ページング途中、権限不足を完了した調査に含めません。

​
次の作業

products リファレンス · ワークフロー一覧 · 購買段階ごとの質問を設定する

失敗が残る場合は、失敗を報告して再検証するで、このワークフローと失敗した手順を報告へ添えます。