第 3 章 — 生徒の登録と管理

3-0. 全体の流れ（5 ステップ）

生徒の登録やチャンネルの紐付けなどの最初の設定は、当面は開発担当（川崎）が代わりに行います。 この章の手順は、塾で自分で行うとき（生徒が増えたときなど）の手順です。

  ① 生徒を登録する           管理画面 → 生徒管理 → 新規生徒
           ↓
  ② AI 用プロフィールを書く   管理画面 → 生徒管理 → 生徒名をクリック
           ↓                  ★ ここが AI の答えの質を決めます
  ③ チャンネルを作る          Slack → + → チャンネルを作成
           ↓
  ④ Bot を招待する            チャンネルで  /invite @じゅくAI
           ↓                  ★ 忘れると永久に無反応です
  ⑤ 紐付ける                  管理画面 → チャンネル設定 → 新規紐付け
           ↓                  ★ 生徒を間違えると別の生徒の情報で答えます
     生徒が質問できる状態

• ① 生徒を登録した
• ② AI 用プロフィールを書いた（氏名を書いていないことを確認した）
• ③ Slack にチャンネルを作り、生徒本人を招待した
• ④ /invite @じゅくAI で Bot を招待した
• ⑤ チャンネル ID と生徒を確認して紐付けた
• 実際にそのチャンネルで質問して、回答が返ることを確かめた

3-1. 生徒を登録する

生徒管理 → 右上の 新規生徒。

保存 を押すと生徒一覧に戻り、生徒を登録しました と表示されます。 一覧では名前・学年・ステータス・登録日が並びます。

3-2. AI 用プロフィールの書き方 ★最重要

生徒管理 → 一覧で生徒の名前をクリック → ページ下部の AI 用プロフィール。

画面にはこう書かれています。

5 つの入力欄

書き終えたら プロフィールを保存 を押します。ボタンの横に 保存しました と出ます （ページは移動しませんので、そのまま続けて直せます）。次の質問からすぐ反映されます。

AI には何が送られるのか

送られるのは、学年と、あなたが実際に書いた欄だけです。空欄の項目は送られません （「未設定」とも書かれません）。実際にはこんな形で AI に渡ります。

学年: 中学3年
要約: 数学は基礎計算は安定してきたが、文章題で条件を式に落とすところでつまずきやすい。
      英語は単語量が足りていない。
学習スタイル: 図を使った説明が入りやすい。長文の説明は読み飛ばしがち。
得意: 一次関数の計算、比の計算
苦手: 文章題（速さ・割合）、証明の書き出し
指導メモ: 答えをすぐ出すと写して終わりになりやすいので、まず考え方から。

氏名も生徒番号も入っていません。これは意図してそう作られています。 だからこそ、あなたが自由記述の欄に氏名を書いてしまうと、そこだけが例外になってしまいます。

悪い例と良い例

書き方のコツ

• 「単元 ＋ つまずき方」をセットで書く。これだけで回答がはっきり変わります
• 「苦手」より「つまずきやすい」。AI はこの表現を引き継いで生徒に話します。断定的な言い方は避けてください
• やってほしくないことは「指導上の注意」に書く。「答えだけ先に出さない」「英単語は日本語訳だけでなく例文も」など
• 長く書きすぎない。全体要約は 200〜800 文字が目安です。情報が多すぎると、大事な点がぼやけます
• 3 か月に 1 回は見直す。会話ログを読んで、 「説明が長すぎる」「学年に合っていない」と感じたら書き足します
• 白紙でも動きます。ただし学年だけを見た一般的な回答になります。全体要約だけでも書いてあると効果が大きいです

3-3. 試験期間（任意・余裕があれば）

AI 用プロフィールの下にある 試験期間 の枠で設定します。

何が変わるか：試験期間中は、設定した試験科目が AI に伝わります（AI 用プロフィールの一部として送られます）。 回答の出し方は、今のところ変わりません。いまのじゅくAI は、試験期間にしていてもいなくても、どの生徒にも要点から直接説明する形で答えるためです（第 6 章 6-3）。 最終日を過ぎると、試験科目は AI に伝わらなくなります。

