从基础 API 调用开始,系统掌握 LLM 应用开发基础。
在 PowerShell 中执行:
conda activate llm-app-foundations
python -m pip install --no-user -e ".[dev]"
Copy-Item .env.example .env其中 --no-user 会将依赖安装到当前激活的 Conda 环境,而不是用户级 Python 目录,避免出现包已安装但 poe 命令找不到的情况。
编辑 .env,填入 DEEPSEEK_API_KEY,并按账号可用模型设置 DEEPSEEK_MODEL。.env 只保存在本地,不要提交到 Git。
运行测试:
$env:PYTHONPATH = "src"
python -m unittest discover -s tests -v也可以使用 Poe 运行项目任务:
poe stage0
poe stage4
poe testPoe 已作为开发依赖写入 pyproject.toml;如果当前环境还没有安装,重新执行:
python -m pip install --no-user -e ".[dev]"运行学习示例:
python src/00_hello_llm/main.py
python src/01_basic_call/main.py
python src/02_structured_output/main.py
python src/03_streaming/main.py
python src/04_function_calling/main.py
python src/05_travel_assistant/main.pyStage 2、Stage 3、Stage 4 和 Stage 5 运行前需要在 .env 中配置 DEEPSEEK_API_KEY。
Stage 2 会从电影介绍中提取 MovieInfo;Stage 3 会逐步显示模型回答。
Stage 4 教学版只演示一个工具的两轮闭环:模型请求 get_weather,Python 通过 Open-Meteo 查询真实天气,再把结果交回模型。多工具和通用循环会在后续练习中加入。
Stage 5 V5 在 V4 的基础上加入最终响应 Streaming;第一次请求仍处理多个 Tool Call,第二次请求流式生成 JSON,结束后再校验为结构化的 TravelPlan。错误处理、重试、异步和通用 Agent 循环暂不纳入当前练习。
如果只想练习 Pydantic 的本地校验,不调用 API,可以执行:
$env:PYTHONPATH = "src"
python -c "from importlib import import_module; import_module('02_structured_output.main').runValidationExamples()"安装项目后,也可以通过 console script 运行:
structured-outputllm-app-foundations/
├── docs/
│ ├── NOTES.md # 按阶段记录学习过程
│ └── LEARNING_ROADMAP.md # 完整学习路线
├── src/
│ ├── 00_hello_llm/ # Stage 0:第一次 API 调用
│ │ └── main.py
│ ├── 01_basic_call/ # Stage 1:普通调用与 Prompt
│ │ └── main.py
│ ├── 02_structured_output/ # Stage 2:Structured Output 基础练习
│ │ └── main.py
│ ├── 03_streaming/ # Stage 3:Streaming 流式输出练习
│ │ └── main.py
│ ├── 04_function_calling/ # Stage 4:Function Calling
│ │ ├── main.py # 命令行入口
│ │ ├── weather_tool.py # 通过 Open-Meteo 查询真实天气
│ │ └── tools.py # Tool Schema 与调用闭环
│ ├── 05_travel_assistant/ # Stage 5 V5:多工具与最终响应 Streaming
│ │ ├── main.py
│ │ ├── schemas.py
│ │ ├── travel_data.py
│ │ ├── attractions_tool.py
│ │ ├── foods_tool.py
│ │ └── tools.py
│ ├── client.py # 客户端构造
│ ├── config.py # 配置读取与校验
│ └── entrypoints.py # 模块入口适配
├── tests/ # 单元测试
├── .env.example
└── pyproject.toml
基础调用
→ Prompt
→ Structured Output
→ Streaming
→ Function Calling
→ 综合项目
详细过程记录在 docs/NOTES.md,完整路线见docs/LEARNING_ROADMAP.md。