🚀 Agent 系统学习 & 项目实践规划

一份为 Java/Go 后端开发者定制的 Agent 入门路线 · 一周 · Python · 火山方舟 Doubao
项目：个人知识管理助手

📖 目录

整体规划
技术选型
一周详细计划
进阶项目方向
常见问题速查
参考资源

整体规划

学习路径分四个阶段，我们的一周计划聚焦在阶段二 + 阶段四（跳过纯理论，边做边学）：

阶段一：基础认知

核心概念：Agent = LLM + 记忆 + 工具 + 规划
经典架构：ReAct、Plan-and-Execute、Reflexion
必读：
- Lilian Weng - LLM Powered Autonomous Agents
- Anthropic - Building effective agents（强烈推荐）

阶段二：核心技术模块

模块	关键内容	Demo
Tool Use	工具 schema、并行调用、错误处理	调用天气 API + 计算器
Prompt 工程	System prompt、Few-shot、CoT	对比不同 prompt 表现
Memory	短期、长期、上下文压缩	用 Chroma 做记事本 Agent
RAG	切分、embedding、检索、rerank	读 PDF 问答 Agent
Planning	ReAct 循环、任务拆解	手写 ReAct loop

⚠️ 先手写一遍 Agent loop，再用框架，否则会停留在"调 API"层面。

阶段三：框架 & 生态（选 1-2 个）

Claude Agent SDK（官方，工程化最好）
LangGraph（图结构编排）
CrewAI / AutoGen（多 Agent 协作）
MCP (Model Context Protocol)：Agent 生态的"USB 接口"

阶段四：项目实践

本周项目：个人知识管理助手 🌟

功能：读入 Markdown / PDF / 网页，回答问题、生成摘要、自动打标签
涉及：RAG + Tool Use + Memory

技术选型

项	选择	理由
语言	Python	Agent 生态 90% 在 Python
LLM	火山方舟 Doubao-1.5-pro	兼容 OpenAI SDK
Embedding	火山方舟 Doubao-embedding	同平台省事
向量库	ChromaDB	本地文件，零部署
框架	先手写，后 LangChain	手写才懂原理
UI	Streamlit	10 行代码起网页

一周详细计划

每天的详细内容有独立页面，点击进入：

Day 1

环境搭建 + LLM 首次调用

跑通火山引擎 API、单轮对话、多轮 Streaming

chunking、embedding、ChromaDB

Thought 显式化、Tavily 兜底、一周复盘

进阶项目方向

项目 B：自动化代码 Review Agent（难度 ⭐⭐⭐）

功能：读 Git diff，检查 bug/风格，生成 review 报告
涉及：Tool Use（读文件、跑测试）+ 多轮推理

项目 C：多 Agent 研究助手（难度 ⭐⭐⭐⭐）

功能：给定问题 → 规划者拆任务 → 搜索者查资料 → 写作者整合 → 校对者审查
涉及：多 Agent 协作 + 工具使用 + 规划

常见问题速查

报错	原因 & 解决
`AuthenticationError`	API Key 不对，检查 .env 是否有空格
`model not found`	应该填 endpoint_id 不是模型名
`Connection error`	网络问题，或 base_url 拼错
`ModuleNotFoundError`	忘了 `source venv/bin/activate`
Token 超限	用摘要压缩历史，或换更大 context 模型