附录 A：关于本文档的说明

A.1 为什么略过某些概念？

本教程专注于 Agent 开发的核心概念，因此略过了以下较抽象的内容：

略过内容	说明
Middleware	较为抽象的概念,限于课程篇幅考量,推荐有余力的学员自学
LangGraph 内部细节	DeepAgent 已经封装好这些复杂性
部署和运维	本教程聚焦于应用开发，非系统运维

我们的原则：先学会使用，再了解原理。如果你想深入了解底层实现，可以参考 LangChain 官方文档。

A.2 教学逻辑

第一讲：FunctionCall（让 LLM 具备"行动能力"）
    ↓
本讲：DeepAgent（让 Agent 具备"思考能力"）
    ├── Planning：任务规划
    ├── Memory：长期记忆
    ├── SubAgent：子代理
    ├── MCP：外部连接
    └── Skill：知识包
    ↓
后续课程：高级主题
    ├── 多 Agent 协作
    ├── 工具调用审核
    └── 生产级部署

---

附录 B：快速参考

文件位置速查表

用途	文件路径
添加 Tool	src/cufel_deepagent/tools/tools.py
配置 MCP	src/cufel_deepagent/mcp/mcp.py
MCP 服务器示例	src/cufel_deepagent/mcp/servers/stock_server.py
运行 Agent	main.py
环境配置	.env
Skill 目录	skills/

常用命令

# 运行 Agent
uv run main.py --interactive

# 调试模式
uv run main.py --run "问题" --debug

# 带对话隔离
uv run main.py --run "问题" -c user_alice

---