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の状態を確認する必要があります。管理者にお問い合わせください |
この記事で解決しましたか？