跳转到内容
JevLogJevLog
原创教程官方文档整理

Jev 首次调用：用一条发布变更练习结构化判断

写出包含 state、model 与 questions 的最小请求，并知道何时交回人工。

适用场景用一条虚构发布变更完成第一次可复核判断

来源 · JevLog 编辑部Beginner12 分钟
开始阅读下一篇 →

用一条虚构发布变更练习 Jev 的 Noul、Choice、Score 判断，并检查返回字段；失败或不确定时交人复核。内容依公开文档整理，非本站实测。

来源 · JevLog 编辑部 · 本站原创

2026-09-22 · 按公开文档重写为「真正用上」首课；非本站实测

背景 / 问题

Section titled “背景 / 问题”

你想先判断一条发布变更是否需复核、该查什么、影响多大。本篇用虚构说明提出三个问题，结果只作审核参考，发布仍走原有审批，示例非本站实测。

开始前

Section titled “开始前”
  • Python 3.10+，安装官方 typesafe-sdk。
  • 真实调用时，将 TYPESAFE_API_KEY 放在服务端环境变量中。

来源

Section titled “来源”

操作步骤

Section titled “操作步骤”

1. 写清一次请求

Section titled “1. 写清一次请求”

把虚构变更说明放进 state；TypeSafeClient 默认使用 jev-latest，再只问发布审查需要的具体问题。

2. 一次问三件事

Section titled “2. 一次问三件事”

跑完后分别读取 noul 概率、choice 和 score。这段代码只打印三项结果供人检查，不会合并代码。

from typesafe_sdk import Choice, Noul, Score, TypeSafeClient


with TypeSafeClient() as client:
    result = client.system_one(
        state="发布变更：登录接口增加令牌校验，并修改失败重试逻辑。",
        questions={
            "needs_review": Noul(instructions="这个变更是否需要额外人工复核？"),
            "review_area": Choice(instructions="优先检查哪一类风险？", criteria={"security": "鉴权与权限", "reliability": "重试与故障", "other": "其他"}),
            "impact": Score(instructions="潜在影响等级？", criteria=["低", "中", "高"]),
        },
    )


print(result.nouls["needs_review"].noul)
print(result.choices["review_area"].choice)
print(result.scores["impact"].score)

3. 检查后再交给发布流程

Section titled “3. 检查后再交给发布流程”

核对字段与预设选项；失败、缺字段或不确定时交人，合并发布仍走原权限、测试和审批。

检查结果

Section titled “检查结果”

你能发出一次三项判断请求，核对结果，并在失败或不确定时转人工复核。

  • 不要把 API Key 放在前端。
  • 判断结果不等于自动合并、发布或改生产数据。

接着看

Section titled “接着看”