> 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/qa-scenarios.md).

# Q\&Aシナリオを作成する

Q\&Aシナリオは、口頭で答える小テストです。デジタルヒューマンが質問バンクから質問を1問ずつ読み上げ、受講者は声で答えます。回答は、質問ごとに設定した「期待される回答の基準」と照らして採点されます。

商品知識の確認、新入社員研修の理解度チェック、窓口で説明すべき事項の確認など、決まった正解のある知識を声に出して答える練習に向いています。会話の練習には[ロールプレイシナリオ](https://docs.digitalhumans.jp/itp-guide/create-trainings.md)を使います。

{% hint style="info" %}
Q\&Aシナリオを作成・編集できるのは、Author（シナリオ作成者）の権限を持つユーザーと、Organization Admin（組織管理者）です。
{% endhint %}

## ロールプレイシナリオとの違い

| 項目            | ロールプレイシナリオ                  | Q\&Aシナリオ                       |
| ------------- | --------------------------- | ------------------------------ |
| セッションの進み方     | デジタルヒューマンとの会話               | 質問に1問ずつ答える                     |
| 採点の基準         | シナリオに設定した評価基準               | 質問ごとの回答の基準                     |
| ペルソナの性格・指示文   | 設定する                        | 設定しない（デジタルヒューマンは質問を読み上げる役）     |
| API の自動生成での作成 | できる                         | できない（質問を登録して作成）                |
| 画面で資料から作成     | 「シナリオコンテキスト」と「サポート資料」から「生成」 | 「ドキュメントから生成」で、資料から質問を生成できる（下記） |

Q\&Aシナリオは評価基準を使いません。質問と回答の基準が、そのまま採点に使われます。

## 質問バンクを作る

API で作成する場合、1つのQ\&Aシナリオには、質問を1〜200問登録できます。画面で登録できる問題数の上限は、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。質問ごとに次の項目を設定します。

| 項目                | 内容                                                           | 必須 |
| ----------------- | ------------------------------------------------------------ | -- |
| 「デジタルヒューマンが尋ねる質問」 | デジタルヒューマンが読み上げる質問文                                           | 必須 |
| 「期待される回答の基準」      | 正しい回答に含まれているべき内容                                             | 必須 |
| 「配点」              | その質問の点数。「スコアリング」で「カスタム重み」を選んだときに設定します（下記）                    | 任意 |
| 並び順               | 質問バンクの中での並び順。質問バンクで質問をドラッグして並べ替えます                           | 任意 |
| 「参考リンク（任意）」       | 質問に添える参考資料のリンク。「リンクのテキスト」と「リンクのURL」を両方入力します。リンクのテキストは100文字まで | 任意 |
| 「回答の制限時間」         | この質問に答えられる秒数（下記）                                             | 任意 |

画面では、「ドキュメントから生成」（「ドキュメントから質問を生成」）で、アップロードした資料から質問を生成することもできます。資料の内容をもとに、質問と期待される回答の基準が作られ、均等な重み付けで質問バンクに追加されます。アップロードできるファイルの数とサイズには上限があります。保存する前に、生成された質問と回答の基準を確認し、必要に応じて修正してください。

{% hint style="success" %}
**回答の基準の書き方（例）**\
質問: 「当社の標準保守プランで、障害の受付時間を答えてください」\
回答の基準: 「平日9時〜18時と答えている」\
基準には、採点で確認したい要素を具体的に書きます。複数の要素が必要な場合は、すべて列挙します。
{% endhint %}

## 採点のしかたを設定する

「スコアリング」で、質問ごとの重みの付け方を選びます。

| 設定（画面表記） | 内容                                                                            |
| -------- | ----------------------------------------------------------------------------- |
| 「均等な重み」  | すべての質問を同じ重さで扱います。総合スコアは、各質問のスコアの単純平均です                                        |
| 「カスタム重み」 | 質問ごとに「配点」を設定します。配点は1ポイント以上です。セッションのスコアは、出題された質問で獲得したポイントを、その質問の配点の合計で割って計算します |

API では質問の重みを `weight`（`0`〜`100` の相対的な寄与度）で指定するため、1ポイント以上の「配点」で指定する画面とは表し方が異なります。

## 出題のしかたを設定する

| 設定            | 内容                                         |
| ------------- | ------------------------------------------ |
| 「質問の順序」       | 「順番通り」（`SEQUENTIAL`、既定）または「ランダム」（`RANDOM`） |
| 「セッションごとの質問数」 | 質問バンクから出題する数。指定しない場合はすべての質問を出題します          |

質問バンクを多めに作り、ランダムに一部だけ出題すると、受講のたびに違う組み合わせで練習できます。

## 回答の制限時間

質問ごとに、回答の制限時間を設定できます。

1. 質問バンクで質問を開きます。
2. 「回答の制限時間」をオンにします。
3. 回答できる秒数を設定します。10秒〜2時間（7,200秒）の範囲で設定できます。

セッション中、受講者には現在の質問のカウントダウンが表示されます。

* カウントダウンは、デジタルヒューマンが質問を読み終えた時点で始まります。
* 終了の10秒前に警告が表示されます。
* 時間切れになると、それまでに話した回答が送信されて採点され、次の質問に進みます。
* 何も話さなかった質問は0点になります。

制限時間は質問ごとに設定するため、制限時間のある質問とない質問を混ぜられます。質問ごとの制限時間は、シナリオ全体のセッションの制限時間とあわせて適用されます。

## クリアボタン（答え直し）

初期設定では、受講者は回答を送信する前に、話した回答をクリアして答え直せます。最初に話した回答をそのまま確定させたい場合は、次のように設定します。

1. 「構成」をクリックします。
2. 「クリアボタン」で「許可しない」を選びます。

「許可しない」にすると、受講者の画面の「クリア」ボタンが表示されなくなり、受講者は最初に声で答えた内容を確定して進みます。「許可」を選ぶと、再び表示されます。

本番の試験に近い形で練習させたい場合は「許可しない」、まずは落ち着いて答える練習をさせたい場合は「許可」が向いています。

## 受講回数の上限との関係

Q\&Aシナリオに受講回数の上限を設定している場合、次のどちらかを満たしたセッションで、受講回数が1回分使われます。

* すべての質問に回答した、または時間切れになった
* 5問以上に回答した、または時間切れになった

## そのほかの設定

言語、セッションの制限時間、受講回数の上限、合格認定のしきい値、学習ドメイン、タグ、公開・下書きの扱いは、ロールプレイシナリオと同じです。[ロールプレイシナリオを作成する](https://docs.digitalhumans.jp/itp-guide/create-trainings.md)をご覧ください。

## API で作成する

Q\&Aシナリオは API からも作成・更新できます。API では、シナリオの種別は `TECHNICAL_ACUMEN` として扱われます。更新で質問を送ると、質問バンク全体が置き換わります（質問ごとの制限時間も、送らなければ解除されます）。

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