增加每章节 README 文件
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
# 代码开发 Agent
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：掌握仓库级检索 / AST 分块 / 多文件读写 / 沙箱执行，能在真实代码库里改代码。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
掌握仓库级检索 / AST 分块 / 多文件读写 / 沙箱执行，能在真实代码库里改代码。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段四「03_rag_technique」+ 阶段三「02_langgraph_core」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 仓库级检索：全库建索引（按函数 / 类切块）
|
||||
- AST 分块：`ast` 模块按函数 / 类边界切
|
||||
- 多文件读写：diff 预览 + 限根目录
|
||||
- 长上下文管理：符号表常驻 + 按需拉取
|
||||
- 沙箱执行：Docker 隔离跑生成代码
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 用 AST 把一个 Python 文件按函数切块
|
||||
- [ ] 实现一个仓库符号表（函数名 → 文件/行号）
|
||||
- [ ] 实现「定位 → 改 → 跑测试」三步 Agent
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能用 AST 分块实现仓库级检索
|
||||
- [ ] 能管理多文件 diff 与根目录限制
|
||||
- [ ] 能在沙箱中安全执行 Agent 生成的代码
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/01_coding_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# 数据分析 Agent
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：掌握 Text-to-SQL / Schema Prompt / 五道防线，能把自然语言问题翻译成 SQL 并出图。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
掌握 Text-to-SQL / Schema Prompt / 五道防线，能把自然语言问题翻译成 SQL 并出图。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段四「03_rag_technique」+ 阶段一「04_python_core_toolkits」（pandas）。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- Text-to-SQL：Schema Prompt 是第一杠杆
|
||||
- 五道防线：只读账号 / SQL 白名单 / 参数化 / 结果校验 / 报错自修正
|
||||
- 语义层：业务口径沉淀到中间表 / 视图
|
||||
- 图表工具：把查询结果转可视化
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 写一份高质量的 Schema Prompt
|
||||
- [ ] 实现五道防线的 SQL 安全验证
|
||||
- [ ] 让 Agent 自动选择图表类型（柱 / 折线 / 饼）
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能用 Schema Prompt 显著提高 SQL 准确率
|
||||
- [ ] 能落地五道防线防止 SQL 注入与越权
|
||||
- [ ] 能让 Agent 把查询结果转成可视化
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/02_data_analysis_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# 内容创作 Agent
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：掌握多 Agent 写作流水线、风格控制、人工反馈机制。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
掌握多 Agent 写作流水线、风格控制、人工反馈机制。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段三「02_langgraph_core」+ 阶段五「01_multi_agent_systems」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 流水线：策划 → 写作 → 评审 → 校对
|
||||
- 风格控制：Few-shot + System Prompt 约束
|
||||
- 人工反馈：Human-in-the-loop 评审 + 编辑
|
||||
- 多模态扩展：图片 / 表格 / 引用自动配齐
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 搭一个「策划 + 写作 + 评审」三人组
|
||||
- [ ] 加入风格 Few-shot 让 Agent 稳定产出某种文风
|
||||
- [ ] 接入 Human-in-the-loop 审批闸门
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭多 Agent 内容流水线
|
||||
- [ ] 能用风格控制稳定输出
|
||||
- [ ] 能接入人工反馈闭环
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/03_content_creation_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,55 @@
|
||||
# 智能客服与运维 Agent
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：掌握工单 / 知识库 / 多轮上下文 / 升级人工的全链路。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
掌握工单 / 知识库 / 多轮上下文 / 升级人工的全链路。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段四「03_rag_technique」+ 阶段三「02_langgraph_core」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- 工单系统集成：开单 / 关单 / 升级流转
|
||||
- 知识库检索：常见问题自动答
|
||||
- 多轮上下文：会话状态持久化
|
||||
- 升级人工：识别兜不住的问题并转人工
|
||||
- SLA 与响应时效监控
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 实现一个支持多轮对话 + 知识库的客服 Agent
|
||||
- [ ] 为 Agent 加工单开/关工具
|
||||
- [ ] 实现「识别兜不住 → 升级人工」逻辑
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭多轮对话 + 知识库的客服 Agent
|
||||
- [ ] 能集成工单系统
|
||||
- [ ] 能识别兜不住的问题并升级人工
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/04_customer_service_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# 办公自动化 Agent（Agent + RPA）
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：掌握 Agent + RPA 协作、流程编排、审批中断、幂等防重发。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
掌握 Agent + RPA 协作、流程编排、审批中断、幂等防重发。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段三「02_langgraph_core」+ 阶段五「05_safety_and_alignment」。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- Agent 动脑 vs RPA 动手的分工
|
||||
- 流程编排：串行 + 审批 + 分支
|
||||
- 审批中断：LangGraph interrupt
|
||||
- 幂等防重发：不幂等操作必须用幂等键
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 实现一个「报销邮件 → 提取要素 → 校验 → 审批 → 回执」流水线
|
||||
- [ ] 为金额超限分支加 Human-in-the-loop 审批
|
||||
- [ ] 为不幂等操作（发券）设计防重发机制
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭 Agent + RPA 协作的办公自动化流水线
|
||||
- [ ] 能用 interrupt 实现审批中断
|
||||
- [ ] 能为不幂等操作设计幂等键
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/05_office_automation_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
@@ -0,0 +1,54 @@
|
||||
# 阶段六综合实战 · 数据分析 Agent
|
||||
|
||||
> 所属：阶段六 · 垂直领域 Agent 落地实践
|
||||
> 目标：搭建一个支持自然语言查询 + 自动出图 + 报告输出的数据分析 Agent。
|
||||
|
||||
---
|
||||
|
||||
## 📌 学习目的
|
||||
|
||||
搭建一个支持自然语言查询 + 自动出图 + 报告输出的数据分析 Agent。
|
||||
|
||||
## ✅ 学习要求（前置条件）
|
||||
|
||||
已完成阶段六前 5 个小点。
|
||||
|
||||
## 📚 主要学习内容
|
||||
|
||||
- Schema 元数据自动接入
|
||||
- 五道防线保障 SQL 安全
|
||||
- 自动出图（柱 / 折线 / 饼）
|
||||
- 自动写报告（结论 + 数据 + 引用）
|
||||
|
||||
## 📖 对应 docs
|
||||
|
||||
- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
|
||||
- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
|
||||
|
||||
## 🛠️ 建议练习
|
||||
|
||||
- [ ] 为「上季度北京区域销售」自动生成 SQL + 柱状图
|
||||
- [ ] 为 Agent 加自动报告生成（结论 + 数据）
|
||||
- [ ] 用 Ragas 评估 Agent 的查询准确率
|
||||
|
||||
## 🏁 完成后达成标准
|
||||
|
||||
- [ ] 能搭支持自然语言查询 + 自动出图的数据分析 Agent
|
||||
- [ ] 能解释五道防线的关键作用
|
||||
- [ ] 能评估 Agent 的查询质量
|
||||
|
||||
---
|
||||
|
||||
## 🚀 运行提示
|
||||
|
||||
```bash
|
||||
# 激活根目录的虚拟环境
|
||||
cd /Users/jack/source/Demo/py/demo_python_agent
|
||||
source .venv/bin/activate # 或直接用 uv run ...
|
||||
|
||||
# 进入本章目录
|
||||
cd code/006_phase6_vertical_apps/99_capstone_data_analysis_agent
|
||||
|
||||
# 跑你的练习文件
|
||||
uv run python your_exercise.py
|
||||
```
|
||||
Reference in New Issue
Block a user