• 解除の操作は要りません。最終日を過ぎれば自動で通常に戻ります
• 設定中は、生徒一覧のステータス欄に 試験期間中 のバッジが付きます
• 保存は AI 用プロフィールと同じ プロフィールを保存 ボタンです

3-4. Slack にチャンネルを作る

1. Slack で ＋ → チャンネルを作成
2. 名前を分かりやすく付ける（例：study-taro ／ 質問-山田太郎）
3. 公開／非公開は、塾で決めた方針にそろえる
4. 生徒本人を招待する（必要なら保護者や担当講師も）

原則 生徒 1 人 = チャンネル 1 つ です。1 つのチャンネルに 2 人の生徒を入れることはできません （「このチャンネルの質問は誰のものか」を 1 人に決める必要があるためです）。

3-5. Bot を招待する ★忘れると動きません

そのチャンネルの入力欄で、次のように打って送信します。

/invite @じゅくAI

「じゅくAI がチャンネルに参加しました」と表示されれば完了です。

確認のしかた：チャンネル名をクリック → インテグレーション タブに「じゅくAI」が並んでいれば入っています。

生徒を追加するたびにチャンネル作成 → 招待がセットで必要です。 Bot をチャンネルから外すと、その時点で反応しなくなります（SLACK_POST_FAILED のエラーが出ることもあります）。

3-6. チャンネル ID の調べ方

チャンネル ID（C で始まる）

1. Slack でチャンネル名をクリックしてチャンネル詳細を開く
2. 出てきた画面を一番下までスクロールする
3. チャンネル ID: C01ABCDEFGH と表示されている → 横のコピーボタンでコピー

ブラウザで Slack を使っている場合は、アドレス欄の末尾（.../messages/C01ABCDEFGH）でも確認できます。 非公開チャンネルでは G で始まることもあります。どちらでも登録できます。

ワークスペース ID（T で始まる）

塾のワークスペース全体で 1 つの値なので、生徒ごとに調べ直す必要はありません。一度メモしておけば使い回せます。

ブラウザで Slack を開いたときのアドレス https://app.slack.com/client/T01ABCDEFGH/C01... の最初の ID がそれです。 分からない場合は開発担当（川崎）に聞いてください。

3-7. チャンネルと生徒を紐付ける ★事故に注意

紐付けとは、「このチャンネルに来た質問は、誰のものか」を決める設定です。 じゅくAI は生徒が名乗るのを待ちません。チャンネル ID だけを見て「誰の質問か」を決めます。

手順

チャンネル設定（開くと「チャンネル紐付け」）→ 右上の 新規紐付け。

紐付ける を押すと、確認のダイアログが出ます。

ここで必ず、チャンネルと生徒名の組み合わせを声に出して読んで確かめてください。 合っていれば 紐付けを確定する、違っていれば キャンセル です。 確定すると チャンネルを紐付けました と表示されて一覧に戻ります。

事故を防ぐ 3 つの確認

1. 貼り付けた直後に見比べる：Slack でコピーしたチャンネル ID と、入力欄の値の末尾 3 文字が同じか
2. 確認ダイアログを読む：チャンネル名と生徒名の組み合わせが正しいか
3. 実際に質問してみる：そのチャンネルで @じゅくAI テストです と送り、返ってきた回答がその生徒あての内容になっているか （会話ログでも、正しい生徒名の行として記録されているか確認できます）

よく出るエラー文言

一覧で確認する

チャンネル設定の一覧には チャンネル・チャンネルID・生徒・既定レポート・ステータス・登録日 が並びます。 月に 1 回は、この一覧をひととおり見て、チャンネルと生徒の対応が合っているか確認してください。

3-8. 退塾・休塾のとき

手順

1. 生徒管理 → 対象の生徒をクリック
2. ステータス を 無効 に変更
3. 保存

復塾したら、ステータスを 有効 に戻すだけで元どおり動きます。

生徒は在籍のまま、チャンネルだけ止めたい場合

チャンネル設定 → 該当の行を開く → ステータス を 無効 に。 この場合、そのチャンネルでの質問には 「このチャンネルにはまだBotの設定が完了していないみたい…」という案内文が返るようになります。

Slack のチャンネル自体はアーカイブしておくと、生徒側にも「終わった」ことが伝わります。