配方 34 动手实践 18 分钟 更新 2026年11月10日
用 Python 开始使用 Jev(Real Python)
外链 Philipp Acsany 的 Real Python 教程(2026-09-24 更新):用 TypeSafe SDK 和 OpenRouter 把 Python 脚本接到托管 TypeSafe Jev,先用 Noul 替换死板的 Y/N 判断,再在一次请求里同时问 Choice、Score 和 Noul。
这份指南指向哪里
Philipp Acsany 在 Real Python 发布了这篇 Jev 的 Python 入门教程(2026-09-24 更新;Real Python 也在 2026-11-09 于 X 转发)。这是一篇中级、约 18 分钟的教程:先从只接受大写 Y 或 N 的火车站脚本写起,再把访客的回答交给托管 TypeSafe Jev。
文中步骤:
- 项目准备 — Python 3.10+、
uv、typesafe-sdk==0.7.1,以及.env里的 OpenRouter 密钥OPENROUTER_API_KEY。SDK 默认是jev-latest;也可以钉死如jev-1.13的版本。 - 一个 Noul 问题 —
TypeSafeClient的base_url="https://openrouter.ai/api";state只放访客的回答;阈值例如高于 0.8 / 低于 0.2,中间带再问一次。 - 问题措辞 — 文章说明为何 “Is the answer affirmative?” 能处理单独的 “yes”,而 “Did the user lose something?” 可能让短答落在中间带,因为原始问句并没有传给 Jev。
- 一次调用里的 Choice、Score 和 Noul — 把访客分到窗口、给紧急程度打分、判断是否需要协助;然后打印类型化答案(
choice、score、noul),而不是散文。 - 排错 — 缺少
typesafe_sdk、未设置OPENROUTER_API_KEY、密钥或base_url错误导致TypeSafeAuthenticationError、余额不足,以及速率限制。
本页是非官方手册入口——请对照原文与 TypeSafe 文档核实。不要在本页粘贴大段教程代码;打开原文跟着做。
要点
- Jev 返回类型化数字和选项键;下一步动作由你的 Python 代码决定。
- 访客原话进 state,判断标准进问题;除非你也把原问句放进 state,否则不要指望 Jev 看见它。
- 一次
system_one请求可以同时带 Noul、Choice 和 Score。