@c轨道/系统一

从TypeSafe的Jev模型中对JSON状态进行打出选择,分数和是/否决定,作为验证结果或打出倒数返回. 轨道和交流剂的推论提供者:登记为 @intx/inference 适配器,也可以独立操作 evaluate()。 。 。 .

为什么 @c轨道/系统一?

1. 输入决定,而不是自由文本. 你用ID发送问题;你得到每个ID一个经过验证的决定,有概率和信心. 没有快速解析 .
2. 失败是数据. 缺少密钥、 超时、 HTTP 出错或坏身体返回 a FallbackResult 带有 reason,所以一个门可以失败 关闭没有 try。只有无效的调用输入.
3. 一个电话,很多问题. 列表中的每个问题都会在一个POST中出场,以1.5的默认超时为界.

它对照问题评价结构状态。 对于开放式聊天完成,请使用一般推论提供者,例如 @corbits/openai-responses。 。 。 .

安装

bun add @corbits/system-one @intx/inference@^0.4.0 @intx/types@^0.4.0

运行在 Bun QQ 1.2 或 Node QQ 24.

在发布前消耗一个精确的 Git 承诺, 启用包的 源条件, 因为 Git 依赖性不运行 prepack数字 :

bun add github:corbitsdev/corbits-system-one#<commit>
bun --conditions=corbits-system-one-src your-script.ts

已出版的消费者继续使用 dist 默认输入.

快速启动

需求 TYPESAFE_API_KEY 设置.

import { evaluate } from "@corbits/system-one";

const result = await evaluate({
  state: { action: "deploy", env: "production" },
  questions: [
    {
      id: "escalate",
      type: "boolean",
      instructions: "Must this request be escalated for human approval?",
    },
  ],
});

console.log(result.fallback ? result.reason : result.decisions);

如果成功,每个问题都有一个决定,或者失败的后退原因:

[{ id: "escalate", type: "noul", noul: 0.91 }];

布尔问题回答如下: noul,从0到1的概率,答案是肯定的.

合适的话

互换 管理AI代理作为主要负责人(持有自己身份、授权和证书的账户)。 轨道包增加了一个代理产品需要的周围.

• 运行于 : 或任何过程. evaluate() 不需要交换运行时间.
• 插入到 : 页:1 @intx/inference 适配器登记册,作为 corbits-system-one 提供方编号.
• 与 : @corbits/openai-responses 财务报告和审定财务报表 @corbits/ollama-adapter其他的轨道推论提供者.

参考文献

Question, (中文(简体) ), QuestionList, (中文(简体) ), Decision, (中文(简体) ), EvaluateInput, (中文(简体) ), EvaluateConfig, (中文(简体) ), EndpointConfig, (中文(简体) ), EvaluateResult 财务报告和审定财务报表 FallbackResult 导出为方舟型计划和类型.

问 题

每个问题都有 id在列表中独一无二. box 外缘 [0, 1] 拒绝.

密钥问题

systemOne 使用相同的状态和记录 问题建立与 choice, (中文(简体) ), noul, (中文(简体) ), score,以及 box。名称是答案键。 这些帮助者汇编到列表中 evaluate 已经发送。 同样的倒计时理由也适用,这些失败是不会发生的。 帮助者也从 @corbits/system-one/decisions。 。 。 .

import { choice, noul, score, systemOne } from "@corbits/system-one";

const result = await systemOne({
  state: { document: "I was charged twice." },
  questions: {
    category: choice("What is this?", { billing: null, technical: null }),
    escalate: noul("Must this be escalated?"),
    severity: score("How severe?", ["none", "cosmetic", "unusable"]),
  },
});

关于成功,请阅读 result.answers.category.choice (单位:千美元) probabilities 财务报告和审定财务报表 confidence, (中文(简体) ), result.answers.escalate.noul,以及 result.answers.severity.score。 。 。 .

image() 接受一个 Blob 或者说 Uint8Array。 。 。 . Image.fromBase64() 接受 base64 文件字节。 只有PNG和JPEG被发送. 将图像放入 state,指示,或标准,或插入 withAssets (和 withAssets.join 名单。 普通模板字符串中的图像在请求前被拒绝. assets 将名称映射到图像中, 用于平整字符串; 每个名称必须在请求中显示为自己的符号 。 任何图像的请求是 multipart/form-data 发送 TypeSafe-Danger-Zone-Images: true否则尸体就留下JSON.

import { box, image, systemOne, withAssets } from "@corbits/system-one";

const photo = image(pngBytes);
const result = await systemOne({
  state: withAssets`Returned item: ${photo}`,
  questions: { damage: box("The damaged area") },
  model: "jev-preview",
});

providerOptions.systemOne.questions 接受此按键记录以及提问列表.

配置

input.config 页:1 evaluate,或参数为 createSystemOneAdapter数字 :

端点和密钥

SYSTEM_ONE_API_KEY 也是每个端点上支持的别名,在端点自己的密钥后读取. 自定义终点 auth: "none" 不需要密钥,也不发送 Authorization官方和网关总是需要钥匙。 任何其他 auth 值是无效的输入并丢出.

退缩原因

detail 带有基本信息.

使用互换

将适配器注册到 SYSTEM_ONE_PROVIDER 并传递每个呼叫中的问题 providerOptions.systemOne (单位:千美元){ state?, questions? }) (中文(简体) ). 无 state,适配器将记录文本作为状态发送。 无 questions,它问一个布尔问题 与id response。 。 。 .

