> 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/about/glossary.md).

# 用語集

イマーシブトレーニングプラットフォームの画面と本ドキュメントで使う用語を、分野ごとにまとめています。「英語表記・API の値」の列には、画面の英語表記と、API で使われるフィールド名や値を記載しています。API の値は訳さずにそのまま使います。

「本ドキュメントの表記」の列で「（画面表記）」と付けた用語は、画面の日本語表記と同じです。「（画面表記）」と付けていない用語は、本ドキュメントでの呼び方です。画面では別の表記が使われていることがあります。主な違いは次のとおりです。

* 製品の名前: 本ドキュメントでは「イマーシブトレーニング」と書きます。画面のメニューなどでは「没入型トレーニング」と表示されます。
* ロール: 画面では英語の権限名（Organization Admin など）で表示されます。本ドキュメントでは、権限名に日本語の説明を補っています。
* 学習ドメイン: シナリオの編集画面では「学習ドメイン」、組織設定のタブでは「ラーニングドメイン」と表示されます。
* 評価: 画面では主に「評価」と表示されます。組織設定のタブだけは「デフォルトアセスメント」です。
* Q\&Aシナリオ: シナリオの種類を選ぶ画面では「Q\&Aシナリオ」、シナリオ詳細では「Q\&A」と表示されます。

## 製品と全般

