常见问题

关于 Dcision 的常见问题解答——计费、配额和额度、密钥、模型和延迟、数据保留、部署与集成。

概述

Dcision 是 LLM 吗?

不是。Dcision 是一个决策层:你定义结构化的问题和策略,每次调用都会返回带类型的回答、置信度和一个行动。回答来自决策引擎——Jev(TypeSafe 的 System One,默认)、OpenAI Decisions 或 Laya——这类模型返回的是概率分布,而不是生成的文本。用 Dcision 来决定是否以及往哪里发送工作;让你的 LLM、智能体或团队去完成工作。

哪个模型回答我的决策?

决策自己的引擎,或工作区的默认引擎——除非管理员更改过,否则是 Jev。使用 Dcision 的引擎密钥时,Jev 在 TypeSafe 上运行,模型在 设置 → 引擎 中选择——jev-1.13.0(固定版本,默认)、jev-latest 或 jev-preview。OpenAI Decisions 使用你的 OpenAI 密钥运行 gpt-6-luna,Laya 在你的服务器上运行。使用你自己的密钥时,则是你选择的提供商和模型。metrics.model 总是报告实际作答的确切版本。参见引擎与 BYOK。

支持哪些语言和 SDK?

任何能发送携带 JSON 的 HTTPS 请求的语言都可以——API 就是一个 POST;参见运行决策中的 cURL、JavaScript 和 Python 示例。官方的 TypeScript 和 Python SDK 增加了绝不会让决策运行两次的重试、函数目的地和 webhook 验证;它们尚未发布到 npm 和 PyPI,因此请从源码构建。CLI 覆盖终端和 CI。

决策能调用我的系统或回答我的用户吗?

可以,通过目的地:针对每个选项、等级、阈值或最终行动,返回固定回复或 LLM 回答、移交给你的智能体、触发工作流、发送签名 webhook、使用你的密钥调用任意 API,或告诉你的代码运行哪个函数。投递会在约 7 小时内重试,而在你打开真实执行目的地之前,Playground 不会发送任何内容。

我可以从浏览器或移动应用调用 API 吗?

不可以。API 密钥是机密:请从你的后端、worker 或智能体运行时调用 Dcision,如果客户端需要结果,再把结果发送给它。

一个决策有多快?

每个响应都会报告 metrics.latency_ms,用量页面会显示你的决策的平均延迟和 p95 延迟。一个决策的所有问题都在一次引擎调用中并行回答,因此额外的问题几乎不增加延迟。引擎调用默认有 5 秒的截止时间(包括重试)——可以用 timeoutMs 为每个决策单独设置;超过时限的调用会以 504 ENGINE_TIMEOUT 失败。

引擎宕机时决策还能给出回答吗?

可以,前提是你选择开启:设置 onEngineError: "fallback" 后,引擎故障会返回 200,带有决策的 fallback 行动和 action_reason.type = "engine_error"。这些回答不计费。参见决策设置。

计费与配额

什么算作一次计费决策?

对 POST /v1/decisions/{slug} 的一次成功(200)调用,无论有多少个问题,每次调用只计一次。Playground 运行、错误、幂等重放、引擎错误时的 fallback 以及读取(GET /v1/me、GET /v1/executions)都是免费的。使用测试密钥和使用你自己的提供商密钥的调用与其他调用一样计数。参见哪些内容计费。

如何从代码中查看我的用量?

使用工作区的任意 API 密钥调用 GET /v1/me,会返回当前周期已用的计费决策数、包含的额度以及周期的起止日期。参见获取账户和用量。

超出包含的决策数之后会怎样——Genesis 也一样吗?

每个套餐都可以继续使用预付的额度运行,价格为该套餐每 100 万次决策的价格:Genesis 和 Developer 为 12 美元,Growth 为 9 美元(巴西为 60 雷亚尔和 45 雷亚尔)。Genesis 无需订阅即可这样做。没有额度时,API 调用会返回 402 CREDITS_EXHAUSTED,直到你添加额度、周期重置或升级套餐。Playground 仍可继续使用。参见额度。

如何获得额度?

所有者在计费页面添加:添加银行卡可获得 20 美元(100 雷亚尔)的促销额度,有效期 90 天——每个工作区一次、每张卡一次——也可以用银行卡购买 10 美元到 1,000 美元(50 雷亚尔到 5,000 雷亚尔)的额度。付费额度永不过期。兑换码同样会增加促销额度。

额度可以自动充值吗——我能限制支出吗?

可以,两者都是可选的。自动充值会在可用额度低于触发值时,从已保存的银行卡扣取所选金额,需要所有者授权;可以随时关闭。每个计费周期的支出上限会在周期内的额度支出达到上限后,以 402 SPEND_CAP_REACHED 拒绝超出包含额度的调用。

