面向 System One 的 TypeScript 工具包
通过一次 evaluate() 调用,为 Agent 加入结构化判断。定义候选项、评分标准和是非问题,在代码中直接使用类型明确的结果。
开源 · TypeScript · Node.js 与 Cloudflare Workers
安装 SDK
npm install @system-one-ai/sdk@0.5.3decision.ts
import { SystemOne, choice } from '@system-one-ai/sdk';const client = new SystemOne({ baseURL: process.env.SYSTEM_ONE_BASE_URL!, apiKey: process.env.SYSTEM_ONE_API_KEY!, maxRetries: 0,});const result = await client.evaluate({ state: { message: 'I was charged twice.' }, questions: { team: choice('Who should handle this?', { billing: 'Payments and refunds', support: 'Technical issues', }), },});result.answers.team.choice; // 'billing' | 'support'.env
SYSTEM_ONE_BASE_URL=https://api.typesafe.ai/v1SYSTEM_ONE_API_KEY=YOUR_TYPESAFE_API_KEY用统一接口处理结构化判断
从问题到结果,保留类型
Choice 的返回值保留候选项的 TypeScript 字面量类型。评分和是非问题的概率以数值返回。
连接所需的模型服务
直接使用 System One API 或 TypeSafe,也可通过可选的 OpenRouter、Vercel AI SDK 适配器连接其他支持的服务。
控制请求行为
配置超时与重试,通过 AbortSignal 取消请求,并在应用中处理明确分类的错误。
连接 System One API
使用 System One API 密钥调用托管服务。在 Playground 中测试输入,在控制台查看请求记录和用量。