Skip to Content
模型用法Jev(TypeSafe)项目接入

项目接入

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

通过编程助手接入

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

把 Jev 接进我的项目

复制后,将第二步中【】内的内容替换为实际的判断需求。

我想在当前项目里接入 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:

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 原生格式。新项目建议直接使用 /v1/decisions。

最后更新于