文档目录
浏览 System One 快速开始、决策原语、TypeScript SDK、API 参考与模型文档。
System One 将结构化的模型判断加入应用工作流。提交需要评估的上下文和明确的问题，再在代码中使用返回的选项、评分和概率，完成任务路由、结果排序或条件判断。
常见问题
Q: System One 文档目录在哪？
A: 文档目录列出各语言的快速开始、决策原语、TypeScript SDK、Clairic 抽取、System One API 参考、计费与隐私。
两个产品，一套决策接口
- System One SDK 是开源 TypeScript 工具包，用于定义问题、连接服务和处理类型化结果。它可以独立于本站托管 API 使用；直连其他服务时，使用该服务自己的凭证、可用模型和计费。
- System One API 是我们的托管 HTTP 服务，提供 API 密钥、模型发现、Playground、请求记录和预付积分。
- 将两者结合使用：通过平台地址和密钥，把 SDK 连接到 System One API。
SDK 的适配器列表不等于托管 API 的模型列表。当前可用模型、准确 ID、能力、限制和积分价格，以模型目录为准。模型会持续扩展，也可能调整；模型选择指南介绍了比较方法。
三种决策原语
| 原语 | 用来做什么 | 如何理解结果 |
|---|---|---|
| Choice | 从预先定义的选项中选择工具、类别或处理路径 | 选中项、概率分布和置信度 |
| Score | 根据有序档位评价相关性、紧急程度或质量 | 概率加权分数、分布和置信度 |
| Noul | 判断意图或某个条件是否成立 | P(true)，即 0 到 1 之间的概率 |
一次请求可以组合三种类型。每个问题都针对同一份 state 独立评估；state 就是你提交的文本或结构化上下文。如果后一个问题依赖前一个答案，需要把该答案放入下一次请求。SDK 用 booleanQuestion() 和结果中的 probability 表示 Noul；原生 HTTP API 使用 type: "noul" 和 noul 字段。构造器、示例和结果语义见决策原语。
接入前先体验
登录并打开 Playground，选择模型、加载示例、检查问题与预计积分，再运行请求。这个浏览器流程无需安装 SDK 或创建 API 密钥，评估仍使用你的账户余额。结果和请求活动可以在控制台查看。
图片决策请选择支持图片的 Clef、Clef Flash 或 Clef Omni 条目，添加本地 PNG／JPEG／WebP 文件，检查顺序和更新后的估算，并移除不必要的内容。图片及完整请求均受模型限制；Jev 仍仅支持文本。State 可以为空，但仍是必填字段。决策图片请求使用 HTTP/curl 指引，因为 systemOneAdapter 不会编码 evaluate() 的图片。从文本或图片做 Clairic 抽取请使用 SDK extract()。详见模型能力、Fetch 图片示例及数据处理。
工作流和动作执行仍由你的代码负责。高概率不是正确性保证，也不代表执行工具的权限。先测试有代表性的案例，对不确定或影响较大的结果保留复核，并且只提交你有权分享的信息。
接入指南
| 指南 | 可以完成什么 |
|---|---|
| SDK 文档 | 安装工具包、选择适配器并处理类型化结果。 |
| Clairic 抽取 | 使用公开模型名 clairic 调用 extract({ state, fields })。 |
| 托管 API 的 SDK 快速开始 | 配置地址与密钥，发送三种问题类型。 |
| API 参考 | 认证请求、发现模型，使用评估及账户端点。 |
| 选择模型 | 比较当前模型、输入能力、限制和价格。 |
| 接入智能体 | 选择适合的任务，控制动作、权限和请求恢复。 |
| Cursor、Claude Code、Codex 接入 System One 教程 | 安装 Agent Skill，并粘贴分类、工具路由和完成检查的提示词。 |
| API 版本 | 分别跟踪 HTTP、SDK 和模型版本。 |
| 幂等与重试 | 恢复响应，避免重复执行已经完成的评估。 |
| 积分与计费 | 估算托管 API 消耗并了解积分购买。 |
| 数据与隐私 | 了解提交内容、请求记录和保留期限。 |
决策概念可参考本站的决策原语和接入智能体指南。SDK 与托管 API 的具体协议、可用接口和计费，以本站各自的参考文档为准。