第 2 章 — 毎日の確認
この章で分かること
- 毎日 3 分で何を見ればよいか
- エラーが出ていたときの読み方と対応のしかた
- 会話ログの見方（AI の答えの質を確かめる）
- 「Bot が反応しない」と言われたときに、上から順に確認する手順
なぜ毎日見る必要があるのか。
このアプリは、エラーが起きても Slack に自動で通知を飛ばしません
（自動通知があるのは緊急停止の操作だけです。それも #alerts チャンネルが設定されている場合に限ります）。
つまり人が画面を見に行かないと、失敗に気づけません。朝いちばんの習慣にしてください。
2-1. 朝の 3 分チェック
管理画面の ダッシュボード を開きます。上から順に見るだけです。
| 見るところ | 正常 | 正常でないときは |
|---|---|---|
| AI応答（一番上のカード） | 緑色で 稼働中 「生徒からの質問に AI が回答しています」と書かれています |
赤色で 停止中 → 誰かが緊急停止したままです。カードに理由と操作者が書かれています。 再開してよいか管理者に確認してください（第 7 章 7-1） |
| 未対応エラー | 0 | 1 以上 → 下の 2-2 へ。数字の下の「エラー管理を開く →」を押します |
| 今日の質問数 | いつもと同じくらい | ずっと 0 のまま → 誰も使えていない可能性。2-4 へ |
| 今月のコスト | いつもの伸び方 | 目安の金額を超えた（第 5 章 5-4）、または急に増えた → 第 5 章の連絡基準へ。$0.00 のまま増えない場合も開発者へ |
| 最近のエラー（一番下） | 見るのは上の未対応エラーの数字です。この一覧は対応済みのもの（薄い表示）も含めた直近 5 件なので、一度でもエラーが出ると、「エラーはありません」には戻りません | 薄くない行（未対応）をクリックすると詳細が開きます |
2-2. エラーが出ていたときの見方
エラーログ（開くと「エラー管理」）の一覧には、次の列が並びます。
| 列 | 意味 |
|---|---|
| エラーコード | AI_TIMEOUT のような英字の記号。クリックすると詳細が開きます |
| 生徒 | 誰の質問で起きたか（生徒に関係のないエラーは —） |
| チャンネル | どのチャンネルで起きたか |
| 深刻度 | エラー（赤）／警告（黄）／情報（灰） |
| 対応状況 | 未対応／対応済み |
| 発生日時 | いつ起きたか |
「情報」レベルは、ふだんは表示されません。 一覧は初期状態で エラー・警告（既定） に絞られています。 「情報」は正常な動作の記録（質問回数の上限に達した・退塾生のチャンネルで質問された・紐付けを作成した など）なので、隠されています。 探したいときは 深刻度 のフィルタを すべて に変えてください。
詳細画面の見方
エラーコードをクリックすると、次のことが分かります。
- ユーザーへ返した文言 … 生徒の画面に実際に届いたメッセージ。これが一番の手がかりです
- 内部エラー詳細 … 技術的な内容。開発者に連絡するときはここをそのままコピーして伝えます
- Slack で開く … その質問のスレッドに直接飛べます（実際のやり取りを確認できます）
- 対応済みにする／対応メモ … 対応が終わったら押して、何をしたか書き残します
よく出るエラーコードと、やること
| コード | 何が起きたか（平たく言うと） | やること | 急ぎ度 |
|---|---|---|---|
AI_RESPONSE_FAILED | AI が回答を作れなかった | 1 件なら様子見。連続して出るなら開発者へ連絡（第 5 章） | 高 |
AI_RATE_LIMITED | AI のサービス側が混み合っていた | 自動でやり直します（5 秒 → 15 秒の 2 回待って再挑戦。最大 3 回まで試します）。頻発するなら開発者へ | 中 |
AI_TIMEOUTJOB_TIMEOUT | 回答づくりに時間がかかりすぎた | 生徒には「もう一度送ってみてね」と返っています。頻発するなら開発者へ | 中 |
SLACK_POST_FAILED | Slack に書き込めなかった | Bot がチャンネルから外れていないか確認。外れていたら /invite @じゅくAI をやり直す | 高 |
CHANNEL_NOT_BOUND | 紐付けのないチャンネルで呼ばれた | 正しいチャンネルなら紐付けを登録（第 3 章 3-7）。関係ないチャンネルなら Bot を退出させる | 低 |
UNSUPPORTED_FILE_TYPEIMAGE_TOO_LARGE | 生徒が送ったファイルの形式・サイズが対象外（1 枚 20MB 超、または 1 回の合計 8MB 超も含む） | 生徒に伝える：画像は jpg / png / webp、1 枚 20MB 以下、1 回の合計 8MB 以下、3 枚まで。PDF や Word は読めません。（生徒に返る案内文には「jpg / png」とだけ書かれていますが、webp も読めます。生徒には jpg / png が確実です） | 低 |
SLACK_FILE_DOWNLOAD_FAILED | 画像を取り込めなかった | 1 件なら Slack 側の一時的な不調。頻発するなら開発者へ | 低 |
IMAGE_MODEL_NOT_CONFIGURED | 画像を読むための設定が入っていない | 開発者へ連絡（スタッフ側では直せません） | 中 |
PERSON_INACTIVE（情報） | 「無効」にした生徒のチャンネルで質問された | 正常な動作。復塾したなら生徒のステータスを 有効 に戻す | — |
RATE_LIMITED（情報） | その生徒が 1 時間に 10 回の上限に達した | 正常な動作（第 7 章 7-2） | — |
CHANNEL_BINDING_CREATEDCHANNEL_BINDING_UPDATED（情報） | 誰かが紐付けを作成・変更した記録 | 正常な動作。「いつ誰が紐付けを変えたか」を後から追うために残しています | — |
THREAD_SUMMARY_FAILEDEVALUATOR_FAILED | 回答を送ったあとの内部処理が失敗した | 回答自体は生徒に届いています。ときどきなら気にしなくてよい | 低 |
SLACK_SIGNATURE_INVALID | Slack 以外からの不正なアクセス、または署名の設定ミス。Bot が動いていても、単発で出ることがあります | Bot が普通に動いていて単発なら様子見。内容を確認して 対応済みにして、メモを残す（同じ種類は未対応のまま 1 行にまとまるので、そのままだと未対応エラーが 0 に戻りません）。Bot が全く動かないのと一緒に出たら開発者へ | 中 |
TOKEN_BUDGET_EXCEEDED（警告） | 質問が長すぎた（目安 6000 文字を超えた） | 生徒には「質問が少し長すぎて処理できなかったよ」と返っています。短く分けて送ってもらう | 低 |
IMAGE_PROCESSING_FAILED | 画像の処理に失敗した | 画像を撮り直して送ってもらう。頻発するなら開発者へ | 低 |
PERSON_NOT_FOUND | 紐付け先の生徒情報が見つからない | 開発者へ連絡（第 5 章） | 中 |
REPORT_CHUNK_SEARCH_FAILED | レポートの検索に失敗した。回答はレポートなしで生徒に届いています | 単発なら様子見。続くなら開発者へ（レポートが回答に使われていない状態です） | 中 |
UNKNOWN_ERROR | 想定していなかったエラー | 詳細画面の内部エラー詳細をコピーして開発者へ | 中 |
表にないコードが出たら、詳細画面の内部エラー詳細をそのままコピーして開発者へ連絡してください（第 5 章 5-5）。
対応が終わったら
- 詳細画面で 対応済みにする を押す
- 対応メモ に何をしたか書く（例：
Bot が退出していたので再招待した）
未対応のままにしておくと、翌朝のダッシュボードにも数字が残ります。 「見たけれど対応不要と判断した」ものも、その旨をメモして対応済みにしておくと、翌日の自分が迷いません。
2-3. 会話ログの見方
会話ログは、生徒とじゅくAI のやり取りがスレッド 1 本 = 1 行で並ぶ画面です。 「AI がちゃんと答えられているか」を確かめる場所です。
| 列 | 意味 |
|---|---|
| 生徒 | 誰の会話か。クリックすると中身が開きます |
| チャンネル | どのチャンネルか |
| 概要 | 長いスレッドを AI が短くまとめたもの（短いスレッドでは —） |
| 件数 | そのスレッドのメッセージ数 |
| 状態 | 画像が使われたか／エラーが起きたか（アイコン） |
| 最終メッセージ | 最後のやり取りの日時 |
上のフィルタで 生徒・期間・モデル・画像ありのみ・エラーありのみ に絞り込めます。
行をクリックすると、生徒とじゅくAI の吹き出しが時系列で並びます（右が生徒、左が じゅくAI）。 画像を送った発言には「画像添付あり」と表示されます。
ここが AI 用プロフィールを直す材料になります。 たとえば「説明が長すぎて生徒が読み飛ばしている」「学年に合わない難しい説明をしている」と気づいたら、 AI 用プロフィールの「学習スタイル・説明トーン」に書き足してください。次の質問からすぐ反映されます。
2-4. 「Bot が反応しない」と言われたとき
まず生徒にこう聞いてください：「どんな返事が返ってきた？」 返ってきた文面で原因がほぼ決まります。何も返ってこなかったのか、何か文章が返ってきたのかが分かれ目です。
A. 何も返ってこない（🤔 も付かない）
頻度の高い順です。上から潰してください。
| # | 原因 | 見分け方 | 対処 |
|---|---|---|---|
| 1 | Bot がチャンネルに招待されていない いちばん多い |
チャンネル名をクリック → インテグレーション タブに「じゅくAI」が無い。エラーログにも何も残らない | そのチャンネルで /invite @じゅくAI と打つ（第 3 章 3-5） |
| 2 | 生徒が @じゅくAI を付けていない |
チャンネルの一番下（スレッドの外）に、メンションなしの発言が並んでいる | 生徒に伝える：新しい質問は @じゅくAI から始める。返信を続けるときはスレッドの中でメンション不要 |
| 3 | 生徒のステータスが 無効 になっている | 生徒管理でその生徒のステータスが「無効」。エラーログを深刻度「すべて」にすると PERSON_INACTIVE（情報）がある |
在籍しているなら 有効 に戻す（第 3 章 3-8） |
| 4 | Bot がスタッフの発言に反応しようとしている | 参加通知・ピン留めなどのシステムメッセージに反応していない | 仕様です。Bot 自身の発言や、Slack のシステムメッセージには反応しません |
| 5 | 上のどれでもない | — | 開発者へ連絡（Slack 側の設定の可能性。第 5 章） |
B. 何か文章が返ってきた
返ってきた文面ごとの原因です。生徒に文面をそのまま読んでもらうか、 会話ログで確認してください。
| 返ってきた文面 | 原因 | 対処 |
|---|---|---|
| このチャンネルにはまだBotの設定が完了していないみたい。 |
紐付けが無い、または「無効」 | チャンネル設定でこのチャンネルを紐付ける／ステータスを 有効 にする（第 3 章 3-7） |
| いまメンテナンス中でお返事ができないんだ | 緊急停止中 | ダッシュボードの AI応答カードが赤。管理者に再開を依頼（第 7 章 7-1） |
| 今日はたくさん質問してくれてありがとう！ |
1 時間に 10 回の上限 | 仕様です。1 時間待てば再び使えます（第 7 章 7-2） |
| いま少し混み合ってるみたいで、すぐ答えられないや | AI のサービス側が混雑 | 1〜2 分待って送り直してもらう |
| 回答の生成に時間がかかりすぎてしまった | 質問が重すぎた | 質問を短く分けて送ってもらう |
| 処理がタイムアウトしちゃった | 処理に時間がかかりすぎた | もう一度送ってもらう。頻発するなら開発者へ |
| 質問が少し長すぎて処理できなかったよ | 文章が長すぎる（目安 6000 文字） | 短く分けて送ってもらう |
| ごめん、そのファイル形式にはまだ対応してないんだ | PDF・Word などを送った | 画像（jpg / png / webp）で送ってもらう。撮り直しでも可。（この文面には「jpg / png」とだけ書かれていますが、webp も読めます） |
| 画像が少し大きすぎたみたい | 1 枚 20MB 超、または 1 回の合計 8MB 超 | 小さめに撮り直してもらう |
| 画像の取得に失敗しちゃった | Slack から画像を取り込めなかった | 少し時間を置いて送り直してもらう。続くなら開発者へ |
| 画像の処理がうまくいかなかったけど、テキストの内容で回答するね | 画像の処理に失敗した（文章だけで答えた） | 画像を撮り直して送ってもらう。続くなら開発者へ |
| （回答の末尾に）送ってくれた画像のうち ○ 枚は読み込めなかったんだ… | 4 枚目以降、対象外の形式・サイズ、取り込み失敗などで読めなかった画像がある | 枚数を減らす・jpg / png / webp にする・小さめに撮り直す、のどれかで送り直してもらう |
| ごめん、いまは画像を読み取れないんだ…（画像だけの質問のとき） （回答の末尾に）ごめん、いまは画像を読み取れないみたい。文章の内容から答えたよ…（文章つきの質問のとき） | 画像を読む設定が入っていない | 開発者へ連絡 |
| うまく処理できなかったみたい | 内部エラー | エラーログを見る（2-2）。続くなら開発者へ |
| 対応する生徒情報が見つからなかったよ | 紐付け先の生徒情報がおかしい | 開発者へ連絡 |
C. 🤔 は付いたが、回答が返ってこない
- まず 1 分待つ（ふだんは 15〜30 秒で返ります）
- それでも来なければ ジョブ を開く（次の 2-5）
- 失敗 に 1 件以上あれば 再実行 ボタンを押す
- それでも来なければ 開発者へ連絡
まれに、処理が途中で止まって 🤔 が付いたまま残ることがあります。 生徒には「まだ考え中」に見えてしまうので、ジョブ画面から再実行して回答を届けてください。
2-5. ジョブ画面（詰まっていないかの確認）
生徒の質問は 1 件ずつ順番に処理されます。ジョブはその進行状況を見る画面です。 ふだんは見なくてよく、「回答が来ない」と言われたときに開きます。
| カード | 正常 | たまっているときの意味 |
|---|---|---|
| 待機中 | 滞留なし | 受け付けたが処理が始まっていない。数分で消えるなら正常。15 分以上残るなら開発者へ |
| 処理中 | 滞留なし | 始まったまま終わっていない。10 分以上は異常 → 開発者へ |
| 失敗 | 滞留なし | 回答できなかった質問があります。生徒は待ちぼうけです。最優先で対応 |
失敗した質問をやり直す
失敗 の行にだけ 再実行 ボタンが出ます。押すと確認のダイアログが表示されます。
| ダイアログの文言 | 意味 | AI の費用 |
|---|---|---|
| 生成済みの回答が残っているため、AI を呼び直さず Slack への投稿だけをやり直します。 | 回答は作れていたが、Slack への書き込みで失敗した | かからない |
| AI 回答を生成し直して Slack に投稿します（API 利用コストが発生します）。 | 回答づくり自体が失敗した | かかる |
安心して押して構いません。
再実行する直前に「同じスレッドにじゅくAI の返信がもう入っていないか」を必ず確認する仕組みが入っています。
すでに届いていれば実行されず、
既に回答が配信済みのため再実行せず、完了として記録しました（二重返信の防止）
と表示されます。同じ回答が 2 回投稿されることはありません。
この画面を開くと、止まってしまった処理の後片付けが自動で走ります（1 分に 1 回まで）。 スイープ実行 ボタンで手動でも走らせられます。後片付けで「失敗」に変わっても生徒には何も通知されません （すでに回答が届いている可能性があり、二重に案内すると混乱するためです）。人が判断して再実行してください。