Skip to content

About

LLM 应用开发基础学习。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

53 Commits

Folders and files

Repository files navigation

llm-app-foundations

从基础 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 test

Poe 已作为开发依赖写入 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.py

Stage 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-output

项目结构

llm-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。

About

LLM 应用开发基础学习。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages