如何将 Jev 接入 Grok Bot：我构建的最佳 Agent

1from typesafe_sdk import Choice, TypeSafeClient
2
3with TypeSafeClient(model="jev-latest") as client:   # 读取 TYPESAFE_API_KEY
4    r = client.system_one(
5        state=f"goal: {goal}\ntask: {task_type}\nlast error: {err} x{repeats}",
6        questions={
7            "action": Choice(
8                instructions="Agent 下一步该做什么",
9                criteria={
10                    "proceed": "没有任何迹象表明下一步会失败",
11                    "reuse_cache": "已经存在这个任务的新产物",
12                    "stop_retry": "同样的方法以同样的方式失败了",
13                    "research_capped": "已经收集了足够的资料源",
14                    "ask_human": "这一步涉及发送、发布、付款或删除",
15                },
16            )
17        },
18    )
19
20print(r.choices["action"].choice, r.choices["action"].confidence)

1我需要给你一个 TypeSafe 的 API 凭证。用带掩码的密钥请求流程，不要走聊天。
2这个值必须落到你电脑上的环境变量 TYPESAFE_API_KEY 里，而且不能出现在你创建的任何文件、
3日志、skill 或代码仓库中。只需要向我确认变量已设置且可读，绝对不要告诉我它的值。

1在你的电脑上运行：pip install typesafe-sdk
2
3然后写一个 /work/jev/smoke.py，打开 TypeSafeClient(model="jev-latest")，
4发一次 system_one 调用，里面只带一个 Choice 问题。State 为：
5"goal: file a support ticket. task: routing. last error: none x0"。
6Criteria：billing、technical、sales。
7
8跑一下，把原始响应对象给我看：choice、probabilities 和 confidence。
9如果 TYPESAFE_API_KEY 缺失，就停下来告诉我，不要硬编码任何东西。

1在 /work/jev/router.py 建一个路由模块，里面只有一个函数：
2
3    route(goal: str, task_type: str, last_error: str, repeats: int) -> dict
4
5它把这四个字段原封不动作为 state 发给 Jev，附带一个名为 "action" 的 Choice
6问题，criteria 如下：
7
8  proceed          没有任何迹象表明下一步会失败
9  reuse_cache      已经存在这个任务的新产物
10  stop_retry       同样的方法以同样的方式失败了
11  research_capped  已经收集了足够的资料源
12  ask_human        这一步涉及发送、发布、付款或删除
13
14返回 choice、confidence 和 probabilities。把每次调用追加写入
15/work/jev/decisions.jsonl，带上时间戳、四个输入和完整响应。
16从 /work/jev/config.json 读取行为配置，包含两个键：
17"enabled" 和 "mode"（"shadow" 或 "active"）。默认 enabled 为 false。
18
19state 里除了这四个字段不要有任何 prompt 文本。运行前先让我看一下文件内容。

1创建一个叫 jev-usage-router 的 skill。
2
3触发时机：在任何浏览器会话之前、任何一轮调研之前、任何失败步骤重试之前，
4以及启动额外 bot 之前。
5
6步骤：用当前 goal、task type、上一次错误的文本以及重复次数，
7调用 /work/jev/router.py 里的 route()。
8然后按 action 执行：
9
10  proceed          按计划继续
11  reuse_cache      用已有的产物，跳过这步工作
12  stop_retry       放弃这个方法，并报告原因
13  research_capped  最多查 5 个资料源，然后把已有内容整理出来
14  ask_human        暂停并问我，不要自己往下走
15
16审批边界：无论置信度多高，ask_human 都不能被覆盖。
17输出：在运行报告里，每个决策占一行。

1把 /work/jev/config.json 设成 {"enabled": true, "mode": "shadow"}。
2
3在 shadow 模式下，每个触发点都调用路由器并记录决策，但随后忽略它，
4照你原本的方式做。不要改变你的工作方式。
5
6每天结束时，往 /work/jev/report.md 追加：调用次数、
7各 action 的分布、平均置信度，以及所有记录的 action 与你实际做法不一致的情况。

1把 mode 改成 "active"。从现在起，按 action 执行，而不是只记录。
2
3我随时能用两个紧急停止开关：
4  1. 在任何消息里说 "bypass jev"，这次运行就跳过路由器
5  2. 在 config.json 里设 {"enabled": false}，彻底关掉它
6
7ask_human 依然会暂停等我。decisions.jsonl 照旧写。