---
title: 商品と顧客像から質問を設定する
description: 商品カテゴリー、比較対象、顧客像と検討段階を組み合わせ、商品に対応する質問を作ります。
canonical_url: https://orchestor.io/docs/cli/workflows/shopping-prompt-setup
markdown_url: https://orchestor.io/docs/cli/workflows/shopping-prompt-setup.md
contentType: how-to
---

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

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

## この依頼で使う

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

## 取得前に決める

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

[CLI クイックスタート](https://orchestor.io/docs/cli/quickstart.md)で認証を済ませ、`orc workspace current --json` で対象を確認します。例の ID・URL・日付・設定値は対象に置き換えます。書き込みは承認済みの変更に限ります。

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

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

```bash
orc channels list --json
```

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

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

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

```bash
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` の各項目を確認します。

```bash
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、観測済みの競合と質問、顧客像を取得します。未観測の商品属性を推測して比較文に入れません。

```bash
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. 顧客像と意図の組み合わせを埋める

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

```bash
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 を読み戻します。質問の登録はショッピング画面での観測成功を意味しません。商品と質問の対応は表にも残します。保存した質問をチャンネルで実行し、回答を同じチャンネルで絞り込みます。

```bash
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` を別々に確認してください。

```bash
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 リファレンス](https://orchestor.io/docs/cli/product.md) · [ワークフロー一覧](https://orchestor.io/docs/cli/workflows.md) · [購買段階ごとの質問を設定する](https://orchestor.io/docs/cli/workflows/brand-prompt-setup.md)

失敗が残る場合は、[失敗を報告して再検証する](https://orchestor.io/docs/cli/workflows/workflow-feedback.md)で、このワークフローと失敗した手順を報告へ添えます。

---

[Documentation index](https://orchestor.io/docs/llms.txt)