01
给出状态
可以是一段工单、一条消息、一组表单字段，或者 agent 当前看到的结构化数据。
state = ticket.text
面向软件团队的结构化决策 API · Decisions API
免费在线试用 Decisions API
将应用状态和类型化问题转换为代码可直接使用的选项、评分和概率信号。先在 Decisions API Playground 测试真实工作流，再通过 REST API 接入产品。
输出有明确结构一次问多个问题结果带概率
决策预览
示例结果01 / 输入状态
state4.8.1 版本发布后，us-east-1 区域的结账错误明显增加，剩余错误预算已接近耗尽。
02 / 待判断问题
choice是否应暂停本次发布并升级复核？
输出
response✓暂停发布，并检查最近一次部署指标。
继续发布并监控错误率
不是聊天记录，是可执行的结果类型化响应
在线生成器
Playground
在线测试应用状态和类型化问题，并查看结构化 JSON 结果。
登录后免费使用 Playground，不限次数。
Decisions API 开发者指南
三步接入决策接口
使用真实应用状态测试类型化问题，再把结构化结果接入产品。
02
写下问题
用 choice、score 或 noul 描述你真正需要的判断，一次请求可以问多个问题。
questions = { intent, urgent }03
交给代码处理
根据结果和概率决定排队、路由、拦截或请求人工确认，剩下的逻辑仍由你的系统掌控。
if result.urgent: escalate()面向应用的决策层
让软件拿到可以执行的判断结果
当产品逻辑需要明确答案、概率信号，并把控制权交回代码时，可以使用 Decisions API。
先定义答案范围
提前列出允许的结果，让下游代码能够校验、分流并稳定处理。
同时评估相关问题
一份共享状态可用于判断意图、衡量紧急程度和检查规则，减少串联多次提示调用。
为不确定结果设边界
结合概率分布处理判断结果；对模糊或影响较大的情况转交人工复核。
最终执行仍由产品控制
将返回结果映射到自己的函数、队列、审批规则和审计流程。
统一的工作流请求结构
向 REST 接口提交 state 和类型化问题，响应按问题 ID 返回对应答案。
从真实请求开始集成
文档涵盖请求字段、答案类型、响应处理方式，以及上线前需要了解的能力边界。
生产系统中的结构化判断
把不确定输入转化为明确的下一步
在产品代码需要判断的环节调用 Decisions API。模型选择、权限、重试和执行仍归你的应用管理。
01
从固定选项中选择去向
将任务分类到允许的目标之一，再由确定性代码负责派发。
02
执行前检查操作风险
评估工具操作是否符合规则，对敏感或不确定的情况发起审批。
03
优先处理真正紧急的工单
根据同一份工单状态判断意图、紧急程度和人工复核需求，再分配队列优先级。
04
长对话保留事实
判断哪些工具结果仍然相关，压缩上下文时保留原始信息而不是凭空改写。
Decisions API
开始调用 REST API
先在线免费测试，再创建 API key，将结构化决策接入产品。
查看 API 文档REST 就绪
Typed schema
可管理的 API key
请求长什么样
把判断放进已有的服务函数
from typesafe_sdk import Choice, Noul
response = client.system_one(
state=ticket,
questions={
"intent": Choice(criteria={...}),
"needs_human": Noul(
instructions="Does this need a person?"
),
},
)
# response.answers["intent"].choice面向结构化决策工作流的价格
先测试一次 Decisions API 请求，再按应用所需的并发和调用量选择积分方案。随着实际用量增长，可以继续扩展。
$10、$100 和 $1,000 为一次性购买，不会自动续费。已购积分长期有效。
不自动续费
积分长期有效
Playground + API 接入
入门版
$10
适合首次集成：在 Playground 验证一个小型工作流，再发出第一次服务端请求。
- 100,000 积分，长期有效
- 1 个工作区
- 3 并发
- 正常速度
- choice、score、noul 三类问题
- 类型化决策输出
- 概率与置信度结果
- 在线测试台
- API key 管理
- 邮件支持
推荐
专业版
$100
适合需要持续运行分类、评分和规则检查的线上产品。
- 1,000,000 积分，长期有效
- 无限工作区
- 10 并发
- 快速通道
- choice、score、noul 三类问题
- 类型化决策输出
- 一次请求并行提问
- API 访问
- 用量与调用记录
- 优先支持
企业版
$1,000
适合多个工作区或定制化生产集成团队，并额外获得 10% 积分。
- 11,000,000 积分（含额外赠送 10%）
- 包含专业版全部功能
- 并发不限制
- 独立快速通道
- 团队工作区与协作
- 定制集成支持
- 安全与权限配置建议
- 专属支持
- 生产级优先处理
- 产品路线反馈通道
Agent 接入
给你的 Agent 加上一层类型化决策
在现有编程 Agent 工作流中调用 Decisions API，完成边界清晰的分类、路由和安全检查。工具权限与最终执行仍由应用控制。
查看 Agent 说明接入 API
创建 Decisions API key，并在 Agent 或应用环境中配置接口地址。
一次配置
将 API key 保存在服务端环境变量中，不要写入源代码或 Agent 对话记录。
向 Agent 提出判断
向 Agent 提出边界清晰的问题；接口会返回代码可使用的选项、评分或真假概率。
API 环境变量
在现有 Agent 工作流中调用 API
export DECISIONS_API_KEY="sk_your_key_here"
export DECISIONS_API_BASE_URL="https://decisions-api.pro"Agent 仍然掌握执行权
API 负责评估决策；最终操作仍由 Agent、应用权限、确定性规则和人工审批控制。
Decisions API 文档
结构化决策接入指南
按开发流程了解如何定义类型化问题、提交应用状态，并在代码中使用结构化结果。
打开完整文档快速开始
创建账号，准备第一个 state 和 questions，请求返回即可看到类型化决策。
定义问题
使用 choice、score 和 noul 表达分类、评分与真假判断。一次请求可以并行询问多个问题。
接入产品
创建 API key，按 SDK 或 REST 示例接入，再根据概率与置信度决定你的业务分支。
了解边界
接口支持文本、JSON 对象和文本数组；暂不支持图像、音频或视频。非英语输入的准确性需要结合你的业务单独验证。
深入了解 Decisions API
从核心概念继续阅读，查看服务商接入说明和可参考的请求示例。
常见问题
了解输入方式、响应信号、模型调用和接入边界。