如何使用 Jev

从官方 Playground 到第一次 API 调用,逐步了解 Jev 的 state、Choice、Score、Noul 和生产环境注意事项。

访问方式和价格核实于 2026 年 9 月 21 日

最快的上手方式

访问 TypeSafe API Console,使用 Google 或邮箱登录。Jev 已取消 waitlist,新用户目前获得 5 美元额度。打开官方 Playground,粘贴一段文本作为 state,再添加一个问题。

  • 先用 Noul 判断一个属性是否存在。
  • 再用 Choice 做分类,用 Score 做有序评分。
  • 一次请求只测试少量清晰问题,再逐步增加。

理解一次请求

state 是模型需要判断的上下文;questions 定义允许的输出;model 通常使用 jev-latest。Jev 会读取一次 state,并行评估全部问题。

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "Checkout has failed three times and we are losing sales.",
    "model": "jev-latest",
    "questions": {
      "urgent": {
        "type": "noul",
        "instructions": "The message is urgent"
      }
    }
  }'

把问题写得可判断

  • 把“这个客户怎么样”拆成紧迫度、情绪、主题和路由等原子问题。
  • 在 criteria 中说明边界,避免只有模糊的选项名称。
  • 根据置信度决定自动执行还是交给人工审核。
  • 版本升级后重新验证阈值;生产环境可以固定模型版本。

进入生产环境前

  • 用真实历史数据建立评测集。
  • 记录模型版本、输入、输出和最终业务结果。
  • 对中文任务单独测试准确率,不要直接套用英文结果。
  • 为超时、限流和低置信度准备回退路径。
不要把 API 密钥放在浏览器前端。通过自己的服务端调用 TypeSafe API。

Continue reading

查看真实使用案例

看看 Jev 在完整工作流中负责哪一步。