综合项目

项目页用来把前面的章节串起来。读概念时你会觉得很多东西都懂了，真正做项目时才会遇到状态管理、接口设计、错误处理、引用展示、工具失败这些细节。

建议不要一开始就三个项目同时做。先做聊天助手，把模型调用、流式输出和基础前端体验跑通；再做 RAG 知识库；最后做 Research Agent。这个顺序基本对应应用开发路线从基础到检索再到 Agent 的推进方式。

建议实践顺序

1. AI 聊天助手：适合学完 Prompt、流式输出和最小 API 调用后做。
2. RAG 知识库：适合学完 Embedding、向量数据库和 RAG 原理后做。
3. Research Agent：适合学完 Tool Calling、RAG 和 Agent 基础后做。

每个项目都可以先做最小版本，再补工程化能力。不要一开始就追完整产品，先让主链路跑起来，再加日志、评测、安全和性能优化。

每个项目都要留下什么

项目做完后，不建议只保留代码。你至少应该留下三类材料：

• 一个能复现的启动说明：依赖怎么装、环境变量怎么配、怎么跑起来。
• 一份链路说明：请求从哪里进来，模型看到了什么，结果怎么回到页面。
• 一组失败记录：哪类问题最容易出错，你是怎么定位的。

这些材料会让项目从“我做过一个 demo”变成“我理解这个系统”。面试、复盘和后续扩展时，真正有用的往往就是这些过程证据。

本模块内容

• AI 聊天助手：对话、上下文、流式输出和基础产品体验
• RAG 知识库：文档上传、切块、检索、回答和引用
• Research Agent：搜索、阅读、整理、总结和来源追踪

从项目回到章节

项目卡住时，不要只在代码里绕。可以按问题类型回到对应章节：

• 模型回答不稳定：回看 Prompt 工程 和 Structured Output。
• 知识库答非所问：回看 Embedding 与向量检索 和 RAG 原理。
• Agent 重复调用工具或停不下来：回看 Agent 基础原理 和 可观测性与日志。