COOLJEV / PRACTICAL GUIDE

Jev 入门教程：跑通第一个判断流程

下载 Python 案例，解压后在包含 examples/ 的目录打开终端。建议使用 Python 3.10 及以上；案例只依赖标准库。

python3 -m examples.hello_jev tickets --mode offline --output examples/output/first-ticket.json

刚才实际运行了什么？

离线模式回放人工编写的响应，不调用 API，也不需要账号。打开 JSON 报告，查看 evidence、逐条记录和 summary。退出成功只说明报告已写入，不表示每条记录都通过。工单集包含付款与登录混合问题、信息不清的请求，以及在本地直接拒绝的空记录。

先理解一个判断，再增加问题

原文放进 state，命名的 questions 分别描述部门、影响程度和是否有多个问题。官方 API 支持 choice、score、noul；问题设计章节解释各自用途。部门归属需要你定义业务规则，不能让模型临时编造。

首次离线运行先不要改输入。夹具包含原文与问题的指纹，修改后不能沿用原响应。编辑夹具只能演示程序流程，不能验证模型。

明确切换到真实请求

取得 TypeSafe 访问权限，按下载包 README 的隐藏输入方法在本地设置 TYPESAFE_API_KEY。程序不会自动读取 .env。然后运行：

python3 -m examples.hello_jev tickets --mode live --output examples/output/first-ticket-live.json

这会将符合条件的工单发送给 TypeSafe，并可能产生 API 费用。不要公开密钥或客户记录。检查返回的模型版本、用量、错误与复核原因。下载客户端不自动重试，重新运行可能再次计费。

第一次改造应该做什么？

先写清两个部门与兜底部门，人工标注代表性工单，约定混合问题由谁复核。修改判断标准后，用未参与调整的样本验证。先让人检查建议，再接入自动分派。请求字段与错误以官方 API 文档为准。

由 CoolJev 独立编写。资料核查与更新：2026-09-24