> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/itp-guide/create-trainings.md).

# ロールプレイシナリオを作成する

ロールプレイシナリオは、受講者がデジタルヒューマンと音声で会話して練習するトレーニングです。シナリオでは「何を練習するか（目的と状況設定）」「誰と練習するか（ペルソナ）」「どう評価するか（評価基準）」を決めます。

このページでは、画面からロールプレイシナリオを作る手順と、作成後の管理方法を説明します。質問に口頭で答える形式のトレーニングは[Q\&Aシナリオを作成する](https://docs.digitalhumans.jp/itp-guide/create-trainings/qa-scenarios.md)、評価基準の詳細は[評価基準を設定する](https://docs.digitalhumans.jp/itp-guide/create-trainings/assessments.md)をご覧ください。

{% hint style="info" %}
シナリオを作成・編集できるのは、Author（シナリオ作成者）の権限を持つユーザーと、Organization Admin（組織管理者）です。\
権限の割り当ては[ユーザーとロール](https://docs.digitalhumans.jp/itp-guide/initial-setup/users-and-roles.md)をご覧ください。
{% endhint %}

## 作成の流れ

画面では、練習したい場面を「シナリオコンテキスト」に文章で書き、「生成」を押してシナリオのたたき台を AI に作らせます。そのうえで、ペルソナ、受講者への指示、評価基準を確認・修正して保存します。

1. シナリオの種類を選ぶ
2. シナリオコンテキストを書いて「生成」を押す
3. 生成された内容を確認・設定する
4. 名前とタグを確認して保存する

手順3では、次の項目を確認・設定します。画面は「次へ」「戻る」で移動します。画面に表示される順序は、このページの説明の順と異なる場合があります。

* ペルソナ（相手役）
* トレーニングで使う言語
* 参加者向けの指示
* 評価基準

{% hint style="warning" %}
AI による自動生成の結果は、最初は英語で作られます。日本語のシナリオにするには、画面の「AIで調整」で日本語に直してください。詳しくは[シナリオ作成のコツ](https://docs.digitalhumans.jp/itp-guide/create-trainings/best-practices.md)をご覧ください。
{% endhint %}

## 手順1: シナリオの種類を選ぶ

1. ライブラリで「新しい没入型トレーニング」をクリックします。
2. 「新しいトレーニングを作成」が表示され、「作成するシナリオの種類を選択してください」と案内されます。「ロールプレイシナリオ」を選びます。

選べる種類は次のとおりです。

| 種類            | 内容                                                                                                                                                  |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 「ロールプレイシナリオ」  | デジタルヒューマンとの自由な会話で練習します。このページで説明します                                                                                                                  |
| 「Q\&Aシナリオ」    | デジタルヒューマンが質問し、受講者が口頭で答えます。[Q\&Aシナリオを作成する](https://docs.digitalhumans.jp/itp-guide/create-trainings/qa-scenarios.md)をご覧ください。利用できるかどうかは、ご契約内容により異なります |
| 「練習シナリオ」      | 作成した本人だけが見て使える、個人練習用のロールプレイです。練習のスコアはレポートに含まれません                                                                                                    |
| 「ファイルからインポート」 | エクスポートしたファイルから、ロールプレイシナリオまたはQ\&Aシナリオを作成します                                                                                                          |

## 手順2: シナリオコンテキストを書いて生成する

次の項目を入力し、「生成」を押します。

| 項目           | 内容                             | 必須 |
| ------------ | ------------------------------ | -- |
| 「シナリオコンテキスト」 | 練習する場面の説明（下記）                  | 必須 |
| 「シナリオ名」      | シナリオのタイトル。空欄の場合は、AI が名前を付けます   | 任意 |
| 「学習ドメイン」     | シナリオの分類（下記）                    | 必須 |
| 「サポート資料」     | 参考テキストの貼り付け、またはファイルのアップロード（下記） | 任意 |

「生成」を押すと、シナリオコンテキストとサポート資料をもとに、ペルソナ、デジタルヒューマンへの指示文、参加者向けの指示、評価基準の案が作られます。説明に足りない情報があると、「いくつか確認の質問」が表示されます。選択肢を選ぶか回答を入力して、「送信」を押してください。説明が具体的なほど、意図に近いシナリオになります。

### シナリオコンテキストに書くこと

画面の「ガイド」では、次の5点に答える短い段落を書くよう案内されています。

| 観点（画面表記）  | 書く内容                                                        |
| --------- | ----------------------------------------------------------- |
| 「参加者の人物像」 | 受講者の立場と担当業務（例: 法人営業の担当者、入社1年目の窓口担当）                         |
| 「対話する相手」  | 相手役の名前、役職、性格、その場での気分。受講者との関係（既存のお客様、見込み客、同じチームのメンバーなど）も書きます |
| 「状況」      | この会話のきっかけと背景、何がかかっているか（例: 契約更新の危機、初回ヒアリング、値引きを求められている商談）    |
| 「目標」      | このセッションで受講者が達成すること                                          |
| 「成功の形」    | よい結果と判断できる行動や成果。AI はこれを採点とフィードバックに使います                      |

{% hint style="success" %}
**目標の書き方**\
具体的で、達成できたかどうかを判断できる行動の言葉で書きます。\
よい例: 「初回ヒアリングで、自由に答えてもらう質問を使い、お客様の課題を3つ聞き出す」\
よくない例: 「ヒアリングについて学ぶ」
{% endhint %}

相手役に、はっきりした態度（懐疑的、急いでいる、価格に敏感など）と、受講者を試す行動（話を遮る、反論する、黙り込むなど）を1つ持たせると、実践的な練習になります。

### 学習ドメイン

関連するシナリオをまとめる分類です。シナリオは必ずいずれかの学習ドメインに属します。学習ドメインは、組織設定の「ラーニングドメイン」タブで管理します。組織に学習ドメインが1つも無いと、シナリオを作成できません。

### サポート資料

ペルソナが会話で使う知識として、資料をアップロードできます。テキストを「参考テキスト」に貼り付けることもできます。

* 製品・サービスの仕様書
* 社内規程、応対マニュアル
* 競合他社との比較資料
* 研修テキスト、実際の会話の書き起こし

**対応形式:** PDF、DOCX、PPTX、TXT

アップロードした資料は、内容が抽出・要約され、会話中のペルソナの応答に使われます。アップロードできるファイルの数とサイズには上限があり、画面の「ファイル制限」に表示されます。上限の値について詳しくは、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。

社外秘の資料をアップロードする前に、データの取り扱いを[セキュリティとデータの取り扱い](https://docs.digitalhumans.jp/itp-guide/network-requirements/security-and-data.md)でご確認ください。

## 手順3: 生成された内容を確認・設定する

生成が終わったら、次の項目を確認し、必要に応じて修正します。

### ペルソナを確認する

「AI生成されたパーソナリティを確認」の画面です。生成が終わると、シナリオに合わせたパーソナリティとデジタルヒューマンが提案されます。必要に応じて変更します。

| 項目（画面表記）       | 内容                                                                                                                                                                                           |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 「パーソナリティタイプ」   | 相手役の性格の型です。セッション中の応答や振る舞いが、これで決まります。用意された型（シナリオの種類、製品・サービスをどの程度知っているか、会話への関わり方などをまとめたひな形）から選ぶか、「カスタムパーソナリティの説明」に書きます。カスタムの場合は、口調、会話への関わり方、反論やプレッシャーへの対応を具体的に書きます（例: 慎重だが、根拠があれば新しい提案にも耳を傾ける） |
| 「人物の名前」        | 相手役の名前（任意。例: 佐藤 美咲）                                                                                                                                                                          |
| 「人物のロール」       | 相手役の肩書きや立場（任意。例: マーケティング部長）                                                                                                                                                                  |
| 「人物の場所」        | 相手役がいる場所（任意）                                                                                                                                                                                 |
| 「デジタルヒューマンを選択」 | 相手役を演じるデジタルヒューマンです。セッションでは、このデジタルヒューマンの外見と声が使われます                                                                                                                                            |

デジタルヒューマンを変更すると、デジタルヒューマンへの指示文も、選んだデジタルヒューマンに合わせて更新されます。

### 言語を選ぶ

「トレーニング言語を選択」で、受講者がこのトレーニングで使える言語を選びます。1つ以上選ぶ必要があります。日本語で練習するシナリオでは、日本語を含めてください（下記の「そのほかの設定」をご覧ください）。

### 参加者向けの指示を確認する

「参加者向けの指示」は、セッションの開始前に受講者に表示される説明です。生成された下書きを、シナリオに合わせて修正します。会話の相手の立場や、セッションの目的を書いておくと、受講者が準備しやすくなります。

### 評価基準を設定する

「評価基準を選択」で、受講者をどのように評価するかを設定します。評価基準は任意で、後から追加することもできます。評価基準を1つも選ばずに保存すると、受講者のスコアは付きません。

1. **既存の評価を選ぶ**: 「AIによる提案」の評価や、組織で用意している「デフォルトの評価」から選びます。
2. **新しい評価を作る**: 「カスタム評価を追加」から、タイトル、説明、基準を入力して作ります。
3. **重要度の順に並べる**: 評価を優先度の高い順に並べます。
4. **重みを設定する（任意）**: 「評価の重み付けをカスタマイズ」で、評価ごとの比重を設定します。重みの合計は100%にします。

よく使われる評価の観点には、ヒアリング力、商品知識、共感・信頼関係づくり、反論への対応、コミュニケーションの質などがあります。設定項目の詳細は[評価基準を設定する](https://docs.digitalhumans.jp/itp-guide/create-trainings/assessments.md)をご覧ください。

この画面では、受講回数制限、制限時間、合格認定も設定できます（下記の「そのほかの設定」をご覧ください）。

## 手順4: 名前とタグを確認して保存する

最後の画面で、名前、タグ、公開の設定を確認し、「トレーニングを保存」を押します。

* **タグ**: スキルの分類、商品・サービスの系統、難易度などを表す、分類・絞り込み用のラベルです。タグは組織で共通のもので、1つのシナリオに複数付けられます。タグは、組織設定の「タグ」タブで管理します。チームへの割り当てには使いません。
* **公開**: 「参加者がこのトレーニングにアクセスできるようにする」をオンにすると、公開した状態で保存されます。オフのままなら下書きです（下記の「公開する」をご覧ください）。

保存する前に、「チャットでテスト」（文字で会話）や「デジタルヒューマンでテスト」で、会話の流れを試せます。

タグの付け方の例は[シナリオ作成のコツ](https://docs.digitalhumans.jp/itp-guide/create-trainings/best-practices.md)をご覧ください。

## 公開する

| 状態  | 見える範囲        | 編集               |
| --- | ------------ | ---------------- |
| 下書き | Author のみ    | できる              |
| 公開  | 組織の設定による（下記） | できる（新しいバージョンになる） |

受講者に使ってもらう準備ができたら、シナリオの編集画面で「公開」をオンにし、「更新」を押して保存します。

公開したシナリオが受講者に表示されるかどうかは、組織の設定によります。組織の設定により、公開されているすべてのシナリオ、または自分のチームに割り当てられたシナリオだけが、受講者に表示されます。Author と管理者は、この設定にかかわらず、ライブラリのすべてのシナリオを閲覧できます。設定の場所は[チームとシナリオの割り当て](https://docs.digitalhumans.jp/itp-guide/initial-setup/teams.md)をご覧ください。

特定のチームに受講してほしいシナリオは、チームに割り当てることができます。割り当ては、シナリオの編集画面の「チーム」（「チームを割り当て」）と、チームの画面のどちらからでも行えます。割り当てたシナリオは、チームのメンバーがライブラリで「自分に割り当て済み」フィルターを使うと表示されます。手順は[チームとシナリオの割り当て](https://docs.digitalhumans.jp/itp-guide/initial-setup/teams.md)をご覧ください。

## そのほかの設定

シナリオには、次の設定もあります。言語は「トレーニング言語を選択」の画面、そのほかは評価基準の画面で設定します。保存後は、シナリオの編集画面でも変更できます。

| 設定（画面表記）          | 内容                                                                                     |
| ----------------- | -------------------------------------------------------------------------------------- |
| 言語（「トレーニング言語を選択」） | シナリオで使う言語。複数選べます。編集画面では「参加者が使用できる言語」です                                                 |
| 「制限時間」            | セッションの制限時間。1〜120分。オフの場合は制限なし。編集画面の説明では、合格認定の必要スコアを設定している場合に使える設定とされています                |
| 「受講回数制限」          | 受講者1人がこのシナリオを開始できる回数（「最大受講回数」）。オフの場合は無制限。API で設定する場合は1〜99回です。画面で設定できる上限は、弊社にお問い合わせください |
| 「合格認定」            | 合格認定に必要なスコア（「必要スコア」）。1〜100。空欄にすると、合格認定の判定をしません                                         |

{% hint style="info" %}
日本語で練習するシナリオは、言語に日本語を含めてください。受講者は、シナリオ詳細の言語選択で日本語を選んでから開始します（既定は English）。受講の手順は[トレーニングを受講する](https://docs.digitalhumans.jp/itp-guide/take-training.md)をご覧ください。
{% endhint %}

## シナリオを管理する

### 保存したシナリオを調整する

保存したシナリオの編集画面では、次の操作ができます。

* **キャラクタープロンプト**: シナリオを決めるデジタルヒューマンへの指示文です。「AIで調整」を開き、「もっと懐疑的にする」のように依頼すると、指示文が更新されます。指示文を直接編集すると矛盾が入り込むことがあるため、「AIで調整」を使うと安全です。
* **「設定」「評価」「参加者向けの指示」**: ペルソナ・言語・タグ、評価基準、受講者に表示する説明を修正します。
* **「今すぐ試す」**: 「デジタルヒューマンで試す」で受講者と同じ音声の会話を、「テキストチャットで試す」で文字の会話を試せます。
* **公開と保存**: 「公開」を切り替え、「更新」を押して変更を保存します。

### 公開中のシナリオを編集する

公開中のシナリオを編集すると、新しいバージョンが作られます。以前のバージョンと、そのバージョンで受講したセッションのデータは残ります。API でシナリオを更新した場合など、以前のセッションのデータの扱いについて詳しくは、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。

プロンプトの編集画面では、バージョン履歴から以前のバージョンを復元できます。

### シナリオを複製する

既存のシナリオをもとに、別のパターンを作れます。

1. 複製したいシナリオを開きます。
2. 「複製」をクリックします。
3. 「トレーニングを複製」で、学習ドメインを選び、複製の名前を入力します。
4. 複製されたシナリオを必要に応じて修正します。
5. 新しいシナリオとして公開します。

複製の際に元と違う学習ドメインを選ぶと、選んだ学習ドメイン向けにシナリオが作り直されます。元のシナリオのプロンプトに加えた編集は引き継がれません。

例えば、同じ反論対応のシナリオから、ペルソナの性格だけを変えて難易度の違うシナリオを作る、といった使い方ができます。

### シナリオを削除する

シナリオを削除すると、ユーザーには表示されなくなります。受講履歴やアナリティクスなどの関連データは、レポートのために残ります（論理削除）。

## API で作成する

シナリオは API からも作成・更新・削除できます。社内のシステムにある研修内容を、そのまま登録したい場合などにお使いください。

* 文章で場面を説明して自動生成する方法と、指示文などの内容をすべて指定して作成する方法があります。
* 特定のメンバーだけが使える個人練習用のシナリオも作成できます（組織で練習モードが有効な場合）。

詳しくは[トレーニング](https://docs.digitalhumans.jp/itp-guide/api/immersive-training.md)と[参照データ](https://docs.digitalhumans.jp/itp-guide/api/reference-data.md)をご覧ください。
