Agent

把 Jev 放进你的 Agent

Jev 不是聊天模型,也不能替换驱动 Agent 的大模型。它是你在决策点调用的那一环:Agent 的代码需要一个带概率、可以直接拿来判断的类型化答案时,就问 Jev。官方文档 Jev with coding agents 也是这么说的。

Jev 适合的三个决策点

  • 工具调用门禁。 有副作用的命令执行前,问一个 Choice:allow、review、block。allow 且置信度高才执行,否则问用户。
  • 分流。 用 Choice 为进来的请求选处理器、模型或团队。加一个 other 选项,让奇怪的输入有地方落。
  • 完成检查。 每一步之后问一个 Noul,比如“上一个工具结果是否满足了用户的请求?”,按概率决定继续还是停。

同一个 state 的多个问题放进一次请求。Jev 只读一次 state 就回答所有问题,比每个问题单独调用更省更快。

一次请求、两个问题(官方 systemone 格式)
{
  "model": "jev-latest",
  "state": {
    "user_goal": "Fix the failing auth test",
    "proposed_tool_call": "bash: git push --force origin main"
  },
  "questions": {
    "gate": {
      "type": "choice",
      "instructions": "Should the agent run proposed_tool_call without asking the user?",
      "criteria": {
        "allow": "Read-only or local and easy to undo",
        "review": "Changes shared state; a human should confirm",
        "block": "Destroys work, history, or data"
      }
    },
    "on_task": {
      "type": "noul",
      "instructions": "Does proposed_tool_call serve user_goal?"
    }
  }
}

把它粘进 Jev Playground,填上你的 key 运行,就能看到真实概率。

三种接入方式

方式适合从这里开始
MCP 服务让 Agent 自己决定什么时候问 Jev(Claude Code、Cursor、Codex)Jev MCP 服务
在代码里用 SDKAgent 循环是你自己写的,要在固定步骤加门禁下面的示例
Skill让你的编码 Agent 帮你写 Jev 集成代码给编码 Agent 的 Jev Skill
用官方 TypeScript SDK 写的工具调用门禁
import { TypeSafeClient, choice, noul } from "@typesafe-ai/sdk";

const jev = new TypeSafeClient(); // TYPESAFE_API_KEY
const GATE_CONFIDENCE = 0.7; // tune on your own traces

export async function gateToolCall(goal: string, call: string) {
  const { answers } = await jev.systemOne({
    state: { user_goal: goal, proposed_tool_call: call },
    questions: {
      gate: choice("Should the agent run proposed_tool_call without asking?", {
        allow: "Read-only or local and easy to undo",
        review: "Changes shared state; a human should confirm",
        block: "Destroys work, history, or data",
      }),
      onTask: noul("Does proposed_tool_call serve user_goal?"),
    },
  });
  if (answers.gate.choice === "block") return "block";
  if (answers.gate.confidence < GATE_CONFIDENCE || answers.onTask.noul < 0.5) return "ask";
  return answers.gate.choice === "allow" ? "run" : "ask";
}

读置信度,在代码里做决定

Choice 和 Score 的回答带 0 到 1 的 confidence。把它当第二条轴:答案告诉你是什么,置信度告诉你能不能只凭它就行动。Noul 没有单独的置信度,概率本身就是信号。

  • 阈值集中放在一个文件里,方便人和问题一起审。
  • 用你自己的真实数据调阈值,别凭一个演示。
  • 阈值调好后固定 jev-1.13.0。jev-latest 会随 TypeSafe 发版变动。
  • 英文是 Jev 最强的语言。中文等其他语言,先用自己的数据测过再信任阈值。

Jev 不做什么

  • 不写文字、代码或解释,只返回类型化答案。
  • 不调用工具、不执行动作,由你的代码根据答案行动。
  • 不能替换 Claude Code、Cursor 或 Codex 背后的模型,编码 Agent 没有 model: "jev-latest" 这种开关。

更多模式:Choice、Score 和 Noul、什么时候不该用 Jev,以及官方的 patterns。