Decisions API · 开发者指南

什么是 Decisions API?

了解如何把应用状态和类型化问题提交给 Decisions API,并在软件中使用结构化选项、评分与概率信号。

Decisions API 返回代码可以处理的答案

Decisions API 是供应用执行边界明确判断的接口。服务端提交业务上下文(state),同时定义问题和允许的答案类型,响应便可由普通业务代码校验与处理,而不是解析一段开放式长文本。

decisions-api.pro 提供基于已配置 Jev 决策模型的 System One 接口。一次请求可围绕同一份 state 提交多个独立问题,适用于分类、路由、量表评分或真假判断等产品流程。

Choice、Noul、Score 对应不同的问题类型

Choice 从你定义的选项中选出一个结果,并可返回各选项概率;Noul 用概率表达是/否判断;Score 按你提供的有序等级评估状态,并返回分数和等级概率。应依据应用代码中的决策边界选择类型。

这些结果是供程序使用的判断信号,不是正确性保证。请校验响应,基于自己的标注样本设定阈值,并将低置信度或高影响案例交由人工复核。权限、策略执行和最终动作仍应由你的应用控制。

请求由 state 和具名问题组成

只提供与判断相关的 state,并把判断标准写清楚。为问题设置稳定 ID,便于将每个答案映射回对应代码路径。当前接口接受一份 state 和 1 到 8 个类型化问题。

POST https://decisions-api.pro/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "state": "4.8.1 发布后结账错误上升,错误预算接近耗尽。",
  "model": "jev-latest",
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "值班团队下一步应该做什么?",
      "criteria": {
        "pause": "暂停发布并调查",
        "rollback": "恢复到上一版本",
        "monitor": "继续发布并监控指标"
      }
    }
  }
}

从免费在线试用到生产接入

先在 Decisions API Playground 免费在线测试有代表性的请求,并检查结构化响应。再参考 API 文档了解认证、字段、错误和用量处理。API key 应保存在服务端;将结果连接到生产动作前,先用符合自身产品场景的测试集验证模型表现。