配方 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。

文中步骤:

  1. 项目准备 — Python 3.10+、uv、typesafe-sdk==0.7.1,以及 .env 里的 OpenRouter 密钥 OPENROUTER_API_KEY。SDK 默认是 jev-latest;也可以钉死如 jev-1.13 的版本。
  2. 一个 Noul 问题 — TypeSafeClient 的 base_url="https://openrouter.ai/api";state 只放访客的回答;阈值例如高于 0.8 / 低于 0.2,中间带再问一次。
  3. 问题措辞 — 文章说明为何 “Is the answer affirmative?” 能处理单独的 “yes”,而 “Did the user lose something?” 可能让短答落在中间带,因为原始问句并没有传给 Jev。
  4. 一次调用里的 Choice、Score 和 Noul — 把访客分到窗口、给紧急程度打分、判断是否需要协助;然后打印类型化答案(choice、score、noul),而不是散文。
  5. 排错 — 缺少 typesafe_sdk、未设置 OPENROUTER_API_KEY、密钥或 base_url 错误导致 TypeSafeAuthenticationError、余额不足,以及速率限制。

本页是非官方手册入口——请对照原文与 TypeSafe 文档核实。不要在本页粘贴大段教程代码;打开原文跟着做。

要点

  1. Jev 返回类型化数字和选项键;下一步动作由你的 Python 代码决定。
  2. 访客原话进 state,判断标准进问题;除非你也把原问句放进 state,否则不要指望 Jev 看见它。
  3. 一次 system_one 请求可以同时带 Noul、Choice 和 Score。

来源