目的地触发条件

目的地何时触发——针对回答、置信度、加权级别和复合指标的条件、最终行动、每条路由的最低置信度、评分等级、概率阈值——以及触发顺序。

每个目的地都有一个 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"]
}
属性类型默认值说明
conditionsarray[]最多 5 个条件,必须全部成立。结构与策略条件相同:field、on(output、confidence 或 score)、operator 和 value。
actionsarray—仅当最终行动是其中之一时触发: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 顺序遍历目的地:

  1. 已关闭的目的地("enabled": false)会被忽略。
  2. 检查其 actions 和 conditions。不匹配的目的地不会留下条目。
  3. 解析其参数。当标记为 required 的参数没有值时,目的地不会触发:其条目显示 "status": "skipped", "reason": "missing_param",并指出对应的 param。
  4. 每次执行最多触发 10 个目的地,其中最多 3 个可以让调用方等待——LLM 回答和 sync 模式的智能体。超出部分的条目显示 "status": "skipped", "reason": "limit"。
  5. 其余的运行:回复和函数会被返回,LLM 和 sync 智能体调用会被并行等待,后台投递会进入队列。

引擎失败时

使用 onEngineError: "fallback" 时,引擎失败会返回带 fallback 行动且没有回答的 200。此时:

  • 带条件的目的地不会触发——没有可供比较的回答;
  • 不带条件的目的地会触发,如果设置了 actions 则按其筛选——这正是放置诸如 escalate → 通知值班人员 之类告警的地方;
  • result.*、confidence.*、scores.* 和 composites.* 变量为 null。

Fallback 回答的重试会真正执行

引擎错误产生的 fallback 不会为幂等性存储:用相同的 Idempotency-Key 重试调用会再次运行决策,其目的地也会以新的投递 ID 再次触发。请在你这一侧对此类告警去重——例如按你自己的记录 ID。

重放

幂等重放会返回已存储的响应——包括其 destinations 条目及其投递 ID——并且不会再次触发任何东西。不过,SDK 会再次分发被重放响应中的函数,因此请让函数处理程序具备幂等性。

本页内容