解答の提出と記録
解答の提出
解答はJSONに変換できる値であれば何でも構いません(最大64KB)。採点はサーバーが教育者の採点設定でリクエスト内で完了し、結果をすぐに返します。
個人情報の禁止
解答に学習者の個人情報(氏名・電話番号・メールアドレス・住所・生年月日・学籍番号・住民登録番号・口座・顔写真・位置情報など、個人を特定できる情報)を入れないでください。提出した解答はサーバーに残り、教育者・運営者が閲覧します。rubric採点の場合は外部のAIモデルにも送られます。学習者を区別するにはsdk.account.anonymousIdを使います。
const { isCorrect, score, answerCorrectness } = await sdk.submit({ q1: 'B', q2: 42 });
// 자동 채점: { isCorrect: true, score: 100, answerCorrectness: [] }
// 채점 안 함: { isCorrect: null, score: null }
// partial_pattern: 답은 문항 순서대로 문자열 배열
await sdk.submit(['Paris', '4', '광합성']);
// { isCorrect: false, score: 30, answerCorrectness: [false, false, true] }
answerCorrectnessはpartial_pattern採点の問題ごとの正誤(answer_keyの順、欠けている解答はfalse)です。pattern・rubric・採点なしの場合は[]です。- 学習画面(
learn・instructor)でのみ呼び出せます。設定画面ではscreen_not_supportedです。 - チューターが呼び出すと
read_only_modeで拒否されます。チューターには提出ボタンを非表示にするか無効にします。 - 科目管理者(教育者)が学習ページで提出すると、採点のみ行い保存しません。
- 編集ページのプレビュー(
isDraft)では、サーバーに送信せず採点を模倣します。
学習完了設定による結果
| 学習完了設定・採点 | submit()の結果 |
|---|---|
on_access(閲覧時に学習完了) | score・isCorrectはnull。初めて開いたときにすでに100点で記録され、提出は記録のみ残る |
on_submit(提出時に学習完了) | すぐに100点 |
on_graded + pattern | すぐに0点または100点 |
on_graded + partial_pattern | すぐに正解した問題の点数の合計(最大100)。100点のときだけisCorrect: trueで完了。解答が文字列の配列でなければ拒否(request_failed、サーバーのコードはcauseに) |
on_graded + rubric(AI採点) | リクエスト内でAIが採点して点数を返す(最大30秒)。AIの呼び出しに失敗すると提出は保存されずexternal_service_error。再提出すればよい |
自由構成学習資料は、教育者による直接 採点と採点なしを使いません。採点設定は資料情報と設定の保存をご覧ください。
満点のお祝いはLXPが表示します
満点のお祝い(ウサギ・サウンド)は、サーバーの点数が変わるとLXPが表示します。コンテンツはsubmit()を呼び出すだけで、お祝い画面を別途作りません。
提出の制限
- 短時間に提出しすぎると(1分あたり30回)
rate_limitedです。 - 解答が64KBを超えると
invalid_inputです。
提出記録
自分の提出記録を新しい順に読み取ります。チューターは、見ている学生の記録を読み取ります。
const submissions = await sdk.history({ offset: 0, limit: 20 });
// [{ id, materialVersionId, accountId, createdAt, answer, isCorrect, score, answerCorrectness }, …]
| フィールド | 説明 |
|---|---|
id | 提出ID |
materialVersionId | 提出時の資料バージョンID |
accountId | 提出したアカウントのID |
createdAt | 提出時刻 |
answer | 提出し た解答 |
isCorrect、score | 採点結果。採点していなければnull |
answerCorrectness | partial_patternの問題ごとの正誤。その他の採点では[]。以前のサーバーは送信しない場合がある |
offsetのデフォルト値は0、limitのデフォルト値は20で、最大100です。
自分の結果
sdk.resultはinit()のときに取得した資料単位の結果です({ score, submitCount, completedAt })。画面と閲覧者をご覧ください。