AI講評は、採点結果をもとにAIが自動的に生成する生徒個人向けのコメントです。個票（成績レポート）に含まれます。
AI講評は、全クラスの5教科すべての採点が完了し、個票作成が実行された後にGenerateAiCommentsJobとして自動生成されます。
AI講評の生成は、ManaQueueという専用のNode.jsベースのキューシステムで処理されます。これはLaravelの標準キュー（queue-worker）とは別のシステムで、manaqueue-serverとmanaqueue-workerの2つのコンテナで構成されています。
ManaQueueはAI講評の生成に特化しており、大量の生徒コメントを効率的に処理できるよう設計されています。
AI講評の生成には処理時間が必要です。生徒数やサーバーの負荷状況によって、完了までに時間がかかることがあります。
生成の進捗状況は画面上で確認できます（進捗ポーリング機能）。ステータスが「処理中」の場合は正常に処理が進行していますので、完了までお待ちください。
AI講評は5教科すべての採点が完了していないと生成されません。採点管理画面で各教科のステータスを確認してください。
採点完了後に個票作成の操作を実行する必要があります。個票作成が実行されていない場合、AI講評の生成も開始されません。
AI講評の生成はManaQueue（Node.js）で処理されています。ManaQueueのコンテナ（manaqueue-server、manaqueue-worker）が停止している場合、AI講評は生成されません。この場合は管理者にお問い合わせください。
個票生成にエラーが発生した場合は、管理者にお問い合わせください。
| 状況 | 対処 |
|---|---|
| ステータスが「処理中」 | 正常です。完了までお待ちください |
| 5教科の採点が未完了 | 未完了の教科の採点を完了させてください |
| 個票作成が未実行 | 採点管理画面から個票作成を実行してください（オペレーター向け） |
| エラーが発生している | 管理者にお問い合わせください |
| 長時間経っても完了しない | ManaQueueの状態を確認する必要があります。管理者にお問い合わせください |
AI講評の生成に関するメッセージです。いずれもシステム側の処理で発生するもので、利用者側の操作では解消できません。まずは時間をおいて再生成をお試しください。
繰り返し失敗する場合は、対象の案件名・クラス・操作した時刻を添えてお問い合わせください。
| 表示されるメッセージ | エラーコード |
|---|---|
| AIコメント生成用のAPIキーが設定されていません。 | AI_API_KEY_MISSING |
| AIコメント生成APIの呼び出しに失敗しました。 | AI_API_CALL_FAILED |
| AIコメント生成APIがHTTPエラーを返しました。 | AI_API_HTTP_ERROR |
| AIコメント生成APIのレスポンスが不正です。 | AI_API_RESPONSE_INVALID |
| AIコメント生成結果の解析に失敗しました。 | AI_RESPONSE_PARSE_ERROR |
「APIキーが設定されていません」は設定不備のため、再試行しても解消しません。この表示が出た場合はお問い合わせください。それ以外は一時的な失敗の可能性があるため、時間をおいて再生成をお試しください。
AI講評を作る元になる大問（設問設定）が登録されていません。
テスト管理で設問設定Excelがアップロードされているかご確認ください。設問設定が未登録の場合は、先にアップロードが必要です。
サポートに連絡する場合は、エラーコード AI_QUESTIONS_NOT_FOUND をお伝えください。
| 表示されるメッセージ | エラーコード |
|---|---|
| ManaQueueジョブの作成に失敗しました。 | MANAQUEUE_JOB_CREATION_FAILED |
| ManaQueueジョブIDが取得できません。 | MANAQUEUE_JOB_ID_MISSING |
| ManaQueueジョブの状態確認に失敗しました。 | MANAQUEUE_STATUS_CHECK_FAILED |
| ManaQueueジョブ結果の取得に失敗しました。 | MANAQUEUE_RESULT_FETCH_FAILED |
ManaQueueはAI講評の生成を順番に処理する仕組みです。これらのメッセージは、その処理システムとの通信に問題があることを示します。
進捗表示が動かないまま長時間経過している場合もあわせてお問い合わせください。生成済みの採点結果や個票のデータが失われることはありません。