| 本ドキュメントの表記          | 英語表記・API の値                          | 説明                                                                                                                                                      |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| イマーシブトレーニングプラットフォーム | Immersive Training Platform          | デジタルヒューマンを相手に、会話を声に出して練習するトレーニングサービス。本ドキュメントでは「本製品」とも書きます                                                                                               |
| イマーシブトレーニング         | Immersive Training                   | 本製品で受講するトレーニング（シナリオ）。画面のメニューでは「没入型トレーニング」と表示されます。API では `immersive-training`                                                                            |
| AIロールプレイ            | AI roleplay                          | AIが演じる相手と会話して練習すること                                                                                                                                     |
| デジタルヒューマン           | digital human                        | 受講者の会話の相手になる、AIで動くキャラクター。API では `persona-config` で一覧を取得します（下の「デジタルヒューマン（API）」を参照）                                                                       |
| 組織                  | Organization                         | 本製品を利用する単位。ユーザー・チーム・シナリオ・設定は組織ごとに管理されます                                                                                                                 |
| 組織ID（画面表記）          | `organizationID` / `organization_id` | 組織の識別子。`org_abc123` のような形式で、UUID ではありません。API の接続先 URL に含めます                                                                                             |
| 人材開発                | Learning and Development / L\&D      | 社員の育成を担う部門・担当者                                                                                                                                          |
| フリートライアル            | Free trial                           | 導入前の試用。規約は[イマーシブトレーニングプラットフォーム フリートライアル利用規約](https://docs.digitalhumans.jp/legal/documents/uneeq/uneeq-free-trial-terms.md)をご覧ください。試用については弊社にお問い合わせください |

## ロール（権限）

本製品では、組織でのロールと、チームの中での役割の2種類があります。名前が似ているため、ご注意ください。

組織でのロールは、画面では英語の権限名（Organization Admin など）で表示されます。かっこ内の日本語は、本ドキュメントで補った説明です。

### 組織でのロール

1人に複数のロールを割り当てられます。API では `roles` に値の配列で指定します。

| 本ドキュメントの表記                | 英語表記・API の値                      | 説明                                                                       |
| ------------------------- | -------------------------------- | ------------------------------------------------------------------------ |
| Organization Admin（組織管理者） | Organization Admin / `ORG_ADMIN` | 組織全体を管理する。ユーザー・チーム・設定・ブランディング・APIキー・シナリオをすべて管理でき、組織全体の受講履歴とアナリティクスを閲覧できる |
| Team Admin（チーム管理者）        | Team Admin / `TEAM_ADMIN`        | 担当するチームとそのメンバーを管理する。担当チーム内の受講履歴とアナリティクスを閲覧できる                            |
| Author（シナリオ作成者）           | Author / `AUTHOR`                | シナリオと評価基準を作成・編集する                                                        |
| Manager（マネージャー）           | Manager / `MANAGER`              | 自分と、担当するメンバーの受講履歴とアナリティクスを閲覧する                                           |
| User（受講者）                 | User / `USER`                    | トレーニングを受講し、自分の結果を閲覧する。SSO で初めてサインインしたユーザーには、このロールが割り当てられる                |
| ロール（画面表記）                 | Role                             | ユーザーに割り当てる権限の種類                                                          |

### チームの中での役割

| 本ドキュメントの表記      | 英語表記・API の値                          | 説明                                                                                |
| --------------- | ------------------------------------ | --------------------------------------------------------------------------------- |
| チームマネージャー（画面表記） | team manager / `team_role: manager`  | チームの中での役割の1つ。チームのメンバーのアナリティクスを閲覧するなどの追加の権限を持つ。組織でのロールの Manager（`MANAGER`）とは別の設定です |
| 通常のメンバー（画面表記）   | regular member / `team_role: member` | チームの中での既定の役割                                                                      |

{% hint style="warning" %}
API でロールを指定するとき、`roles` に渡した値は追加ではなく**置き換え**になります。\
既存のロールを残したい場合は、既存のロールも含めてすべて指定してください（例: `["USER", "MANAGER"]`）。
{% endhint %}

## ユーザーとチーム

| 本ドキュメントの表記   | 英語表記・API の値                                   | 説明                                                                                                                                 |
| ------------ | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| 受講者          | learner / participant / trainee               | トレーニングを受講する人。User のロールを持つユーザー                                                                                                      |
| ユーザーの状態（画面）  | Invited / Active / Inactive                   | 画面での状態。画面表記は「招待済み」（招待済みで未承諾）、「有効」（承諾してサインイン済み）、「無効」（利用停止）                                                                          |
| ユーザーの状態（API） | `active` / `inactive` / `invited` / `expired` | API での状態。`invited` は招待中、`expired` は招待の有効期限切れ。API から設定できるのは `active` と `inactive` だけです                                              |
| 無効化（画面表記）    | Deactivate / `inactive`                       | ユーザーを利用停止にすること。サインインできなくなりますが、受講データは保持されます                                                                                         |
| 招待（画面表記）     | invitation                                    | メールアドレス宛てに招待を送り、ユーザーを組織に追加すること。招待メールはサインイン基盤（Auth0）から送信されます                                                                        |
| 招待メールを送らない登録 | `silent_add`                                  | API でユーザーを追加するとき、招待メールを送らずに登録だけを行う指定                                                                                               |
| チーム（画面表記）    | Team                                          | ユーザーをまとめる単位。チーム名は組織内で重複できません                                                                                                       |
| 割り当てたシナリオ    | Assigned Scenarios / `assigned_scenario_ids`  | チームが受講するシナリオ。チームの画面では「割り当てられたシナリオ」と表示されます。シナリオを直接指定して割り当て、チームの画面とシナリオの編集画面のどちらからでも割り当てられます。チームのメンバーは、ライブラリの「自分に割り当て済み」フィルターで表示できます |
| 表示言語         | `locale`                                      | ユーザーごとの言語設定。API では `ja-JP` のような形式で指定します                                                                                            |
| 画面テーマ        | `user_theme`                                  | 画面の配色。`light` / `dark` / `system`                                                                                                  |

## シナリオ（トレーニング）

| 本ドキュメントの表記       | 英語表記・API の値                                                 | 説明                                                                                                                                                                                                                                                |
| ---------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| シナリオ             | scenario / training                                         | 受講者が練習する会話の設定一式                                                                                                                                                                                                                                   |
| シナリオの種類          | `scenario_type`                                             | シナリオの進み方の種類。今後、値が追加されることがあります                                                                                                                                                                                                                     |
| ロールプレイシナリオ（画面表記） | Role Play / `ROLE_PLAY`                                     | デジタルヒューマンと会話するシナリオ。公開すると組織の受講者が受講できます（表示される範囲は組織の設定による）                                                                                                                                                                                           |
| Q\&Aシナリオ（画面表記）   | Q\&A / `TECHNICAL_ACUMEN`                                   | デジタルヒューマンが問題を読み上げ、受講者が声で答えるシナリオ。回答ごとに採点されます。シナリオの種類を選ぶ画面では「Q\&Aシナリオ」、シナリオ詳細では「Q\&A」と表示されます。API では Technical Acumen とも呼ばれます                                                                                                                        |
| 練習シナリオ（画面表記）     | Practice scenario / `PRACTICE`                              | 作成した本人だけが受講できる、非公開のロールプレイ。本ドキュメントでは「個人練習用のシナリオ」とも書きます。画面では、トレーニングの一覧の「練習シナリオを作成」から作ります。API で作成する場合は `user_email` を指定し、組織で練習モード（practice mode）が有効になっている必要があります。練習のスコアはレポートに含まれません。チームには割り当てられません                                                   |
| 学習ドメイン（画面表記）     | Learning Domain / `learning_domain_id`                      | シナリオを分類する研修の領域（例: 初回ヒアリング、反論対応）。既定の評価基準を学習ドメインごとに設定できます。シナリオの編集画面では「学習ドメイン」、組織設定のタブでは「ラーニングドメイン」と表示されます。以前は「ユースケース（Use Case）」と呼ばれていました                                                                                                            |
| タグ（画面表記）         | Tag / `tags`                                                | シナリオの分類・絞り込み用のラベル。スキル・事業部・難易度・対象者などで付けます。組織設定の「タグ」タブで管理します。チームへのシナリオの割り当てには使いません                                                                                                                                                                  |
| 目的               | Objective / `objective`                                     | 受講者がこのセッションで達成すること。ロールプレイシナリオの編集画面では「トレーニング目標」                                                                                                                                                                                                    |
| 状況設定             | Context / `context`                                         | シナリオの背景と場面の設定。画面表記は「シナリオコンテキスト」                                                                                                                                                                                                                   |
| 受講者への説明          | Participant Instructions / `participant_instructions`       | 受講者が開始前に読む説明。画面表記は「参加者向けの指示」                                                                                                                                                                                                                      |
| ペルソナ             | Persona                                                     | デジタルヒューマンが演じる人物像。名前（Name）、役職（Role）、性格（Personality）、所在地（Location）、相手の種類（Type。お客様・見込み客・同僚など）で設定します。API では `personality_name`、`personality_role`、`personality`、`personality_location`、`personality_type`                                             |
| ペルソナのテンプレート      | Persona Config                                              | シナリオ作成画面で選ぶ、用意済みのペルソナのひな形（シナリオの種類、認知度、関わり方）                                                                                                                                                                                                       |
| 認知度              | awareness level                                             | ペルソナが自社の商品・サービスをどの程度知っているか                                                                                                                                                                                                                        |
| デジタルヒューマン（API）   | `persona-config` / `persona_config_id`                      | API で取得・指定するデジタルヒューマン（アバター）。画面の「Persona Config」（ペルソナのテンプレート）とは指すものが異なります                                                                                                                                                                          |
| AI Buddy         | AI Buddy / `AI_BUDDY`                                       | トレーニングのセッションの後に、受講者のコーチング役として会話するデジタルヒューマン。使用するデジタルヒューマンとコーチングプロンプトは、組織設定の「AI Buddy」タブ（「AI Buddy設定」）で設定し、組織の既定のプロンプトを置き換えられます。API では、デジタルヒューマンの用途の区分の1つで、`AI_BUDDY` のデジタルヒューマンは AI Buddy の会話専用です。`is_default_ai_buddy` は組織の既定の AI Buddy かどうかを示します |
| 資料               | Documents                                                   | シナリオにアップロードする参考資料（PDF、DOCX、PPTX、TXT）。内容が要約され、デジタルヒューマンの応答に使われます                                                                                                                                                                                   |
| システムプロンプト        | `system_prompt`                                             | デジタルヒューマンの振る舞いを指示する文章。API でロールプレイを作成するとき、指定した内容がそのまま使われます                                                                                                                                                                                         |
| 生成されたプロンプト       | `generated_prompt` / `prompt_summary`                       | シナリオの設定から作られ、セッションで使われるプロンプトと、その要約                                                                                                                                                                                                                |
| AIによる自動生成        | Generate / `POST /immersive-training/generate`              | 場面の説明文から、ペルソナ・プロンプト・受講者への説明・評価基準をまとめて生成する機能。シナリオ作成画面のボタンは「生成」です。生成される文章は初回は英語です。画面の「AIで調整」で日本語に直せます                                                                                                                                               |
| 下書き              | Draft / `is_published: false`                               | 作成中のシナリオ。Author だけが見られます。Q\&Aシナリオでは画面に「下書き」と表示されます                                                                                                                                                                                                |
| 公開               | Published / `is_published: true`                            | 受講できる状態のシナリオ。組織の設定により、すべての受講者、または割り当てられたチームの受講者に表示されます（組織設定の「詳細設定」タブの「シナリオの表示範囲」）。画面では「公開」をオンにして公開し、Q\&Aシナリオでは「公開済み」と表示されます                                                                                                                       |
| バージョン            | `version` / `training_scenario_id`                          | 公開済みのシナリオを編集すると、新しいバージョンが作られます。以前のバージョンと受講データは残ります                                                                                                                                                                                                |
| 複製（画面表記）         | Duplicate                                                   | 既存のシナリオをコピーして、別のシナリオを作ること                                                                                                                                                                                                                         |
| 削除               | Delete                                                      | シナリオを非表示にすること（論理削除）。受講履歴とアナリティクスのデータは残ります                                                                                                                                                                                                         |
| 制限時間             | `time_limit_minutes`                                        | 1回のセッションの制限時間（1〜120分）                                                                                                                                                                                                                             |
| 受講回数の上限          | attempt limit / `max_attempts`                              | 1つのシナリオを受講できる回数の上限（1〜99回）。Q\&Aシナリオでは、すべての問題に回答した（または時間切れになった）とき、または5問以上に回答したときに1回と数えます                                                                                                                                                            |
| 合格認定（画面表記）       | Endorsement / `endorsement_level` / `endorsement_threshold` | 受講者がシナリオで一定のスコアに達したことを認めるしくみ。`endorsement_threshold` は合格認定に必要なスコア（%）、`endorsement_level` は `NONE`（合格認定なし）または `STANDARD`（合格認定あり）                                                                                                                   |

### Q\&Aシナリオの用語

| 本ドキュメントの表記        | 英語表記・API の値                                           | 説明                                                                                          |
| ----------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| 質問バンク（画面表記）       | Question bank / `questions`                           | Q\&Aシナリオで出題する質問の一覧（1〜200問）                                                                  |
| 期待される回答の基準（画面表記）  | Expected-answer criteria / `answer_criteria`          | 正しい回答に含めるべき内容。回答はこの基準に沿って採点されます。本ドキュメントでは「回答の基準」とも書きます                                      |
| 質問の順序（画面表記）       | Question order / `question_ordering`                  | `SEQUENTIAL`（画面表記「順番通り」）または `RANDOM`（画面表記「ランダム」）                                            |
| セッションごとの質問数（画面表記） | Questions asked per session / `questions_per_session` | 1回のセッションで出題する質問の数。指定しない場合はすべて出題します                                                          |
| 回答の制限時間（画面表記）     | Answer time limit / `time_limit_seconds`              | 問題ごとの回答の制限時間（10秒〜2時間）。時間切れになると、それまでの回答が提出されて採点されます。何も答えなかった問題は0点です                          |
| 「クリア」ボタン（画面表記）    | Clear button / `answer_clear_mode`                    | 受講者が話した回答を消して、答え直すためのボタン。Q\&Aシナリオの「構成」の「クリアボタン」で「許可しない」（`DISALLOWED`）を選ぶと非表示になり、最初の回答が確定します |

## 評価とフィードバック

| 本ドキュメントの表記       | 英語表記・API の値                                         | 説明                                                                                                                                                                                                                                 |
| ---------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 評価（画面表記）         | Assessment / `assessments`                          | セッションを採点する観点                                                                                                                                                                                                                       |
| 評価基準（画面表記）       | assessment criteria / `criteria`                    | 各評価で、よい対応とはどのようなものかを書いた基準                                                                                                                                                                                                          |
| カスタム評価（画面表記）     | custom assessment                                   | 組織が独自に作成する評価                                                                                                                                                                                                                       |
| デフォルトのコーチング評価    | default coaching assessment / `default-assessments` | シナリオ作成時に自動で候補に出る、組織の既定の評価。学習ドメインごとに設定できます。組織設定のタブでは「デフォルトアセスメント」、シナリオ作成時の一覧では「デフォルトの評価」と表示されます                                                                                                                                     |
| 評価のライブラリ         | assessment library                                  | 組織で共有する評価の一覧。API で生成・作成した評価もここに追加されます                                                                                                                                                                                              |
| 重み               | `weight`                                            | 評価や問題がスコアに占める比重（0〜100）。画面では「重み」「ウェイト」と表示されます。Q\&Aシナリオの画面では、質問ごとの「配点」が使われます                                                                                                                                                         |
| スコア（画面表記）        | Score / `score_percentage`                          | セッション全体の点数（0〜100）                                                                                                                                                                                                                  |
| コーチングフィードバック     | Coaching feedback                                   | 評価ごとのスコア、よかった点、改善点、次回に向けた具体的な提案。AIが作成します                                                                                                                                                                                           |
| スコアの上書き          | manual score override / `manually_overridden`       | 組織で有効な場合に、管理者が AI によるスコアを上書きできる機能。上書きした人・理由・日時が記録されます                                                                                                                                                                              |
| セッション整合性評価（画面表記） | Session Integrity Assessment / `integrity_level`    | 合格認定のある Q\&Aシナリオで、セッション中の動き（コピーの試み、ウィンドウからのフォーカスの移動、回答の遅れ）から付けられる3段階の表示（`GREEN` / `ORANGE` / `RED`）。画面では「整合性の懸念なし」「整合性の懸念の可能性あり」「整合性に重大な懸念あり」と表示されます。一覧では「整合性フラグあり」と表示されることがあります。受講者には表示されません。不正があったと断定するものではありません。回答とあわせて確認してください |

## 受講とセッション

| 本ドキュメントの表記    | 英語表記・API の値                                                                                        | 説明                                                                                                                                 |
| ------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| セッション         | session                                                                                            | 受講者がシナリオを1回受講すること                                                                                                                  |
| 受講履歴          | My Activity                                                                                        | 過去のセッションの一覧。画面表記は「マイアクティビティ」。スコア、コーチングフィードバック、会話の指標、書き起こしを確認できます                                                                   |
| 書き起こし         | Transcript / `transcript`                                                                          | 受講者とデジタルヒューマンの会話の全文。発言者と、会話開始からの経過時間が付きます。画面表記は「文字起こし」                                                                             |
| セッションの状態（画面）  | Completed / Incomplete / Error                                                                     | 受講履歴での状態。画面表記は「完了」「未完了」「エラー」                                                                                                       |
| セッションの状態（API） | `started` / `generating` / `analyzing` / `completed` / `invalid` / `abandoned` / `fatal` / `error` | API で出力するときの状態。`analyzing` は採点のための分析中、`abandoned` は受講者が途中でやめたセッション                                                                 |
| シナリオの言語       | `locales`                                                                                          | シナリオで使える言語。API ではコロン区切りで指定します（例: `en-US:ja-JP`）。日本語は `ja-JP` で、`ja` だけではエラーになります。指定しない場合は英語です。受講者はシナリオ詳細の言語選択で言語を選びます（既定は English） |

## 会話の指標

| 本ドキュメントの表記    | 英語表記・API の値                                  | 説明                                                                                                                                    |
| ------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 会話の指標         | Conversation Metrics / `conversation_skills` | 会話の様子を数値で示す指標。ロールプレイのセッションで記録されます                                                                                                     |
| 話す・聞く比率（画面表記） | Talk/Listen Ratio / API の `Listen Ratio`     | 会話の中での、受講者が話す時間と聞く時間のバランス。API の `Listen Ratio` の計算方法は、[データのエクスポート](https://docs.digitalhumans.jp/itp-guide/api/data-export.md)をご覧ください |
| 最長の独話         | Longest Monologue（画面表記は「最長モノローグ」）            | 受講者が途切れずに話し続けた最も長い時間                                                                                                                  |
| 話速            | Talk Speed（画面表記は「話す速さ」）                      | 話す速さ。英語の会話を前提にした指標で、日本語の会話では正しく計測されない場合があります。評価には使わないでください                                                                            |
| つなぎ言葉         | Filler Words（画面表記は「フィラーワード」）                 | 意味を持たないつなぎの言葉の頻度。英語の会話を前提にした指標で、日本語の会話では正しく計測されない場合があります。評価には使わないでください                                                                |
| 拡張分析（画面表記）    | Enhanced Analysis / `enhanced_analysis`      | カメラ映像を使う分析。カメラを使わずに受講することもできます                                                                                                        |

## アナリティクスとデータ

| 本ドキュメントの表記   | 英語表記・API の値                     | 説明                                                                 |
| ------------ | ------------------------------- | ------------------------------------------------------------------ |
| アナリティクス      | Analytics                       | 受講状況と成績を、個人・チーム・組織の単位で確認する画面。メニューでは「分析」と表示されます。見られる範囲はロールによって異なります |
| コーチングの分析     | Coaching Analytics              | 評価ごと・シナリオごと・ユーザーごとのスコアと推移。画面表記は「コーチング分析」                           |
| Q\&A分析（画面表記） | Q\&A Analytics                  | Q\&Aシナリオの結果の分析                                                     |
| データのエクスポート   | Data Export / `export/sessions` | API で受講データを出力する機能。概要（summary）と詳細（details）の2種類があります                 |
| xAPI         | xAPI                            | 学習記録の標準形式（Experience API）。セッションの概要を xAPI の形式で出力できます（詳細は JSON のみ）   |

## 管理と連携

| 本ドキュメントの表記     | 英語表記・API の値           | 説明                                                                                                         |
| -------------- | --------------------- | ---------------------------------------------------------------------------------------------------------- |
| ブランディング（画面表記）  | Branding              | 組織名・ロゴ・ファビコン・ブランドカラー（プライマリカラー、ダークモード用のロゴとカラー）の設定                                                           |
| シングルサインオン（SSO） | SSO                   | 社内の認証基盤のアカウントでサインインするしくみ。設定は弊社への依頼が必要です                                                                    |
| IdP            | Identity Provider     | 社内の認証基盤。本製品は SAML 2.0、Microsoft Entra ID（旧 Azure AD）、Google Workspace、Microsoft アカウントの方式に対応しています           |
| APIキー（画面表記）    | API key               | API を使うための鍵。組織ごとに発行し、`Authorization: Bearer` ヘッダーで送ります。有効期限はなく、削除するまで有効です                                  |
| レート制限          | Rate limit            | APIキーごとのリクエスト数の制限。超えると `429` が返ります。引き上げは弊社にご相談ください                                                         |
| OpenAPI 仕様     | OpenAPI specification | API の仕様を機械で読める形式でまとめたファイル。[OpenAPI 仕様](https://docs.digitalhumans.jp/itp-guide/api/openapi.md)からダウンロードできます |

## 関連ページ

* [イマーシブトレーニングプラットフォームとは](https://docs.digitalhumans.jp/itp-guide/about.md)
* [ユーザーとロール](https://docs.digitalhumans.jp/itp-guide/initial-setup/users-and-roles.md)
* [ロールプレイシナリオを作成する](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)
* [受講履歴と結果の見方](https://docs.digitalhumans.jp/itp-guide/take-training/history.md)
* [アナリティクス](https://docs.digitalhumans.jp/itp-guide/analytics.md)
* [API の概要](https://docs.digitalhumans.jp/itp-guide/api.md)