import { createDependencies, runInference } from "@intx/inference";
import {
  createSystemOneAdapter,
  SYSTEM_ONE_PROVIDER,
  type QuestionList,
} from "@corbits/system-one";

const deps = createDependencies({
  has: (provider) => provider === SYSTEM_ONE_PROVIDER,
  resolve: () => createSystemOneAdapter(),
});

const questions = [
  {
    id: "escalate",
    type: "boolean",
    instructions: "Must this request be escalated for human approval?",
  },
] satisfies QuestionList;

let seq = 0;
for await (const event of runInference({
  deps,
  source: {
    id: "system-one",
    provider: SYSTEM_ONE_PROVIDER,
    baseURL: "https://api.typesafe.ai/v1/systemone",
    credentialId: "TYPESAFE_API_KEY",
    model: "jev-latest",
  },
  turns: [
    {
      role: "user",
      timestamp: Date.now(),
      content: [{ type: "text", text: "Deploy to production?" }],
    },
  ],
  inferenceOptions: { providerOptions: { systemOne: { questions } } },
  nextSeq: () => seq++,
  readMaterial: (id) => {
    const secret = process.env[id];
    if (secret === undefined) throw new Error(`${id} is not set`);
    return { secret };
  },
})) {
  if (event.type === "inference.text.delta")
    console.log(JSON.parse(event.data.token));
}

适配器发出一个 inference.text.delta 每一决定 token 作为JSON的决定,然后 inference.usage 活动。 绳子能提供证书 readMaterial 并拥有复试。 一个畸形的反应机构是 ProtocolMismatchError而不是一个后退.

工厂

createSystemOneAdapterFactory(source, quirks?) 是互换 AdapterFactory,所以一个股票侧车装入它从 SIDECAR_ADAPTER_MANIFEST 没有自定义代码 :

[
  {
    "provider": "corbits-system-one",
    "specifier": "@corbits/system-one",
    "export": "createSystemOneAdapterFactory"
  }
]

中心供货 quirks 验证并全部可选 :

{
  "endpoint": {
    "kind": "custom",
    "url": "https://opencode.ai/zen/v1/systemone"
  },
  "model": "jev-1.13",
  "questions": [{ "type": "boolean", "id": "gate", "instructions": "Allow?" }],
  "state": {}
}

无 endpoint,适配器贴出目录提供者的 baseURL + 键 /systemone主办方的证书是发给的 A 类 model 奇克( 顶级 ) endpoint)是电线上发送的模型,因此一个目录模型可以由不同名称的提供者服务. questions 财务报告和审定财务报表 state (a) 按需要计算的缺省; providerOptions.systemOne 在呼叫中逐一获胜。 未知密钥丢出 。 适配器发送无记名信使,被接通的绳子注入祭品的证书,除了一个自定义的终点 auth: "none",省略 Authorization 因此,主机不附加密钥.

升级至0.3.1

• createSystemOneAdapterFactory 无 endpoint 怪怪的现在贴到目录提供者的 baseURL + 键 /systemone 代替正式的 TypeSafe URL 。 设置提供者 baseURL 转到 API 根(例如 https://api.typesafe.ai/v1),或保持旧行为 {"endpoint":{"kind":"official"}}带子向适配器返回的 URL 发送送礼证书,所以只设置一个明确的 endpoint 在证书所属的宿主上.
• A 类 model 现在奇特地推翻了被绑住的模型(编目犬科名称).
• createSystemOneAdapter 财务报告和审定财务报表 evaluate 接受 auth: "none" 自定义终点并省略 Authorization。任何其他 auth 值抛出 SystemOneError 在请求建立之前.

从0.1升级

• HttpError, (中文(简体) ), NetworkError 财务报告和审定财务报表 TimeoutError 被删除。 运输故障返回a FallbackResult。 。 。 .
• 一个不是JSON的2xx尸体 parse-error (曾经是) network) (中文(简体) ). 身体读取时的暂停是 timeout。 。 。 .
• recordTelemetryEvent 财务报告和审定财务报表 drainTelemetryEvents 被删除。 过 evaluate(input, { onTelemetry })。 。 。 .
• 电线帮手 怪胎预设, JsonRecord, (中文(简体) ), Confidence 而env-var名称常数不再被导出.
• A 类 custom 无终点 model 发送 typesafe-ai/jev。 。 。 .
• 同行是 @intx/inference 财务报告和审定财务报表 @intx/types ^0.4.0。 。 。 .
• 环境变量不变,包括: SYSTEM_ONE_API_KEY。 。 。 .

许可证

LGPL - 2.1- 仅限