使用我自己的提供商密钥,决策就免费了吗?

不是。使用你自己的密钥时,由提供商对引擎调用计费,而成功的 API 调用仍会计入你的 Dcision 套餐。

metrics.estimated_cost_usd 是什么意思?

调用的引擎成本估算——metrics.input_tokens 乘以模型的价格(Jev:每 100 万输入 token 0.042 美元;OpenAI Decisions:0.10 美元;Laya:0——输出 token 免费)——用于比较决策。它不是 Dcision 向你收取的费用。

决策

我没有添加的 other 选项是什么?

每个 choice 问题都有一个保留的 other 选项,让引擎可以说“都不是”,而不是被迫给出错误的回答。当它被选中时,决策会采用其 fallback 行动。参见问题。

为什么没有策略这么规定,我的调用却返回了 escalate?

查看 action_reason:other_option 表示某个 choice 回答了 other;low_confidence 表示某个回答低于其 minConfidence;engine_error 表示在设置了 onEngineError: "fallback" 的决策上引擎出错。这三种情况都会采用决策的 fallback 行动,默认为 escalate。参见策略与行动。

为什么我的 probability 问题的置信度低于概率?

因为置信度衡量的是任一方向上的确定程度,与 choice 和 score 问题使用相同的尺度:对于概率 p,置信度为 |2p − 1|。概率 0.9——或 0.1——的置信度为 0.8;0.5 的置信度为 0。设置 minConfidence 时请记住这一点:0.6 会标记所有介于 0.2 和 0.8 之间的 p。参见置信度与概率。

响应中的 scores 和 composites 是什么?

scores 保存每个 score 问题的加权等级——其各等级按概率加权的平均值,从 1 开始计,因此 2.4 介于第二和第三个等级之间。composites 保存决策对回答的加权组合,例如线索评分。二者都可以驱动策略。参见问题和复合指标。

一个决策应该问多少个问题?

流程需要多少就问多少,最多 64 个:它们在一次调用中回答,该调用只计费一次。推测性的问题也一并提出——不需要的回答直接忽略即可。让每个问题保持原子化,并让 state 保持在 token 预算之内。参见推测式扇出和编写好问题。

block 会拒绝我的请求吗?

不会。行动只是给你的代码看的标签。响应是带有 "action": "block" 的 200 OK,由你的应用决定“拦截”意味着什么。

我编辑了决策,但 API 仍按旧的方式回答。为什么?

API 运行的是当前生效的版本。编辑只会更改草稿;部署它们才会创建新版本。参见版本与部署。

我可以修改 slug 吗?

在首次部署之前可以。之后 slug 会被锁定,因为客户端会调用它。

如何回滚?

版本不可变,并列在版本历史中。把草稿恢复为之前的 schema 并部署——这会用旧的逻辑创建一个新版本。

为什么我的 state 被拒绝并返回 422 INVALID_STATE?

消息会指明问题所在:缺少必填字段、类型错误("500" 不是 number)、文本决策收到了对象、列表决策没有收到数组,或者 state 超出了限制——无论是单独超出,还是与问题一起超出了引擎的 token 预算。schema 未声明的字段没有问题。

正式密钥还是测试密钥——我该用哪个?

它们运行相同的已部署版本,计费方式也相同;唯一的区别是,使用测试密钥时,目的地的投递会带有 livemode: false。请在预发环境、CI 和本地开发中使用测试密钥,这样你可以在不影响生产环境的情况下撤销它们。

团队与账户

我的团队可以共享一个工作区吗?

可以。在 设置 → 成员 中通过电子邮件邀请他人成为管理员、成员或查看者——邀请有效期为 7 天,在对方登录时被接受。每个人可以属于多个工作区,并最多拥有 10 个工作区。参见团队、角色与账户。

我可以用密码登录吗?

可以,前提是你在 账户 → 密码 中设置了密码——Google 登录和电子邮件验证码仍然可用。更改密码会让你的其他会话退出登录,而在所有设备退出会结束所有会话。

数据

Dcision 会存储我发送的 state 吗?

默认情况下,执行记录会在你套餐的日志保留期内保存 state(storeInput)和回答(storeOutput)——Genesis 为 7 天。可以为每个决策单独关闭其中任一项。存储的 state 只在应用中显示:GET /v1/executions 从不返回它们。参见安全与数据。

谁会处理我的数据?

Dcision 校验 state,并将其与决策的上下文和问题一起发送给引擎提供商:默认是使用 Dcision 账户的 TypeSafe,或者你自己密钥对应的提供商(OpenAI Decisions 为 OpenAI;Laya 为你自己的服务器)。需要 OpenAI 读取的文件——音频、用于 Jev 或 Laya 的图片、扫描文档——会使用工作区的 OpenAI 密钥发送给 OpenAI。参见你的 state 去往何处。

本页内容