# agentStudy

**Repository Path**: chenchigitee/agent-study

## Basic Information

- **Project Name**: agentStudy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# agentStudy — Python Agent 学习工作区

面向 **Java 程序员** 的 Python Agent 学习工作区。包含两个子项目和两份独立参考文档，分别承担"学知识点"和"做项目整合"两条学习主线。

## 1. 仓库地图

| 资源 | 类型 | 什么时候看它 |
| --- | --- | --- |
| [`agent-basis.md`](./agent-basis.md) | 理论参考（~50KB） | 想先建立 Agent 概念体系（六代进化史、Agent Loop、ReAct、Context Engineering、Tools 注册、Multi-Agent 协作等）时 |
| [`RAG学习指南.md`](./RAG学习指南.md) | 理论参考（~38KB） | 动手做 RAG 前想先建立知识框架（架构、Chunking、Embedding、进阶 Self-RAG / CRAG / Graph RAG、RAGAS 评估等）时 |
| [`python-learn/`](./python-learn/) | 课程仓库 | 按 Stage A → E 学单项能力：原生 Agent、LangGraph 编排、RAG 基线、MCP 接入、工程化治理；后续继续补充多智能体与 A2A 专题 |
| [`python-agent-project/`](./python-agent-project/) | 整合项目 | 课程过完后，看前面学的能力如何收敛到一个最小 Python Agent 项目（HTTP API + RAG + MCP + 可观测性） |

## 2. 推荐学习路径

### 路径 A：零基础（先理论后实战）

1. 先读 `agent-basis.md`，建立 Agent 概念体系
2. 再读 `RAG学习指南.md`，了解 RAG 是什么、能做什么
3. 进入 `python-learn/`，按 `plan.md` 推进：
   - Python 基础（`docs/02-Python基础语法`）
   - 核心库（`docs/03-核心库`）
   - Agent 开发（`docs/04-Agent开发/stage_a ~ stage_e`）
4. 最后进入 `python-agent-project/`，看能力如何整合到一个最小项目

### 路径 B：有 Python 基础，想先跑通项目

1. 直接进入 `python-agent-project/`：
   - `docs/01-运行与调试.md` → 本地跑起来
   - `docs/02-目录结构说明.md` → 理解工程分层
   - 调用 `/health`、`/agent/ask`、`/rag/ask` 三条接口
2. 遇到不懂的概念回 `python-learn/` 对应 Stage 查
3. 两份顶层 md 当参考手册按需查阅

### 路径 C：只想快速看 RAG 或 Agent 骨架

1. 只读对应主题的顶层 md（`RAG学习指南.md` 或 `agent-basis.md`）建立概念
2. 直接看 `python-agent-project/src/rag/` 或 `python-agent-project/src/agents/` 的实现
3. 想更深入时回 `python-learn/docs/04-Agent开发/stage_c/` 或 `stage_a/` 查对应练习

## 3. 子项目入口

- 课程仓库：[`python-learn/README.md`](./python-learn/README.md) · [`python-learn/plan.md`](./python-learn/plan.md)
- 整合项目：[`python-agent-project/README.md`](./python-agent-project/README.md)

## 4. 环境与工具链

- Python 版本：>= 3.11（各子项目独立配置）
- 包管理：`uv`（每个子项目各自 `uv sync`）
- 两个子项目的 `.venv` 独立，互不干扰
- 顶层工作区没有自己的 `pyproject.toml`，所有命令都在某个子项目目录内执行

各子项目的具体命令请看各自 `README.md` 与 `CLAUDE.md`。

## 5. 一句话总结

**两份 md 建立理论概念 · `python-learn/` 学知识点 · `python-agent-project/` 做项目整合 · 按需组合。**