Table of Contents
Instructor Usage Guide
This guide is for instructors (group administrators) who use Exercode in their classes. It explains, in order of tasks, how to check students' progress and AI chat usage, and how to use that information for in-class support and post-class review.
1. Glossary
1-1. Permission types
Exercode has four types of permissions.
| Name | Permission | Intended for |
|---|---|---|
| Setup administrator | Organization administrator | Overall manager for the school. Invites users to the organization and creates groups |
| Instructor | Group administrator | Class or subject teachers and TAs. The reader of this guide |
| Material author | Member of the material repository | People who create and maintain materials in the GitHub material repository |
| Student | General member | Students taking the class |
Instructors can view information about the students in groups they manage and the courses added to those groups.
In this guide, learners are called "students." On screen, they may appear as "学生 (students)," "学習者 (learners)," or "受講者 (attendees)," but all mean the same thing.
1-2. Organizations and groups
| Term | Meaning | Example |
|---|---|---|
| Organization | An educational institution such as a school or university | 〇〇大学, 〇〇専門学校 |
| Group | A class or department within an organization. Instructors check the students in the groups they teach | 〇〇学科 1 年(2026 年度) |
| Member | A user belonging to an organization or group (both instructors and students) |
An organization contains multiple groups. Conceptually, it looks like this:
- Organization (〇〇大学)
- Group (〇〇学科 1 年 A 組)
- Member (instructor)
- Member (student A)
- Member (student B)
- Group (〇〇学科 1 年 B 組)
- Member (instructor)
- Member (student C)
- Member (student D)
- Group (〇〇学科 1 年 A 組)
1-3. Material structure
| Term | Meaning | Example |
|---|---|---|
| Course | A collection of materials for the whole subject. Corresponds to one subject in a class | Python 言語の基礎, Java 演習 |
| Lecture | A unit that makes up a course. Corresponds to one class session | 第 1 回 変数と型 |
| Material | The smallest unit of teaching material. Includes explanatory text, problems, and submission settings | 演習 1-1 |
For example, a course "Python 言語の基礎" run over 15 lectures is registered in Exercode as follows. Each lecture contains the materials to be solved in that session.
- Course: Python 言語の基礎
- Lecture: 第 1 回 変数と型
- Material: 演習 1-1 変数の宣言
- Material: 演習 1-2 型の変換
- Lecture: 第 2 回 条件分岐
- Material: 演習 2-1 if 文
- Material: 演習 2-2 比較演算子
- … (continues through lecture 15)
- Lecture: 第 1 回 変数と型
To make this course available to students, add the course to a group. For example, if you add "Python 言語の基礎" to the group "情報工学科 1 年 A 組," it will appear in the 科目一覧 (course list) of students in that group. Students open the materials that match each lecture and solve the problems. Submission periods and similar settings are configured per material (see 5-3).
2. What each permission can do
A list of which permission can perform each operation described in this guide.
| Operation | Instructor (group administrator) | Setup administrator (organization administrator) | Material author |
|---|---|---|---|
| Invite members to the organization | ✕ | ○ | ✕ |
| Create or delete groups | ✕ | ○ | ✕ |
| Add or remove students from a group | ○ | ○ | ✕ |
| Make other instructors group administrators / remove their permissions | ○ | ○ | ✕ |
| Register student profiles | ○ (only for own groups) | ○ | ✕ |
| Add a course to a group | △ (※1) | △ (※1) | ✕ |
| Create a new course | ○ | ○ | ✕ |
| Set material release timing, deadlines, and exam mode | ○ | ○ | ○ |
| Edit material text and problems | ○ | ○ | ○ |
| Set lecture schedules | ○ | ○ | ○ |
| Open materials in teacher mode / try the AI chat | ○ | ○ | ○ |
| Run real-time surveys | ○ | ○ | ○ |
| View learning analytics (progress, stumble analysis, AI chat) | ○ | ○ | ✕ |
| Download progress as CSV | ○ | ○ | ✕ |
| View submitted code on the leaderboard | ○ | ○ | ○ |
| Grade manually | ○ | ○ | ✕ |
| Re-import materials from the material repository | ✕ | △ (※2) | ○ |
- ※1 You can only add courses created within your organization and courses imported from a material repository registered to your organization.
- ※2 Only the organization administrator of the organization where the material repository is registered can do this.
For details on permissions, see Permission types and capabilities.
3. Overall flow
The steps for an instructor to use Exercode in class are the following eight. After joining the organization (step 2) and preparing courses and students (steps 4–6), proceed to checking progress during and after class (steps 7 and 8).
| Step | Task | Who does it | Description |
|---|---|---|---|
| 1 | Invite instructors to the organization | Setup administrator | 2. Create groups and register instructors in the setup guide for setup administrators |
| 2 | Join the organization from the invitation email | Instructor | 4-1. Join the organization from the invitation email |
| 3 | Make the instructor a group administrator | Setup administrator, or another group administrator | 4-2. Confirm you are a group administrator |
| 4 | Add courses to groups and configure materials | Instructor (or setup administrator) | 5. Prepare materials |
| 5 | Invite students to the organization | Setup administrator | 5. Register students in the setup guide for setup administrators |
| 6 | Add students to groups | Instructor (or setup administrator) | 6-1. Add students to a group |
| 7 | Check student status during class | Instructor | 7. Check student progress during class |
| 8 | Review and grade after class | Instructor | 8. Review after class, 9. Grade manually |
- Steps 1, 3, and 5 are performed by the setup administrator (step 3 may also be done by another group administrator). Instructors only need to confirm in 4-2. Confirm you are a group administrator that it is set up. If students have not joined the organization, ask the setup administrator to send invitations.
- Steps 4 and 6 may already have been completed by the setup administrator. You can check whether they are done in 4-3. Check that class preparation is complete; if they are, you can skip them. Discuss with the setup administrator to decide how much of this the instructor will handle.
4. First steps
4-1. Join the organization from the invitation email
Who can do this: Instructor
When the setup administrator invites you as an instructor, an invitation email arrives from no-reply@willbooster.dev.
-
Open the invitation email and go to the URL written in it.
-
In the "Create account / sign in with email address" field, enter the email address that received the invitation and press
確認コードを送信(Send verification code). -
An email containing a verification code arrives. Enter the code and press
確認してログイン(Verify and sign in). -
When "組織「○○○(組織名)」に参加しますか?" (Do you want to join the organization "○○○ (organization name)"?) is displayed, press
参加(Join).
If the invitation email does not arrive: Check your spam folder. If you cannot find it, tell the setup administrator your email address and ask them to resend the invitation.
Signing in from the second time onward: Press
アカウント作成/ログインat the upper right of the Exercode top page, enter the email address that received the invitation, and sign in with the verification code sent to it. Joining the organization is only needed the first time.
Tip: To skip entering a verification code every time you sign in, register a passkey. Press the account button at the upper right →
設定(Settings), then pressパスキーを追加underパスキー(Passkeys) and register using your browser or device authentication. From then on, you can sign in withパスキーでログイン(Sign in with passkey) on the sign-in screen.
4-2. Confirm you are a group administrator
Who can do this: The setup administrator or another group administrator of the group (there is no action required on the instructor's side)
Features introduced later in this guide, such as checking progress during class (chapter 7), reviewing after class (chapter 8), and manual grading (chapter 9), can only be used by group administrators of the groups you teach. You can confirm whether this is already set up in either of the following ways.
Check in the group list (you can check even if no course has been added to the group yet)
- Press
所属(Affiliations) at the top of the screen and open the organization name. - If
グループ(Groups) appears and the opened list contains the group you teach, it is set up. Ifグループdoes not appear, you are not yet a group administrator.
Check on the course page (if a course you teach has been added to the group)
- Open
科目一覧(Course list) at the top of the screen. - Open the course you teach.
- If
グループ管理者向けメニュー(Group administrator menu) is displayed, it is set up.
If you cannot confirm either way: Ask the setup administrator to check the following three points:
- Whether you have already joined the organization
- Whether you are a group administrator of the group you teach
- Whether the course has been added to that group (courses only added to the organization will not be displayed)
4-3. Check that class preparation is complete
Before the first class, check the following. For anything not yet done, proceed in consultation with the setup administrator.
| What to check | Where to check | If the instructor handles it |
|---|---|---|
| The course you teach is added to your group | A course appears in 科目一覧, and opening it shows グループ管理者向けメニュー | 5-1. Add a course to a group |
| Students are added to the group | 所属 → organization name → グループ → target group → メンバー (Members) | 6-1. Add students to a group |
| Material release timing and deadlines match the class schedule | 科目一覧 → target course → 編集 (Edit) for the target material | 5-3. Set material release timing and deadlines |
| (Optional) Lecture schedule is set | 科目一覧 → target course → 授業時間設定 (Lecture schedule settings) | 5-4. Set the lecture schedule |
| (Optional) For materials used for in-class surveys, real-time surveys are enabled | 科目一覧 → target course → 編集 for the target material → リアルタイムアンケート (Real-time survey) under the 提出・試験設定 (Submission & exam settings) tab | "Preparation (before class)" in 7-5. Run a real-time survey |
5. Prepare materials
Prepare the materials to use in class. Materials are inside a course, so first add the course to your group (5-1 and 5-2), then set the material release timing and deadlines to match your schedule (5-3 and 5-4), and finally review the content in the same view as students (5-5). If the setup administrator has already added the course, start from 5-3.
5-1. Add a course to a group
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
Add a course created in the organization, or a course imported from a material repository registered to the organization, to your group. Not needed if the setup administrator has already added it (i.e., the course you teach appears in 科目一覧).
-
Press
所属at the top of the screen and open the organization name. -
Open
グループand then open the target group. -
Open
科目(Courses). -
Enter the ID of the course you want to add. Courses not yet added to a group do not appear in the instructor's
科目一覧, so ask the setup administrator for the course ID (it is the part after/courses/in the course page URL). -
Press
追加(Add).
Added courses can only be used by members of that group.
If you cannot add the course: You can only add courses created within your organization and courses imported from a material repository registered to your organization. Courses shared from other organizations, for example, will produce an error, so consult the setup administrator. If you enter a non-existent ID, no error is shown and it is simply ignored. After pressing
追加, check that the course appears in科目一覧.
5-2. Create a new course
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
If you teach with your own materials, you can create a course on the Exercode screen and write the materials directly.
- Open
所属→ organization name →グループ→ target group →科目. - Press
科目の作成(Create course). - Enter
科目名(Course name) and説明(Description). - Under
グループ(Group), select a group you manage. - Press
作成(Create).
Created courses can only be used by members of the selected group. After creation, you are taken to the course edit screen, where you can add lectures with 授業を追加 and materials with 教材を追加. To write material text and questions, press Markdownを編集 for the material on the course edit screen and create them on the 本文・設問 (Text & questions) tab. For detailed steps on creating and editing courses, see Create a course for an organization or group; for editing materials, see Edit materials.
Caution: If you delete a lecture or material on the course edit screen after students have started submitting, all of those students' submissions and progress for that lecture or material will also be deleted, and this cannot be undone. Deleting an existing question on the material edit screen also breaks its link to submission history. After operation begins, do not delete lectures, materials, or questions. For materials you are not using, either set the submission release to a later date so students cannot see them, or rewrite their text.
5-3. Set material release timing and deadlines
Who can do this: Instructor (group administrator), setup administrator (organization administrator), material author
- Open
科目一覧→ target course. - Press
編集(Edit) for the target material. - On the
提出・試験設定(Submission & exam settings) tab, configure the items in the table below and press更新(Update).
| Item | Description |
|---|---|
| Submission opening | The date and time students can start submitting. Before this time, the material content is not referenced by students' AI chat |
| Submission deadline | Submissions after this time are treated as late submissions and shown in yellow in learning analytics |
| Final submission deadline | After this time, submissions are no longer accepted |
| Exam mode | A setting for quizzes and exams. Students cannot use learning support features such as AI chat, and hints are not shown during the submission period |
| Early exam termination | Can only be set in exam mode. If you check 途中で試験を終了できるようにする (Allow ending the exam early), students can end the exam before the final submission deadline |
| Mock exam mode | Switches to a screen for practicing exams. Correctness and accuracy rate are shown to students after the final submission deadline. AI chat works as usual |
- Items that are not set impose no restriction. If submission opening, submission deadline, and final submission deadline are all left blank, students can submit at any time.
- To have students use a material for each class, set the submission opening to match the class schedule.
- These settings apply per material. If the same course is used across multiple groups or organizations, changes apply to all students using that material.
- About early exam termination:
- Students who end the exam cannot answer or submit until the deadline. Ending cannot be undone.
- If no final submission deadline is set, the end button is not shown.
- In mock exam mode, questions are answered in a
問題一覧(Problem list) view and a one-question-at-a-time view. Coding problems are not shown in問題一覧.
Caution: Materials imported from a GitHub material repository may be overwritten by changes made on the
編集screen when re-imported. For settings you want to keep, ask the material author to reflect them in the material repository. Settings to disable AI chat or hints per material, or the time until hints become available, are configured by the material author in the material repository. The settings available are summarized in "3. Add materials" of the setup guide for setup administrators. Courses created on the Exercode screen (5-2) have no material repository, so these settings cannot be made; the only way to stop students' AI chat is exam mode.
5-4. Set the lecture schedule
Who can do this: Instructor (group administrator), setup administrator (organization administrator), material author
Setting the lecture schedule lets learning analytics distinguish submissions made during class hours from those made outside class hours.
-
Open
科目一覧and open the target course. -
Press
授業時間設定(Lecture schedule settings). -
Enter the day of the week, start time, and end time, and press
時間を追加(Add time). For classes with different days or time slots, you can add more. -
Confirm the entry has been added under
現在の授業時間(Current lecture schedule), and press変更を保存(Save changes).
Caution: The lecture schedule is one per course. If the same course is used by multiple groups, changes are reflected in the learning analytics of all groups using that course. Instructors can only set schedules for courses already added to their own groups.
5-5. Review materials in the same view as students
Who can do this: Instructor (group administrator), setup administrator (organization administrator), material author
Materials on the course page can be opened in two ways.
| Button | How it opens |
|---|---|
始める (教員モード) (Start (teacher mode)) | Lets you open and review the material even outside the submission period |
始める (学生モード) (Start (student mode)) | Opens the material under the same conditions as students |
- Materials whose submission opens more than 10 minutes from now cannot be opened with
始める (学生モード). Open them with始める (教員モード). - Instructors can use the AI chat on the material screen and problem screen even for materials where students cannot use the AI chat (exam-mode materials, materials with AI chat disabled, and materials before submission opening). You can try how the AI answers students' questions before class.
6. Manage students and instructors
Register the students and instructors who belong to your group. This includes adding and removing students (6-1 and 6-2), granting or revoking management permissions for other instructors and TAs (6-3 and 6-4), and registering students' names and student IDs (6-5). If the setup administrator has already added students, 6-1 and 6-2 are unnecessary. Use this when students or instructors are added or removed during the course.
Adding and removing members and changing permissions are all done on the group's メンバー (Members) screen. To open it:
-
Press
所属at the top of the screen and open the organization name. -
Open
グループand then open the target group. -
Open
メンバー.
Important premise: Only people who have already joined the organization can be added to a group. Only the organization administrator (setup administrator) can invite people to the organization. If someone has not joined the organization, ask the setup administrator to send an invitation.
6-1. Add students to a group
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
- Open the group's
メンバーscreen. - Enter the email addresses of the students you want to add. You can enter multiple addresses separated by line breaks or spaces.
- Do not check
管理権限(Management permission). - Press
追加・権限の更新(Add / update permissions).
Caution: The
管理権限checkbox applies equally to all email addresses entered. If you enter an instructor's email address together with students' addresses, that instructor's group administrator permission will be removed.
6-2. Remove students from a group
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
- Open the group's
メンバーscreen. - Enter the email addresses of the students you want to remove.
- Check the number of people to be deleted shown on the screen (e.g.,
現在の入力では 2 人が削除されます。) and press一括削除(Bulk delete). - On the confirmation screen, check the number to be deleted and press
はい(Yes).
Removing them from the group does not remove them from the organization.
6-3. Make another instructor or TA a group administrator
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
If several instructors or TAs teach the same group, you can make others group administrators. You do not need to ask the setup administrator.
-
Open the group's
メンバーscreen. -
Enter the email address of the person you want to make a group administrator.
-
Check
管理権限(Management permission). -
Press
追加・権限の更新(Add / update permissions). -
Confirm the checkmark appears in the
管理権限column of the member list.
If they do not appear in the list: The person may not have joined the organization. Email addresses of people who have not joined are ignored without showing an error. Ask the setup administrator to send an invitation to the organization.
6-4. Remove a group administrator's permission
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
Permissions of instructors or TAs who are no longer teaching can be removed while keeping them in the group.
- Open the group's
メンバーscreen. - Enter the email address of the person whose permission you want to remove.
- Uncheck
管理権限. - Press
追加・権限の更新(Add / update permissions). - Confirm the checkmark in the
管理権限column of the member list has been removed.
- You can remove your own permission, but once removed, you cannot restore it yourself. You will no longer be able to manage this group, and restoring it requires asking another group administrator or the setup administrator. Be careful not to enter your own email address when adding students.
- If you also hold organization administrator permission, removing your group administrator permission still lets you manage the group as an organization administrator.
6-5. Register student profiles
Who can do this: Instructor (only members of your own groups), setup administrator (organization administrator)
Registering students' names and student IDs via CSV makes them easier to identify in learning analytics, as their names appear in the name column. Students without a registered profile show - in the name column.
Caution: Profiles are overwritten by the contents of the CSV saved last. Blank fields will erase existing values. If the setup administrator and an instructor register using different CSVs, previously registered content may be lost. Decide with the setup administrator who will do this.
- Open
科目一覧→ target course, and pressユーザプロフィール(User profiles) in theグループ管理者向けメニュー(Group administrator menu). - Press
テンプレートをダウンロード(Download template) and save the CSV template. - From row 2 onward in the template, enter information for each student.
- Do not change the column names in row 1 (
メールアドレス,氏名,所属,学籍番号,入学年度,学部,学科,クラス). - Only
メールアドレス(email address) is required. - Enter only numbers for
入学年度(year of enrollment).
- Do not change the column names in row 1 (
- Upload the CSV you entered in the
CSVファイルfield, and check the contents loaded in the table on screen. - Press
保存(Save). If更新しました。(Updated.) is shown, it has been saved. - On the group's
メンバーscreen, confirm the profile has been reflected.
If it is not reflected: The following rows are not reflected, and no notice is shown.
- Rows for people who have not joined the organization
- Rows for people who are not in groups you manage
Also, for columns whose names have been changed or deleted, the registered values are erased.
6-6. Guidance to students and handling inquiries
Students are informed in the Student usage guide as follows. Use this as a reference when students ask questions.
- AI chat content and hint usage counts can be checked by the instructor to improve classes
- Students' AI chat does not reference materials for which AI chat is disabled by the instructor, or the content of exam materials
- After the submission period ends, model answers are shown. Depending on the instructor's settings, some problems will not display them
- If the invitation email does not arrive, students should report it to their instructor
If a student reports that the invitation email has not arrived, check the student's email address and tell the setup administrator. Resending invitations is done by the setup administrator (organization administrator).
7. Check student progress during class
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
During class, keep the learning analytics screen open to check students' status. The screen is explained in this order: how to read the progress table colors (7-1), how to find students to talk to (7-2 and 7-3), and the status of questions to the AI (7-4). For running an in-class survey, see 7-5.
When class starts
-
Open
科目一覧→ target course →学習分析(Learning analytics). The進捗(Progress) tab is displayed. -
Under
表示授業(Displayed lectures), select today's class. To view previous sessions' progress alongside, increase the number under前後授業数(Number of surrounding lectures). If you teach multiple groups, useユーザを絞り込む(Filter users) to display only today's group. -
Turn on the
自動更新(約1分ごと)(Auto-refresh, about every minute) switch. The display refreshes approximately every minute. -
If projecting on a classroom screen, check
学生を匿名化(Anonymize students). The columns for students' names and email addresses will no longer be shown.
What to check on the 進捗 tab
| Where to look | What you learn | Description |
|---|---|---|
苦戦中のメンバー (Struggling members, center of screen) | Students who may need to be spoken to, and the reasons | 7-2 |
Progress table for 全てのメンバー (All members, bottom of screen) | Which problem each student has answered correctly up to | 7-1, 7-3 |
Speech bubbles in the AIチャット column | Students currently asking the AI, and trends in their questions | 7-4 |
Speak to students who are individually stuck. If many students are stuck on the same problem or asking the AI the same thing, provide supplementary explanation to the whole class.
- The settings for
ユーザを絞り込む,学生を匿名化, and表示授業are shared between the進捗tab and theつまずき分析tab. - The selected tab and lecture are included in the URL, so you can share or bookmark them as they are.
7-1. How to read progress colors
| Color | Meaning |
|---|---|
| Green | Correct |
| Yellow | Correct after the deadline |
| Red | Incorrect |
| Light green | Correct during review |
| Gray | Not started |
"Review" is a feature, for materials other than exam mode, that lets students re-solve multiple-choice and free-response questions while viewing hints after the final submission deadline (or after submitting all questions, even before the deadline). Correct answers during review do not affect grades, so they are colored differently from correct answers before the deadline.
Clicking a cell opens the list of that student's submissions to that problem, where you can view the submitted code.
If a lecture schedule is set, the display changes depending on when the submission was made.
| Display | Meaning |
|---|---|
| Filled cell | Submitted during lecture hours (worked on during class) |
| Outline only | Submitted outside lecture hours (worked on during self-study or homework) |
7-2. Struggling members
Displays students who may need to be spoken to, along with the reason. Up to 10 students not yet addressed are shown; students you have marked as addressed are displayed in full after them. If a student has multiple reasons, they are combined into one row, and 状況 (Status) shows the basis.
| Reason | Display condition |
|---|---|
| Long stall | Working on a problem not yet answered correctly, right now (within 5 minutes of the last operation). Time spent on that problem is shown in 状況 |
| Repeated errors | 3 or more consecutive incorrect answers on the same problem within the last 15 minutes |
| Requesting answers | 3 or more questions to the AI asking for answers or code within the last 15 minutes |
| Not started | Has neither viewed nor submitted the problems of the displayed lecture (shown at the bottom of the list, since they may be absent) |
For a student you have spoken to, check the box at the start of the row, and they will be shown faintly at the end of the list as addressed.
- The check is cleared when the date changes.
- If a new reason is added after checking, the check is cleared and they return to the prominent display.
7-3. Status per student
In the list of all students, you can check the following columns about the coding problem each student last opened.
| Column | Content |
|---|---|
| Last opened problem | The last problem the student opened |
| Last activity | 学習中 (Studying) if within 5 minutes of the last operation, or the time elapsed since the last operation |
| Status | Whether the student has ever answered that problem correctly (正解, 不正解, 未提出). Once correct, it stays 正解 even if they later answer incorrectly |
| Total time on page | The total time spent with that problem open |
| Hint count | The number of times additional hints were generated for that problem. Displaying error locations alone does not increase it |
| Submission count | The number of submissions for that problem. Clicking it opens the submission list filtered to that student and problem |
Students with many ヒント回数 (hints) or 提出回数 (submissions) but still 不正解 (incorrect) in 状態, or with a long 総滞在時間 (total time), may be stuck.
7-4. Status of AI chat questions
A speech bubble in the AIチャット column indicates that the student has asked the AI questions in this course.
| Display | Meaning |
|---|---|
| Green filled bubble | Last question within 5 minutes |
| Gray outlined bubble | Last question more than 5 minutes ago |
| Number next to bubble | Number of conversations today |
答え要求 with a count | Within the last 15 minutes, there are questions asking for answers or code |
エラー相談 (Error consultation) | Within the last 15 minutes, no questions asking for answers or code, but there are questions about errors |
Clicking a bubble lets you view an overview and the content of today's questions. Clicking 過去の会話を見る (View past conversations) opens the AIチャット tab filtered to that student.
7-5. Run a real-time survey
Who can do this: Instructor (group administrator), setup administrator (organization administrator), material author
During class, you can run a survey on the spot using a material's questions and show the aggregated results to students.
Preparation (before class)
- Open
科目一覧→ target course →編集for the material to use for the survey. - Check
リアルタイムアンケート(Real-time survey) under the提出・試験設定tab and press更新. All questions in the material become available to run as a survey. - For questions with no correct answer (such as questions asking for opinions or impressions), check
リアルタイムアンケートとして扱う(Treat as real-time survey) on the question. Every answer is recorded as correct.
During the survey (in class)
- Ask students to keep the target material screen open. Students who do not have the material screen open will not see the survey.
- On the course page, press
アンケート管理(Survey management) for the target material. - Under
現在接続中の受講者(Currently connected attendees), check the number of students with the material screen open (参加者数, participant count). - Press
アンケート開始(Start survey) on the question to run. The answer screen appears on students' material screens. - When enough answers have been collected, press
アンケート終了(End survey). - To show results to students, press
結果を公開(Publish results). A chart of the aggregated results appears on students' screens. You can revert to unpublished with結果公開を停止(Stop publishing results).
Caution: Pressing
開始前に戻す(Return to before start) deletes all students' answers for that question without a confirmation dialog. Do not press it if you want to keep the results.
- Pressing
アンケート開始ends any other question in the same material that is running a survey. - An ended question cannot be restarted until you press
開始前に戻す. - Only aggregated results are shown to students; for free-text questions, only the number of answers is shown.
- Answers are recorded per student; on the
アンケート管理screen, participants' display names (or "名前なし" (No name) if not set) and email addresses are shown. Be careful when projecting this on a classroom screen. - In materials that use real-time surveys, review is not available.
- When an instructor opens a material with
始める (学生モード), the answer screen appears just as for students, and they are counted as participants. To check results, open it with始める (教員モード).
8. Review after class
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
After class, review what students got stuck on using the つまずき分析 (Stumble analysis) and AIチャット tabs in learning analytics.
8-1. Check trends in questions with stumble analysis
-
Open
学習分析for the course and select theつまずき分析tab. -
Select the lecture to review under
表示授業. -
Press
分析する(Analyze), and the AI groups the questions by topic. -
Press a topic under
質問の多かったトピック(Most-asked topics) to view:- What was not understood
- Hints for the material (AI estimates)
- Students' statements (pressing
会話を開く(Open conversation) opens the details of that conversation)
- The top of the screen shows the number of students who asked questions, the number of questions, the percentage of questions requesting answers or code, and the materials with the most questions.
- Analysis results are saved and displayed the next time. If more questions are added after analysis, they are counted as
未分析(Not analyzed), so press再分析(Re-analyze) as needed. If students whose questions were analyzed fall outside the filter range or conversations are deleted, the previous results are not displayed and you are prompted to再分析. - If fewer than 3 students asked questions, analysis is not performed and only the per-student list is shown.
学習者別(By learner) shows each student's number of questions, questions requesting answers or code, submissions, and correct answers. Pressing a student shows their chronological history of questions and submissions for that lecture.CSVダウンロードlets you save the質問の多かったトピックtable. Students' statements, names, and email addresses are not included.- When having the AI analyze, students' names and email addresses are not passed to it.
8-2. Review AI chat conversations
The AIチャット tab in learning analytics lists conversations between students and the AI, and lets you review each conversation in full.
-
Specify the lecture, material, student, group, question date, and keywords in question text, then press
絞り込む(Filter). -
Select the question of the conversation you want to review from the list. All messages in the conversation are shown in chronological order. Operations where the AI referenced the material can be checked by expanding
AIの操作(AI operations). -
Use
前のチャット(Previous chat) and次のチャット(Next chat) to move to adjacent conversations, andチャット一覧に戻る(Back to chat list) to return to the list.
- Keywords search the text of students' questions. The text of AI responses is not searched.
- Conversations started from the course screen are not linked to a material and are shown as
教材未指定(No material specified).
8-3. Check hint usage
Check the hints that students who used many hints were viewing.
-
In the
全てのメンバーtable of learning analytics, press the提出回数(Submission count) of the student you want to check to open the submission list. -
Open the submission you want to check.
-
Check
最後に閲覧したヒント情報(Last viewed hint information) in the submission details.
8-4. Download progress as CSV
To save students' submission status as CSV for grade aggregation and similar uses:
-
Open
学習分析for the course. The進捗tab is displayed. -
Under
ユーザを絞り込むand表示授業, select the target students and lectures. -
If needed, press the ▼ next to
CSVダウンロードabove全てのメンバー, and choose列(Columns) andオプション(Options). -
Press
CSVダウンロード(Download CSV).
| Selectable item | Content |
|---|---|
列 (Columns) | By default includes ユーザID, メールアドレス, 名前, and 提出/正誤. You can add profile fields such as 所属 and 学籍番号, plus 提出日時 (submission date/time), 提出/ソフト締切前か (submitted before soft deadline), 提出/点数 (score), 提出/優秀作品か (outstanding work), and 提出/ソースコード(1ファイルのみ) (source code, single file only). The score, outstanding work, and source code columns are output only for coding problems |
オプション (Options) | Selecting 平均点・標準偏差を計算する(河原式) (Calculate mean and standard deviation (Kawahara formula)) adds a score column that computes the percentage of TRUE among the output columns on a 100-point scale, along with rows for the mean and standard deviation excluding absent students (those whose score is 0), as formulas. Selecting 最後に提出が締め切られた教材のみ (Only materials whose final submission deadline has passed) outputs only the last one, among the displayed lecture range, of materials whose final submission deadline has passed |
- The column names in row 1 of the CSV are output as English names such as
user_idandemail. - Organization administrators and group administrators are not included in the CSV.
Caution: Even with
学生を匿名化(Anonymize students) enabled, names and email addresses are output as-is in the CSV. Handle with care.
8-5. View submitted code on the leaderboard
Who can do this: Instructor (group administrator), setup administrator (organization administrator), material author
For problems where code readability review is enabled in the material repository, a リーダーボードを見る (View leaderboard) button appears on the problem screen. If this button is absent, it is not available for that problem. The material author decides whether to enable this in the material repository.
Instructors can view the submitted code and evaluations (such as ステップ数 (steps) and 残りの指摘数 (remaining findings)) for all students listed on the leaderboard, even before the deadline. Pressing コードを読む (Read code) opens that student's submitted code. The range visible to students differs from what instructors can see.
9. Grade manually
Who can do this: Instructor (group administrator), setup administrator (organization administrator)
Problems that cannot be graded automatically, such as reports (manually graded problems), are scored and given feedback on the submission details screen. Until graded, students see "手動採点の結果をお待ちください。" (Please wait for manual grading results.). Which problems are manually graded is set by the material author in the material repository and cannot be changed from the instructor's screen.
-
Open
学習分析for the course. If there are submissions requiring manual grading, a notice "手動採点が必要な提出があります。" (There are submissions requiring manual grading.) appears at the top of the screen. -
In the progress table, press a cell showing the pre-grading icon. Manually graded problems appear as wider cells.
-
From the opened submission list, open the submission you want to grade.
-
On the right side of the submission details screen, under
手動採点の結果(Manual grading result), enter the点数(Score). -
As needed, write comments in
フィードバック(Feedback). For especially good submissions, check優秀作品(Outstanding work). -
Press
保存(Save). Once saved, the grading result appears in the student's submission details. -
To move to the next submission to grade, use
次の提出に進む(Go to next submission),同じユーザの次の提出に進む(Go to next submission by the same user), or同じ問題の次の提出に進む(Go to next submission for the same problem). Use学習分析に戻る(Back to learning analytics) to return to the learning analytics screen.
You can also operate with the keyboard.
| Operation | Key |
|---|---|
Move to the 点数 field | Ctrl (Cmd on Mac) + S |
Move to the フィードバック field | Ctrl (Cmd on Mac) + E |
| Save | Ctrl (Cmd on Mac) + Enter |
You can also add scores and feedback in the same fields for automatically graded problems.
10. Troubleshooting
| Symptom | What to check |
|---|---|
| You are not receiving the invitation email | Check your spam folder (sender: no-reply@willbooster.dev). If you cannot find it, tell the setup administrator your email address and ask them to resend the invitation |
グループ管理者向けメニュー or 学習分析 is not displayed on a course | Ask the setup administrator to confirm that you have joined the organization, are a group administrator of the group you teach, and that the course has been added to that group |
| A student says they did not receive the invitation email | Check the student's email address and tell the setup administrator. Resending the invitation is done by the organization administrator |
A course does not appear in a student's 科目一覧 | Check whether the student has been added to the group and whether the course has been added to that group |
| You cannot add a course to a group | Whether it is a course created within your organization or imported from a material repository registered to your organization. Consult the setup administrator for other courses |
The AIチャット button does not appear for students | Check whether the material is in exam mode or the submission opening time has passed. If AI chat is disabled in the material repository, the material author should confirm |
| Students do not appear in learning analytics | Check whether the group the students belong to is selected in ユーザを絞り込む |
A student's name shows as - in learning analytics | The student's profile (name) is not registered. See 6-5. Register student profiles, or ask the setup administrator whether it is registered |
| The profile CSV was saved but not reflected | Check whether the student is in a group you manage and whether the email address is correct. Rows that are out of scope are not reflected without notice |
| You cannot make another instructor a group administrator | Check whether the person has joined the organization. Email addresses of people who have not joined are ignored without an error |
The AIチャット tab does not appear in learning analytics | Check whether you are a member of the organization and a group administrator of a group linked to the course |
| Few AI chat counts in learning analytics, or past questions are not visible | The counts in the progress tab and the bubble list only cover today's conversations. Check the AIチャット tab for past questions |
ヒント回数 does not increase | ヒント回数 counts the number of times additional hints were generated. Displaying error locations alone does not increase it |
A conversation is displayed as 教材未指定 | AI chats started on the course screen are not linked to a material, so they show as 教材未指定 |
Changes made on the material 編集 screen revert | Materials imported from a GitHub material repository are overwritten on re-import. Ask the material author to reflect the changes in the material repository |
A student says there is no 模範解答 tab or model answers are not shown | If the material repository is set not to show model answers, the tab itself is not shown. Even when set to show them, they are not displayed until after the final submission deadline. Ask the material author to check the setting |
Grading results are not displayed (採点結果の表示は無効になっています。 (Display of grading results is disabled.) appears) | The material repository is set not to show grading results. Under this setting, grading results are not shown on the instructor's screen either. Ask the material author to check the setting |
| A student says they cannot copy and paste in the code editor | The material repository is set to prohibit copy and paste. Instructors can copy and paste. Ask the material author to check the setting |
| A real-time survey is not displayed to students | Check whether the students have the target material screen open, and whether they are shown in 現在接続中の受講者 under アンケート管理 |
For anything not covered on this page, you can ask the ChatBot via AIに質問 in the help screen. The ChatBot answers based on the public help and the sample material repository. Login is required to use it.