# Jev 项目接入：编程助手接入提示词与 TypeSafe 代码迁移

Source: https://ofox.ai/zh/docs/develop/models/jev/assistant

提供两种接入方式：由编程助手按需求将 Jev 接入项目；或在已有 TypeSafe 代码的项目中，仅修改两个环境变量。

## 通过编程助手接入
使用 Claude Code、Cursor、Codex 等编程助手时，复制以下提示词并将 `【】` 中的内容替换为实际需求，编程助手将在项目中完成接入。

**把 Jev 接进我的项目**

```text
我想在当前项目里接入 OfoxAI 的 Jev 判断模型。我已经在 OfoxAI 控制台创建好了 API Key。请一步步带我做，每一步先告诉我你在做什么、下一步是什么。

【第一步：安全地保存 Key】
1. 在项目里创建 .env 文件，写入一行 OFOX_API_KEY=，等号后面留空；把 .env 加进 .gitignore。
2. 告诉我这个文件在哪，让我自己把 Key 粘贴进去并保存。不要让我把 Key 发在对话里，也不要把 Key 写进代码或打印出来。
3. 等我告诉你「填好了」再继续。

【第二步：我要做的判断】
- 要判断的内容：【例如：用户提交的客服工单文本】
- 要回答的问题：【例如：应该分给哪个团队（扣款与退款 / 技术故障 / 售前咨询）；是否紧急】
- 拿到结果后要做什么：【例如：置信度够高就自动分配，否则转人工】

【第三步：写代码】
4. 用 OpenAI 官方 SDK（先执行 pip install -U openai，旧版本没有 client.decisions），base_url 为 https://api.ofox.ai/v1，Key 从 .env 的 OFOX_API_KEY 读取，调用 client.decisions.create()，模型用 typesafe/jev-latest。
5. 按我的需求选问题类型：是或不是用 predicate；从几个选项里选一个用 choice；程度高低用 score。所有问题放在同一个请求的 questions 数组里，每个问题都写 name。
6. choice 的选项必须覆盖所有情况，并加一个「以上都不是」的选项；每个选项都写 description。
7. 结果按 name 读取。choice 和 score 用 confidence 判断是否自动执行，predicate 用 probability；阈值先设为 0.7，写成配置项，方便以后调整。低于阈值的走人工或兜底流程。
8. 字段与报错以 https://ofox.ai/zh/docs/api/decisions 为准，用法参考 https://ofox.ai/zh/docs/develop/models/jev 。

【第四步：测试】
9. 用 3 条明显的样例和 2 条模棱两可的样例各跑一次，把每条的答案、概率和置信度列给我看。
10. 出错时打印 HTTP 状态码、error.message 和 request_id，对照文档的报错表只改一处再试；同一个错误改两次还没解决，就停下来把报错原文和 request_id 给我。
```

## 从 TypeSafe 迁移
已使用 TypeSafe 官方 SDK，或参照 TypeSafe 官方文档编写代码的项目，仅需将 base URL 改为 `https://api.ofox.ai/typesafe`，并将 API Key 替换为 OfoxAI 的 Key：

```bash filename="Terminal"
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"
```

请求将发送至 `/typesafe/v1/systemone`，格式与 TypeSafe 官方一致（`state` 与以问题 ID 为键的 `questions`，是非问题类型为 `noul`）。两种格式的对照与 SDK 示例见 [Decisions API · TypeSafe 原生格式](https://ofox.ai/zh/docs/api/decisions#systemone)。新项目建议直接使用 `/v1/decisions`。