メインコンテンツへスキップ

8.5.1 プロジェクトロードマップ：引用付き知識助手を作る

このキャップストーンは、知識、モデル呼び出し、アプリケーションフロー、engineering evidence を 1 つの再現可能な LLM アプリに接続できることを示します。

まずプロジェクト証拠ループを見る​

LLM アプリケーション総合プロジェクトのロードマップ

LLM アプリケーションプロジェクトの学習順序図

LLM アプリケーションプロジェクトのデリバリーループ図

プロジェクトは「ベクトルデータベースをつなぐ」だけではありません。文書、chunks、検索、context、回答、引用、logs、評価、改善の traceable loop です。

プロジェクト readiness チェックを動かす​

プロジェクト完了前に、この checklist を使います。

project = {
    "project_type": "knowledge-base assistant",
    "documents": 5,
    "eval_questions": 10,
    "citations": True,
    "empty_retrieval_handled": True,
    "failure_cases": 3,
}

ready = (
    project["documents"] >= 3
    and project["eval_questions"] >= 10
    and project["citations"]
    and project["empty_retrieval_handled"]
    and project["failure_cases"] >= 1
)

print("ready:", ready)
print("project_type:", project["project_type"])
print("evidence:", "docs, eval, citations, failures")

出力：

ready: True
project_type: knowledge-base assistant
evidence: docs, eval, citations, failures

ready が False なら、別の機能を足す前に evidence loop を完成させます。

この順番で学ぶ​

手順プロジェクト本当に鍛える力
1企業またはコース知識ベース検索、権限、引用、traceable answers
2知的アシスタント検索、session state、tool calling を product feature にする
3RAG + 微調整システム知識不足と振る舞い不安定を分ける
4教材生成助手文書解析、構造化出力、template rendering
5フル実践ワークショップ実 API や DB を足す前の最小再現ループ

ガイド付き baseline が必要なら、8.5.6 実践：第 8 章 RAG アプリ完全ワークショップ から始めます。

プロジェクト成果物基準​

成果物最低要件強いポートフォリオ版
README目的、実行コマンド、依存関係、例アーキテクチャ図、設計 trade-off、コスト、振り返りを追加
知識ベースサンプルraw documents、chunks、metadata、source fields権限ルール、document version、更新メモを追加
検索ログmatched passages、scores、rankingfailure type statistics と before/after comparison を追加
回答引用最終回答が支援ソースを表示citation faithfulness checks を追加
失敗ケース少なくとも 1 件の失敗を記録3 件以上の原因、修正、regression check を追加
評価固定質問と pass/fail rulesbaseline、metrics、regression testing を追加
デプロイメモ実行方法と必要な環境変数Docker、monitoring、fallback notes を追加

合格ライン​

引用付き回答、検索ログ表示、empty retrieval 処理、評価ケース保存、少なくとも 1 件の失敗説明ができれば、この章は合格です。

最強のポートフォリオ版は、最大の版ではありません。別の開発者が実行を再現し、証拠を確認し、次の改善方針を理解できる版です。