トラブルシューティング

TutoriaLLM アプリ本体や、開発時におけるトラブルシューティングや既知の問題に関する情報を提供します。

アプリ本体における問題

TutoriaLLM アプリ本体における問題について説明します。

動作の遅さの問題

TutoriaLLMは、ブラウザ上で動作するアプリケーションのため、一部の環境では動作が遅くなることがあります。特に、古い端末や古いブラウザでは動作が遅くなることがあります。その場合は、最新のブラウザを使用するか、端末を更新することをお勧めします。これらの問題を解決するため、TutoriaLLMではPWAの提供も行っています。対応ブラウザを使用することで、アプリの動作を高速化することができます。 PWAのインストールは、初期画面下部の「このアプリについて」から行うことができます。詳しくは、アプリの管理者にお問い合わせください。

ネットワークが不安定な場合の問題

ネットワークが不安定な端末で、アプリが正常に動作しなくなることが報告されています。その場合は、ネットワーク環境を安定させるか、別の端末でアプリを利用することをお勧めします。また、音声モードを利用する際などは、一度に数MB程度のデータ通信が発生するため、通信環境に注意してください。従量課金制の通信環境では、通信料金が高額になる可能性があります。

Minecraftとの接続ができない場合

Minecraft Education または Minecraft Bedrock Edition と連携を行う場合に発生する問題が発生した場合は、接続を行う際に暗号化がオフになっていることを確認してください。TutoriaLLMではMinecraftに対する暗号化のサポートを行っていないため、Minecraftの設定内にある「暗号化された通信を要求する」をオフにしてください。

また、TutoriaLLMは、Minecraftとの連携を行うことができますが、正しい設定にも関わらず、接続できない現象が報告されています。その場合は、AIチャットのスペースに提示された方法（接続方法）を確認し、もう一度設定を行ってください。複数回試しても接続ができない場合は、アプリの管理者に問い合わせてください。

開発時における問題

開発時におけるトラブルシューティングや既知の問題について説明します。

SSLに関する問題

TutoriaLLMを外部に公開する際は、SSLを利用することを推奨していますが、以下の点に注意してください。

SSL証明書の有効期限が切れている場合、アプリが正常に動作しないことがあります。SSL証明書の有効期限が切れている場合は、証明書を更新してください。
クライアントサイドでSSLが無効な場合、アプリの音声入力などの機能が利用できなくなります。
全ての接続でSSLを強制した場合、Minecraftとの接続ができなくなることがあります。Minecraftとの接続を行う場合は、SSLを無効にする必要があるため、設定を変更してください。
DNSなどを使ってドメインなどの割り当てを行う際に、Cloudflareなどのプロキシを利用している場合、Minecraftとの接続ができなくなることがあります。その場合は、プロキシを無効にしてください。

利用するイメージのバージョンに関する問題

TutoriaLLMは、Dockerイメージを利用してアプリを起動するため、イメージのバージョンによって動作が異なることがあります。そのため、アプリの動作がおかしい場合は、利用しているイメージのバージョンを確認してください。バージョンタグにpreviewが含まれている場合は、開発中のバージョンであるため、不安定な動作が発生する可能性があります。その場合は、安定版のバージョンを利用することをお勧めします。そのためlatestタグがついているイメージを利用することをお勧めします。 latestタグがついているイメージでバグを発見した際には、お手数ですが貢献ページを参照し、報告を行ってください。