增加每章节 README 文件
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# Level 1 · ReAct 智能问答 Agent
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：最小可行 Agent：单智能体 + 1~2 个工具，能跑通 ReAct 主循环。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
最小可行 Agent：单智能体 + 1~2 个工具，能跑通 ReAct 主循环。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段二 + 阶段三「01_langchain_basics」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 单智能体 + ReAct 主循环
|
||||
- 1~2 个工具（如搜索 + 计算）
|
||||
- FastAPI 暴露 + Streamlit 前端
|
||||
- Mock LLM 演示，不需要真实 API Key
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 搭一个支持「查 + 算」二语工具的 ReAct Agent
|
||||
- [ ] 用 FastAPI + SSE 暴露为 Web 服务
|
||||
- [ ] 用 Streamlit 做一个简单聊天前端
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能用 ReAct 跑通最小 Agent
|
||||
- [ ] 能用 FastAPI + Streamlit 暴露为 Web
|
||||
- [ ] 能解释主循环的每一步
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/01_level1_react_qa_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# Level 2 · 知识库 RAG Agent
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：在 Level 1 基础上加知识库检索能力，能基于 RAG 做企业内问答。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
在 Level 1 基础上加知识库检索能力，能基于 RAG 做企业内问答。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成 Level 1 + 阶段四「03_rag_technique」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 向量库接入（Chroma / Qdrant）
|
||||
- 文档加载 → 清洗 → 分块 → 向量化
|
||||
- RAG 检索 + 引用溯源
|
||||
- Agent-RAG：把 kb_search 接入主循环
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 为 Agent 接入一份公司制度文档知识库
|
||||
- [ ] 实现带引用溯源的 RAG 问答
|
||||
- [ ] 对比普通 RAG vs Agent-RAG 的差异
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭一个支持 RAG 的 Agent
|
||||
- [ ] 能解释 RAG 七环节 + 每环节的故障排查
|
||||
- [ ] 能区分普通 RAG vs Agent-RAG
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/02_level2_rag_knowledge_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# Level 3 · 多角色内容创作团队
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：在 Level 2 基础上做多 Agent 协作，覆盖内容创作全流程。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
在 Level 2 基础上做多 Agent 协作，覆盖内容创作全流程。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成 Level 2 + 阶段五「01_multi_agent_systems」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 角色化分工：策划 / 写作 / 评审 / 校对
|
||||
- 多智能体协作（流水线 / 分层管控）
|
||||
- 风格控制 + Few-shot
|
||||
- 内容追踪 / 反馈 / 迭代
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 搭一个「策划 + 写作 + 评审」三人组
|
||||
- [ ] 为流水线加入风格 Few-shot
|
||||
- [ ] 用 Ragas 评估内容质量
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭多角色内容创作流水线
|
||||
- [ ] 能用风格控制稳定输出
|
||||
- [ ] 能用评估闭环迭代内容质量
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/03_level3_multi_role_creator
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# Level 4 · 数据分析 Agent
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：在 Level 3 基础上加 Text-to-SQL，让 Agent 能基于数据库做交互式查询。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
在 Level 3 基础上加 Text-to-SQL，让 Agent 能基于数据库做交互式查询。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成 Level 3 + 阶段六「02_data_analysis_agent」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- Schema Prompt 自动生成
|
||||
- 五道防线保障 SQL 安全
|
||||
- 查询结果自动可视化（柱 / 折线 / 饼）
|
||||
- 自动写报告（结论 + 数据 + 引用）
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 为一份示例数据库写 Schema Prompt
|
||||
- [ ] 实现五道防线的 SQL 安全验证
|
||||
- [ ] 让 Agent 自动选择图表并出报告
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭一个支持自然语言查询的数据分析 Agent
|
||||
- [ ] 能落地五道防线
|
||||
- [ ] 能让 Agent 自动出图与报告
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/04_level4_data_analysis_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,56 @@
|
||||
# Level 5 · 企业智能客服 Agent
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：完整的企业级客服系统，覆盖多租户 / 工单 / 知识库 / 升级人工的全链路。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
完整的企业级客服系统，覆盖多租户 / 工单 / 知识库 / 升级人工的全链路。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成 Level 4 + 阶段六「04_customer_service_agent」+ 阶段七前 3 个小点。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 多租户隔离：tenant_id 索引 / 检索过滤
|
||||
- 工单系统集成：开 / 关 / 升级流转
|
||||
- 知识库 + RAG + 多轮上下文
|
||||
- 升级人工 + Human-in-the-loop 审批
|
||||
- 全链路可观测（LangSmith / Langfuse）
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 搭一个支持多租户的客服 Agent
|
||||
- [ ] 为 Agent 接入工单系统
|
||||
- [ ] 为 Agent 接入 LangSmith / Langfuse
|
||||
- [ ] 为 Agent 加 SLA 与响应时效监控
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭企业级智能客服系统
|
||||
- [ ] 能落地多租户 + 工单 + 升级人工
|
||||
- [ ] 能用全链路可观测驱动迭代
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/05_level5_enterprise_cs_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# 阶段八综合实战 · 五级项目路线导航
|
||||
|
||||
> 所属：阶段八 · 实战项目路线（Level 1~5）
|
||||
> 目标：用代码 / CLI 把 Level 1~5 五级项目的递进关系、能力覆盖、进度跟踪、排期映射串起来。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
用代码 / CLI 把 Level 1~5 五级项目的递进关系、能力覆盖、进度跟踪、排期映射串起来。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段八前 5 个 Level。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 五级项目递进关系图
|
||||
- 能力覆盖矩阵（每级覆盖了哪些阶段能力）
|
||||
- 进度跟踪：每级的「自检」与「达成标准」
|
||||
- 排期映射：每级与 16 周学习计划的对应
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/08-阶段八-实战项目路线/`](../../docs/08-阶段八-实战项目路线/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 用 Python 写一个项目路线导航器（CLI / Web）
|
||||
- [ ] 为导航器加进度跟踪（哪些 Level 已完成）
|
||||
- [ ] 为导航器加排期映射（剩余多少周）
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能用代码呈现五级项目的递进关系
|
||||
- [ ] 能用工具跟踪学习进度
|
||||
- [ ] 能用工具评估学习投入产出
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/008_phase8_projects/99_capstone_project_roadmap
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
Reference in New Issue
Block a user