跳至主要内容

面向 System One 的 TypeScript 工具包

通过一次 evaluate() 调用,为 Agent 加入结构化判断。定义候选项、评分标准和是非问题,在代码中直接使用类型明确的结果。

开源 · TypeScript · Node.js 与 Cloudflare Workers

安装 SDK
npm install @system-one-ai/sdk@0.5.3
decision.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'

连接模型服务

配置所选服务的地址与 API 密钥。可以使用 System One API、直连 TypeSafe,或配置适配器。密钥保存在服务端环境中。

SDK 文档
.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 中测试输入,在控制台查看请求记录和用量。