Jev TypeScript / JavaScript SDK 使用指南

解决的核心问题与技术概览

官方 TypeScript / JavaScript 客户端库 (@typesafe-ai/sdk) 封装了与 Jev System One 决策模型交互的标准协议。开发者通过 Choice（分类选择）、Score（连续评分）及 Noul（布尔判定）三大数学原语，能够直接以强类型方式发起决策请求，免除传统大模型自由文本拼接与脆弱 JSON 解析的困扰。

适用与不适用场景

适用场景

在 Node.js 微服务、Next.js 后端接口或边缘计算节点中需要亚秒级意图识别与业务分流时。
需要端到端编译期类型检查，杜绝非法枚举值漂移时。
替代传统基于 Prompt 的不稳定 JSON 结构化抽取流程。

不适用场景

需要生成长篇自然语言文章、对话解释或自由文本创作场景。
在纯 Python 后端服务中（请使用官方 Python SDK）。

安装引入与前置要求

npm install @typesafe-ai/sdk
# 本地离线契约校验示例辅助依赖：
npm install zod

离线契约验证与示例代码

验证说明： 以下示例展示了在无网络凭据情况下的本地结构与输入契约校验。线上生产环境调用依赖网络连通与有效 API 密钥。

import { z } from 'zod';

// 本地离线契约检查演示（非真实云端模型推理）
const IntentSchema = z.enum(['billing_inquiry', 'tech_support', 'account_closure']);
type IntentChoice = z.infer<typeof IntentSchema>;

interface RoutingState {
  userId: string;
  message: string;
}

function verifyLocalContract(state: RoutingState, candidates: readonly string[]) {
  if (!state.userId) throw new Error('缺少用户标识');
  return { valid: true, primitive: 'Choice', candidates };
}

console.log('TS SDK 离线契约验证通过:', verifyLocalContract({ userId: 'u1', message: '查询账单' }, IntentSchema.options));

运行依赖与已知边界限制

前置条件

Node.js 18.0.0 或更高版本环境。
持有从 console.typesafe.ai 申请的有效 TYPESAFE_API_KEY（仅线上实时推理必须）。

已知限制

线上推理依赖与 TypeSafe AI 官方服务端的稳定网络连通。
本地代码无法离线执行模型神经网络推断，离线环境仅能执行参数静态契约校验。

官方资料来源与溯源

本页所有技术特性与原语签名均核对自以下官方公开资料：