AIを使った一問一答アプリの作り方|問題の確認からPythonの実装まで
覚えたい用語を、自分用の一問一答アプリで確認したい。AIに問題やコードを作ってもらえれば、プログラミングの練習と勉強を組み合わせられそうだと感じる方もいるのではないでしょうか。
最初に作るなら、AIで問題の下書きを作り、人が確認した問題だけをアプリに登録する方法から始めましょう。出題のたびにAIを呼び出す機能まで、最初から実装する必要はありません。
この記事では、問題の準備、AIへの依頼、内容の確認、Pythonによる出題と答え合わせまでを紹介します。掲載するプログラムは、外部APIや追加ライブラリを使わず、登録済みの3問を順番に出題する学習用の例です。
目次
1.AIを使う場所と、アプリが担当する処理を分ける
「AIを使ってアプリを作ること」と「アプリの実行中にAIを呼び出すこと」は別です。まずは、どの作業をAIに手伝ってもらうかを決めましょう。
| 段階 | AIに依頼できること | 自分で確認すること |
|---|---|---|
| 教材の準備 | 学習範囲から問題・正答・解説の下書きを作る | 出典との一致、問題文の条件、正答の妥当性 |
| アプリの開発 | コードや修正案を作る、処理を説明する | 仕様どおりに動くか、変更理由を理解できるか |
| アプリの利用 | 必要に応じて、問題生成や回答へのコメントを行う | 生成結果の確認方法、費用、失敗時の対応 |
この記事では、最初の2段階でAIを補助に使う構成を扱います。アプリの利用中は登録した問題を出題するため、AIサービスへの通信は発生しません。
この構成なら、問題の内容と、アプリの動作を分けて確認できます。学習用の試作では、まず「確認済みの問題を正しく表示できるか」を確かめるところから進めましょう。
2.最初に、学習範囲と答え方を決める
問題を作る前に、対象者、学習範囲、解答形式を決めます。「情報の問題を作る」より、「Web制作を始めた人が、HTML・CSS・JavaScriptの役割を答える」のように絞ると、確認すべき内容が明確になります。
今回は、短い用語を入力する一問一答形式を使います。選択肢から選ぶ問題や、長い文章を説明する問題では、問題の作り方と判定方法を別に考える必要があります。
| 決めること | 今回の例 |
|---|---|
| 対象者 | Web制作を学び始めた人 |
| 範囲 | HTML・CSS・JavaScriptの基本的な役割 |
| 問題数 | まずは3問 |
| 答え方 | 用語を文字で入力する |
| 答え合わせ | 登録した正答候補と比較する |
| 表示する情報 | 判定結果、正答例、短い解説 |
資料は、入力してよい範囲を確認する
問題の根拠には、教科書、公式ドキュメント、自分で作成した学習メモなどを使います。ただし、手元にある資料を、そのまま外部AIへ送信してよいとは限りません。
学校や職場の利用ルール、資料やサービスの利用条件を確認してください。学習者の氏名・成績・相談内容など、問題作成に不要な情報は含めず、必要な範囲に絞って準備します。
3.AIには、問題と一緒に確認の根拠を出してもらう
AIへの依頼では、問題数や対象者に加え、何を根拠に作るかを指定します。正答だけでなく、資料のどの部分に基づく問題なのかも出してもらうと、人が照合する際の手掛かりになります。
次のテンプレートは、問題の下書きを作るための例です。AIが示した根拠も正しいとは限らないため、元の資料と照合する工程を残してください。
「難易度を指定した」だけでは、適切な問題とは限らない
「初心者向け」「高校生向け」と伝えても、学習者に合った問題が必ず生成されるわけではありません。使っている用語が既習か、問題文から何を答えるか分かるか、必要な条件がそろっているかを確認します。
実際に解いてもらえる場合は、正答率だけでなく、どこで迷ったかも聞いてください。難しい問題なのか、聞き方が曖昧な問題なのかを分けて考えることが大切です。
4.生成された問題は、登録前に点検する
AIが問題と解答をセットで出していても、内容の正しさが保証されるわけではありません。同じAIに「間違いはないか」と聞くことも補助にはなりますが、それだけで確認を終えないようにします。
| 点検する項目 | 確認する内容 |
|---|---|
| 正答 | 資料の説明と一致しているか |
| 問題文 | 答える対象や条件が明確か |
| 別解・表記 | 略称や日本語表記も正答になるか |
| 解説 | 正答の理由を説明し、根拠のない情報を足していないか |
| 重複 | 同じ内容を言い換えただけの問題が偏っていないか |
| 出典 | 参照した資料と、その箇所を確認できるか |
例えば、「Webページを作る言語は?」では、HTMLだけを正答にするには聞き方が広すぎます。「見出しや段落などの構造を記述するマークアップ言語は?」とすれば、確認したい知識を絞れます。
問題を大量に増やす前に、少数の問題で確認方法を決めましょう。「下書き」「確認済み」「修正中」などの状態を区別し、未確認の問題を学習用の出題に混ぜないようにします。
JSONで読み込めることと、内容が正しいことは別
問題数が増えると、JSONなどの形式で問題データを管理する方法があります。問題文、正答、解説を別の項目として保存すれば、プログラムから取り出しやすくなります。
ただし、「JSON形式で出して」と依頼しても、常にそのまま解析できるとは限りません。また、解析できた場合も、必須項目、データ型、空欄、重複、内容の正しさを別に確認する必要があります。
5.Pythonで3問の一問一答アプリを作る
ここからは、問題を表示し、入力した答えと登録した正答を比較するプログラムを作ります。今回は問題データもPythonファイルの中に書くため、JSONファイルの準備や外部サービスの登録は不要です。
Python 3を実行できる環境で、次のコードを「quiz.py」という名前で、UTF-8のテキストとして保存してください。コード全体を1つのファイルに入れ、行頭のインデントも保ちます。
保存したファイルを実行する
quiz.pyを保存したフォルダでターミナルを開き、次のコマンドを実行します。1問ずつ答えを入力し、Enterキーで確定してください。
環境によっては、pythonの代わりにpython3やpyでPython 3を起動します。「コマンドが見つからない」と表示された場合は、Pythonのインストールと、その環境での起動方法を確認してください。
このプログラムは、ターミナル上で動く学習用の例です。Webページとして公開する機能、学習履歴の保存、利用中のAI呼び出しは含みません。終了すると、今回の入力や得点はファイルには保存されません。
環境準備や、AIへの開発依頼から確認したい方へ。小さな機能を作り、動作確認から公開へ進む学習手順を紹介しています。
プログラミング未経験から始めるAI開発|環境構築・アプリ作成・公開の学習手順 記事を読む →6.答え合わせの仕組みと、判定できない範囲を知る
このプログラムは、回答の意味を理解して採点しているわけではありません。入力された文字列を、登録済みの正答候補と比較しています。
strip()で回答の前後の空白を除き、casefold()で大文字・小文字の違いを吸収しています。そのため、HTMLとhtmlは一致します。また、JavaScriptの問題にはJSも登録しているため、どちらでも正答として扱います。
| 入力例 | 今回の処理 |
|---|---|
| html | HTMLと一致する |
| 前後に空白のあるHTML | 前後の空白を除いて比較する |
| JS | 登録した別表記として一致する |
| HTML | 全角から半角への変換はしていないため、一致しない |
| JavaScriptです | 文章としての意味は判定しないため、一致しない |
| 空欄・空白のみ | 次の問題へ進まず、再入力を求める |
表記を柔軟に扱いたい場合は、別表記を追加する、文字を正規化するなどの変更が考えられます。ただし、プログラミング言語の識別子など、大文字・小文字に意味がある問題では、同じ処理を無条件に適用してはいけません。
登録した正答と一致しなかった回答も、人が見れば正しい場合があります。そのため、この例では不一致時に「登録した正答と一致しません」と表示し、正答例と解説を確認できる形にしています。
動作確認では、正解以外も入力する
掲載コードは、Python 3.12.14で、正答・誤答・空欄後の再入力・大文字小文字・別表記・全角入力の扱いを確認しています。自分で問題や処理を変更した後も、同じ観点で確かめてください。
- 登録した正答を入力すると、一致として数えられるか。
- 違う答えを入力すると、正答例と解説が表示されるか。
- 空欄のまま確定しても、問題を飛ばさないか。
- 3問が終わったとき、結果の件数が合っているか。
- 正しい別表記を、不一致として扱っていないか。
AIに機能追加や修正を依頼した後は、変更理由と動作を確認しましょう。生成されたコードを採用する前のレビュー手順を整理しています。
AI生成コードのレビュー方法|仕様・テスト・保守性を確認する実践手順 記事を読む →7.学習では、正答数だけでなく理由も確認する
一問一答は、答えを見る前に思い出す機会を作れます。RoedigerとKarpickeの文章学習の研究では、学習直後の成績と、時間を空けた後の成績で、再読と想起テストの効果が異なることが示されています。
ただし、この研究から、特定のAIアプリを使えば必ず学習効果が高まるとは言えません。問題の内容、答え合わせ、復習の方法を含めて考える必要があります。
今回のアプリで正答できたら、「HTMLとCSSの役割はどう違うか」「このページの色を変えるなら、何を使うか」など、説明や具体例でも確認してみましょう。用語を答えられることと、実際の場面で使い分けられることは同じではありません。
復習に使うなら、間違い方を記録する
| 今回の状態 | 確認すること | 次の行動 |
|---|---|---|
| 用語を思い出せなかった | 意味と用語の対応 | 解説を読み、時間を空けて再確認する |
| 似た用語と取り違えた | 両者の役割の違い | 比較表や具体例で説明する |
| 正しい別表記が不一致になった | 問題文と正答候補の設定 | 教材・判定処理を見直す |
| 用語は正答したが説明できない | 意味や使用場面 | 説明問題や実際の操作に取り組む |
得点は、今回出した問題と判定方法に対する結果です。「3問すべて正解したから、Web制作を完全に理解した」とは判断せず、問題や条件を変えたときにも説明できるかを確かめましょう。
8.AIのAPIを組み込むのは、確認方法を決めてから
アプリ内で新しい問題を生成したい場合は、後から生成AIのAPIを組み込む方法があります。その際も、生成した問題をすぐ出題するのか、確認用の画面に保存するのかを先に決めてください。
例えば、教材作成者向けの画面で問題を生成し、確認済みのものだけを学習者へ出題する構成なら、出題内容を管理しやすくなります。自動生成・自動採点・難易度調整は別々の機能として検討しましょう。
- 出力の検証:必要な項目やデータ型を確認し、不足する問題は採用しない。
- 教材の確認:正答・解説・出典を点検し、未確認の問題を区別する。
- 費用の管理:モデル、入力と出力の量、呼び出し回数などから見積もる。
- 回数の制限:連打や無制限の再試行で、呼び出しが増え続けないようにする。
- 秘密情報の管理:APIキーをブラウザへ配信するコードや公開ファイルに含めない。
- 失敗時の対応:生成に失敗した場合に、未完成の問題を表示せず、状況を知らせる。
費用は利用条件によって変わるため、「個人利用なら月に数十円から数百円」と一律には言えません。また、予算通知が出ることと、リクエストが停止することは別です。利用するサービスの設定を確認し、アプリ側でも利用量を制御してください。
9.よくある質問
プログラミング未経験でも取り組めますか?
小さな例から取り組めます。まずは掲載コードの問題文を1つ変え、実行結果が変わるか確かめてください。分からない処理をAIに説明してもらう場合も、実際の動作と照らし合わせながら理解を進めましょう。
このアプリを動かすために、AIのAPI契約は必要ですか?
掲載したPythonコードには、AIのAPI契約は不要です。問題の下書きやコードの相談にAIサービスを使う場合は、そのサービスの利用条件が別に適用されます。
英語や歴史の学習にも使えますか?
問題データを変更すれば使えます。ただし、英単語の意味や歴史上の用語には、複数の適切な答えがある場合があります。対象範囲と正答候補を確認し、長い記述回答を単純な文字列比較だけで採点しないようにしてください。
AIに採点を任せれば、表記の違いは解決しますか?
意味を考慮した判定を補助できる場合はありますが、採点の誤りや一貫性の問題がなくなるわけではありません。採点基準と確認用の回答例を用意し、学習者が結果を確認・訂正できる仕組みも検討してください。
10.まずは3問を作り、教材と動作の両方を確かめる
最初の目標は、問題を大量に生成することではなく、少数の問題について「内容が正しい」「意図した方法で出題・判定できる」と確認することです。確認できた範囲から、問題数や機能を増やしていきましょう。
まず、掲載した3問を実行し、1問を自分の学習テーマに置き換えてみてください。資料との照合、正答候補の設定、動作確認まで行うことで、教材づくりとプログラミングの両方を練習できます。
参考資料
- Python公式ドキュメント:組み込み関数
- Python公式ドキュメント:JSONエンコーダーとデコーダー
- MDN:HTML ― コンテンツの作成
- Roediger・Karpicke(2006):Test-Enhanced Learning
Learning Tools
記事を検索したい方はここから!
記事を検索
関連記事や、今の内容に近いテーマをすぐに検索できます。
例: AI / 情報Ⅰ / Python / 統計 / 資格 / 学習法