目的地触发条件
目的地何时触发——针对回答、置信度、加权级别和复合指标的条件、最终行动、每条路由的最低置信度、评分等级、概率阈值——以及触发顺序。
每个目的地都有一个 when 对象。当决策的最终行动是 when.actions 之一(如果你设置了的话)并且 when.conditions 中的每个条件都成立时,它就会触发:
{
"conditions": [
{ "field": "route", "on": "output", "operator": "eq", "value": "sales" },
{ "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
],
"actions": ["continue"]
}| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
conditions | array | [] | 最多 5 个条件,必须全部成立。结构与策略条件相同:field、on(output、confidence 或 score)、operator 和 value。 |
actions | array | — | 仅当最终行动是其中之一时触发:continue、block、escalate、fallback。 |
空的 when 会在每个决策之后触发。
按选项
最常见的触发条件,也是选项的目的地选择器所创建的条件:问题的回答等于该选项。
{ "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] }用 neq 表示“除 spam 之外的所有路由”。保留的 other 选项和其他回答一样:route = other 上的目的地会在没有选项适用时触发——同时决策的 fallback 行动(默认为 escalate)会告诉你的代码应该由人来查看。
每条路由的最低置信度
目的地的最低置信度字段会在同一个问题上添加一个 confidence ≥ 条件,因此只有当引擎足够确定时,该路由才会触发:
{
"conditions": [
{ "field": "route", "on": "output", "operator": "eq", "value": "sales" },
{ "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
]
}它独立于问题自身的 minConfidence,后者改变的是行动:无论目的地如何,低置信度的回答都会得到 fallback 行动和 action_reason.type = "low_confidence"。可以两者结合,或者为每条路由设置各自的阈值——退款路由可以要求 0.9,而“发送一篇文章”的路由可以接受 0.6。参见置信度门控路由。
按评分等级
评分题的选择器会在最可能的等级上创建一个条件:
{ "conditions": [{ "field": "priority", "on": "output", "operator": "eq", "value": "critical" }] }等级也可以按编号(1 = 第一个等级)使用任意运算符进行比较——在四级量表上,"operator": "gte", "value": 3 表示 high 或 critical——或者使用 "on": "score" 按加权级别比较,它可以落在等级之间:"on": "score", "operator": "gte", "value": 3.5。
概率阈值
概率题上的当 … ≥ … 时的目的地会在是的概率上创建一个阈值,默认为 0.8:
{ "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] }复合指标和其他回答
条件可以使用决策中的任何问题或复合指标,因此目的地不必跟随其所在面板所属的问题:lead_score ≥ 0.75 会把热门线索发送到一个工作流,而不论路由如何。
{
"conditions": [
{ "field": "lead_score", "on": "output", "operator": "gte", "value": 0.75 },
{ "field": "route", "on": "output", "operator": "neq", "value": "spam" }
]
}最终行动
actions 把目的地绑定到最终裁决上,而不是某个回答——每个 escalate 都发布到 Slack,每个 block 都创建一个审核工单:
{ "actions": ["escalate"] }同时有 conditions 和 actions 时,两者都必须成立。
验证
条件遵循策略条件的规则,并在你保存或部署时进行检查——否则返回 422 INVALID_SCHEMA:
field必须是决策中的问题或复合指标;- 选择题回答只支持
eq和neq,且值必须是其中一个选项; - 概率和置信度是 0 到 1 之间的数字——
0.7,而不是70; - 评分等级从 1 到等级数,或使用等级标签;
- 复合指标的范围是 −1 到 1(权重为正时为 0 到 1)。
评估
选定行动之后,Dcision 会按 schema 顺序遍历目的地:
- 已关闭的目的地(
"enabled": false)会被忽略。 - 检查其
actions和conditions。不匹配的目的地不会留下条目。 - 解析其参数。当标记为
required的参数没有值时,目的地不会触发:其条目显示"status": "skipped", "reason": "missing_param",并指出对应的param。 - 每次执行最多触发 10 个目的地,其中最多 3 个可以让调用方等待——LLM 回答和
sync模式的智能体。超出部分的条目显示"status": "skipped", "reason": "limit"。 - 其余的运行:回复和函数会被返回,LLM 和
sync智能体调用会被并行等待,后台投递会进入队列。
引擎失败时
使用 onEngineError: "fallback" 时,引擎失败会返回带 fallback 行动且没有回答的 200。此时:
- 带条件的目的地不会触发——没有可供比较的回答;
- 不带条件的目的地会触发,如果设置了
actions则按其筛选——这正是放置诸如 escalate → 通知值班人员 之类告警的地方; result.*、confidence.*、scores.*和composites.*变量为null。
Fallback 回答的重试会真正执行
引擎错误产生的 fallback 不会为幂等性存储:用相同的 Idempotency-Key 重试调用会再次运行决策,其目的地也会以新的投递 ID 再次触发。请在你这一侧对此类告警去重——例如按你自己的记录 ID。
重放
幂等重放会返回已存储的响应——包括其 destinations 条目及其投递 ID——并且不会再次触发任何东西。不过,SDK 会再次分发被重放响应中的函数,因此请让函数处理程序具备幂等性。