メインコンテンツまでスキップ

VideoQ ドキュメント

VideoQ は、受講生の質問に講義動画の内容から自動で回答し、根拠となる場面へ案内するサービスです。講座の運営者や講師が動画を講座にまとめて共有し、受講生が質問して引用された場面へ移動します。

VideoQ を導入する、または最初の変更を進めるときの入口です。まず下の表から使う環境を選びます。すべての設計図を先に読む必要はありません。

導入・開発の入口​

やりたいこと最初に読むページ
まず1台のサーバーでオンプレ版を評価する単一サーバーへの導入
既存の Kubernetes に配置するオンプレ導入と Helm 手順
アプリを変更するためにローカルで動かす開発環境を動かす

単一サーバーで導入・動画処理・Q&A・更新・復旧を試し、処理速度や同時利用の不足が見えた段階で、別サーバーへの分離を検討します。バックアップは評価中も別ホストに保管してください。

AIの仕組みを知る​

AIが回答を作るまででは、一つの質問から検索・根拠の取得・回答・引用元の再生までを追えます。AIが何を読み、過去の会話をどこまで受け取るかも説明しています。

詳しく知りたい場合は、文字起こしとシーン検索、Q&Aのプロンプトと回答の保存へ進んでください。これらの解説は、メニューの「AIの仕組み」にまとめています。

AIの手法と参考文献に、原論文・モデルの公式資料、実装との対応、再利用できるBibTeXをまとめています。

現在は、質問ごとに独立したQ&A・ツールによる情報取得・構造化回答を使います。本文と引用を生成中から配信し、完成した講座の回答を検証後に保存します。回答後のAI採点は行いません。以前のStudyモードとPLOG学習グラフは廃止されています。AIの全体像は、2026-10-31時点の実装と照合した内容です。

初めて参加したら​

次の順に進めると、使い方と実装が結び付きます。

順番読むページここまでできれば次へ
1開発環境を動かすローカルにログインできる
2動画を登録して質問する回答の引用から動画の場面へ戻れる
3コードの場所を知る画面・API・動画処理の担当場所が分かる
4最初の変更を進める小さな変更と、その確認結果をレビューに出せる

文書だけの変更なら、ドキュメントを更新するから始められます。

まず知っておくこと​

  • 動画は1本の教材、講座は質問・共有の対象となる動画のまとまりです。データの関係を見る
  • 画面はReact、APIはHono、時間のかかる動画処理はPythonが担当します。全体像を見る
  • 動画の文字起こし・検索準備は順に進みます。登録直後にすべて使えるわけではありません。状態の意味を見る

作業に合わせて読む​

やりたいことガイド
Moodle などの LMS と接続するLTI 連携
画面・文言・フォームを変える画面を変更する
取得・更新するデータや操作を増やすAPIを変更する
テーブルや列を変更するDBを変更する
文字起こし・索引を変える動画の非同期処理を変更する
変更が正しいか確かめるテストと確認コマンド
起動や動画処理で困っている困ったとき
既存の Kubernetes に導入するオンプレで動かす
LLM・埋め込み・Whisperも社内に置くローカルAI推論

詳しく調べる​

必要になったときに、左の「設計リファレンス」から各図や仕様を参照してください。DBの名前はデータ辞書、略語は用語集で確認できます。