> 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/network-requirements/troubleshooting.md).

# トラブルシューティング

イマーシブトレーニングプラットフォームでよくある問題と、その対処をまとめました。該当する症状から確認してください。解決しない場合は、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。

## 受講中の問題

### デジタルヒューマンに声が届かない

受講者が話しても、デジタルヒューマンが反応しない場合の確認手順です。

1. **マイクを確認します。** ブラウザでマイクの使用が許可されているか、使いたいマイクが選ばれているか、話すとマイクの入力レベルが動くかを確認してください。確認方法は[デジタルヒューマンが私の声を聞いていない様です](https://docs.digitalhumans.jp/users/troubleshooting/digitalhuman-not-hearing-voice.md)をご覧ください。
2. **音声認識への接続を確認します。** マイクに問題がない場合、原因の多くはネットワークです。本製品は音声認識にDeepgramを使っており、社内のファイアウォールがWebSocketの通信を止めていると、声が届きません。UneeQが提供する診断ツール「[STT接続テストツール](https://presales.services.uneeq.io/teststt)」で接続を確認してください。
3. **テストが失敗した場合は、** [ネットワーク要件と接続テスト](https://docs.digitalhumans.jp/itp-guide/network-requirements.md)のページを社内のネットワーク管理者にご共有ください。

{% hint style="info" %}
同じ端末でも、社内ネットワークから外したとき（モバイル回線へのテザリングなど）はつながり、社内ネットワークではつながらない場合は、社内ネットワーク側で通信が遮断されています。
{% endhint %}

### デジタルヒューマンが英語で話す

シナリオの言語は、既定でEnglishになっています。日本語で受講する場合は、受講者がシナリオの詳細画面の「言語」で日本語を選んでください。

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

### 映像や音声の品質が悪い・遅れる

| 確認すること       | 内容                                                  |
| ------------ | --------------------------------------------------- |
| UDPが使えているか   | UDPが止められているとTCPで接続し、品質が下がります。通信がTCPになっていないか確認してください |
| VPNを経由していないか | VPNは遅延を増やし、品質を下げます。一度VPNを切って試してください                 |
| パケットの欠落      | 欠落の多いネットワークでは品質が下がります                               |
| 帯域           | 1080pで5 Mbps、720pで2.5 Mbpsが最低限必要です                  |

詳しくは[ネットワーク要件と接続テスト](https://docs.digitalhumans.jp/itp-guide/network-requirements.md)をご覧ください。

### つながらない

次の順に確認してください。

1. ファイアウォールで、必要な宛先とポートがすべて許可されているか
2. UDPの通信が通るか
3. VPNを切ると接続できるか
4. TLS 1.2以上が使えるか

宛先とポートの一覧は[ネットワーク要件と接続テスト](https://docs.digitalhumans.jp/itp-guide/network-requirements.md)にあります。

## シナリオの作成・公開の問題

| 症状                   | 対処                                                                                                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| デジタルヒューマンの応答が話題からそれる | シナリオの「シナリオコンテキスト」（背景情報）と、ペルソナの「パーソナリティ」（性格）の設定を見直してください                                                                                                               |
| 資料が処理されない            | ファイル形式がPDF、DOCX、PPTX、TXTのいずれかか、ファイルサイズが上限を超えていないかを確認してください。ファイルサイズの上限は、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)                                      |
| 評価の点数が安定しない          | 評価基準の内容が明確で具体的かを見直してください                                                                                                                                              |
| 受講者にシナリオが表示されない      | シナリオが「公開」になっているか（下書きのままでないか）を確認してください。組織設定の「詳細設定」タブの「シナリオの表示範囲」が「割り当てのみ」の場合は、受講者のチームにシナリオが割り当てられているかも確認してください。チームに割り当てたシナリオは、受講者がトレーニングの一覧で「自分に割り当て済み」フィルターを使うと表示されます |

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

## サインイン（SSO）の問題

| 症状                        | 対処                                              |
| ------------------------- | ----------------------------------------------- |
| サインイン画面にSSOが表示されない        | 組織でSSOの接続が有効になっているかを確認してください                    |
| 別のIdPに転送される               | サインインURLに含まれる組織の識別名（エイリアス）を確認してください             |
| 氏名やメールアドレスが取り込まれない        | IdP側のSAMLの属性の対応付け（マッピング）を確認してください               |
| サインインが繰り返される（ループする）       | ACS URLとEntity IDが、IdP側の設定と一致しているかを確認してください     |
| メールアドレスを変更したらサインインできなくなった | 本製品に登録したメールアドレスと、IdPが送るメールアドレスが一致しているかを確認してください |

SSOの設定や変更は、弊社と連携して行います。詳しくは[シングルサインオン（SSO）](https://docs.digitalhumans.jp/itp-guide/initial-setup/sso.md)をご覧ください。

## APIの問題

| 症状        | 対処                                                                                                                                                            |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `401` が返る | `Authorization` ヘッダーにAPIキーが付いているか、キーが削除されていないか、URLの組織IDがキーの組織と一致しているかを確認してください。詳しくは[認証](https://docs.digitalhumans.jp/itp-guide/api/authentication.md)をご覧ください |
| `429` が返る | レート制限を超えています。`Retry-After` ヘッダーの秒数だけ待ってから再実行してください。詳しくは[レート制限](https://docs.digitalhumans.jp/itp-guide/api/rate-limits.md)をご覧ください                             |

## 関連ページ

* [ネットワーク要件と接続テスト](https://docs.digitalhumans.jp/itp-guide/network-requirements.md)
* [よくある質問](https://docs.digitalhumans.jp/itp-guide/network-requirements/faq.md)
* [デジタルヒューマン全般のトラブルシューティング](https://docs.digitalhumans.jp/users/troubleshooting.md)
