Agent
把 Jev 放进你的 Agent
Jev 不是聊天模型,也不能替换驱动 Agent 的大模型。它是你在决策点调用的那一环:Agent 的代码需要一个带概率、可以直接拿来判断的类型化答案时,就问 Jev。官方文档 Jev with coding agents 也是这么说的。
Jev 适合的三个决策点
- 工具调用门禁。 有副作用的命令执行前,问一个 Choice:
allow、review、block。allow且置信度高才执行,否则问用户。 - 分流。 用 Choice 为进来的请求选处理器、模型或团队。加一个
other选项,让奇怪的输入有地方落。 - 完成检查。 每一步之后问一个 Noul,比如“上一个工具结果是否满足了用户的请求?”,按概率决定继续还是停。
同一个 state 的多个问题放进一次请求。Jev 只读一次 state 就回答所有问题,比每个问题单独调用更省更快。
{
"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 服务 |
| 在代码里用 SDK | Agent 循环是你自己写的,要在固定步骤加门禁 | 下面的示例 |
| Skill | 让你的编码 Agent 帮你写 Jev 集成代码 | 给编码 Agent 的 Jev Skill |
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。