目的地概览

决策之后发生什么——按选项、score 等级、概率阈值或最终行动——固定回复、结构化输出、LLM 回答、你的智能体、工作流、签名 webhook、HTTP 请求和函数。

决策回答的是是什么:result、confidence 和 action。目的地说明每个结果接下来会发生什么——就像电话语音菜单的各条路由。把一个或多个目的地挂到某个选项(route = sales)、score 等级(priority = critical)、概率阈值(purchase_intent ≥ 0.8)或最终行动(escalate)上,每一次落到那里的调用都会回复调用方、移交该案例,或告诉你的代码要运行什么。

目的地是决策 schema 的一部分:与问题和策略一样,它们在草稿中编辑、在 Playground 中测试,并在你部署时进入生产环境。

state ──▶ answers ──▶ composites ──▶ policies ──▶ action ──▶ destinations
                                                               ├─ answer the caller: fixed reply · structured output · LLM · agent
                                                               ├─ hand off:          workflow · webhook · API request
                                                               └─ your code:         function

目的地类型

类型在应用中由谁运行发生什么
reply固定回复由 Dcision 渲染在响应中返回一条现成的消息——文本和按钮。不调用模型。
json结构化输出(JSON)Dcision——根据模板,或使用你的密钥调用 LLM在响应的 output 中返回一个按你的字段校验过的 JSON 对象。参见结构化输出。
llmLLMDcision 使用你的密钥调用 OpenRouter 或 Vercel AI Gateway模型按路由的提示词作答;其文本在响应中返回。
agent智能体Dcision 调用你的智能体端点sync:智能体的回复在响应中返回。async:一次移交,在后台投递。
workflow工作流Dcision,在后台携带路由的变量触发 n8n、Make、Zapier、Pipedream 或任意工作流 URL。
webhookWebhookDcision,在后台将签名后的决策结果 POST 到你的 URL。
httpAPI 请求Dcision,在后台调用任意 API:方法、URL、请求头以及带变量和密钥的 JSON 请求体。
function函数你的代码响应中指明一个函数及其参数;由 SDK 调用你的处理函数。

编辑器以同样的方式对它们分组:回复调用方(固定回复、结构化输出、LLM、智能体)、移交(工作流、webhook、API 请求)和你的代码(函数)。

该用哪一种

  • 用已知的文本立即回复终端用户——确认信息、链接、快捷回复按钮:使用固定回复。它不产生费用,也不增加延迟。
  • 用针对该路由生成的文本作答——“你是账单团队……”:使用 LLM 回答,配合你的 OpenRouter 或 Vercel AI Gateway 密钥。
  • 让你自己的智能体接手,使用它的工具和记忆:使用智能体——sync 立即返回其回复,async 进行移交。
  • 在 n8n、Make、Zapier 或 Pipedream 中启动无代码自动化:使用工作流。
  • 用签名事件通知你的后端:使用 webhook。
  • 直接调用第三方 API——创建 CRM 线索、开工单、发到 Slack——token 保存在工作区密钥中:使用 API 请求。
  • 在调用决策的进程中运行代码:使用函数,由 SDK 分派。

一个决策可以混合使用它们:route = sales 可以返回固定回复,同时触发 CRM 工作流,并且告诉你的代码分配负责人。

一次调用返回什么

目的地在行动选定之后被选出。响应会包含一个 destinations 数组,每个触发的目的地对应一个条目,按 schema 中的顺序排列:

  • 固定回复和函数会立即返回。
  • LLM 回答和 sync 模式的智能体在调用方等待期间被调用——并行进行,各自有自己的超时——它们的回答会被返回。
  • Webhook、API 请求、工作流和 async 模式的智能体进入队列并在后台投递,带有重试:响应返回它们的 delivery_id。
200 OK — Lead Qualification with destinations
{
  "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
  "execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
  "schema": "lead-qualification",
  "version": 4,
  "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
  "confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue",
  "action_reason": { "type": "default" },
  "destinations": [
    {
      "key": "sales_reply",
      "type": "reply",
      "text": "Thanks! Someone from our sales team will contact you today.",
      "buttons": ["Book a demo", "See pricing"]
    },
    { "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" },
    {
      "key": "hot_lead",
      "type": "function",
      "function": "assignToSales",
      "params": { "message": "We need pricing for 500 users and want to start next month." }
    }
  ],
  "metrics": {
    "latency_ms": 418,
    "engine": "jev",
    "model": "jev-1.13.0",
    "estimated_cost_usd": 0.00001575,
    "input_tokens": 375,
    "output_tokens": 36
  }
}

只要决策带有目的地,destinations 就会出现——没有触发任何目的地时为 []——否则不出现。每个条目的说明参见运行决策。

目的地永远不会导致决策失败

无法运行的目的地——缺少 param、LLM 没有密钥、智能体无法访问、队列已满——会显示在它自己的条目上(skipped 或 failed)。决策仍会返回 200 以及其结果和行动,并像其他调用一样计费。

在编辑器中设置

选择回答

在编辑器的问题卡片中,每个 choice 选项所在的行都有一个目的地选择器。它显示已挂上的目的地类型(有更多时显示 +1、+2……);在保留的 other 选项上,它显示 Fallback · escalate——即决策的 fallback 行动——直到你为它挂上目的地。

  • score 问题有一行每个级别的目的地:每个等级一个选择器。
  • probability 问题有当 … ≥ … 时的目的地:基于 yes 概率的阈值,默认为 0.8。

选择类型

点击选择器,打开当 route = sales 时面板。它列出该回答的目的地,可以就地编辑;添加目的地会以卡片形式显示八种类型,分为回复调用方、移交和你的代码三组。

配置

每个目的地都有一个键(snake_case,在决策中唯一)、一个启用开关,以及:

  • 触发条件——使其触发的条件。面板中已包含 route = sales;你可以为此路由设置以百分比表示的最低置信度、添加更多条件,或要求某个最终行动。参见触发条件。
  • 该类型的设置——回复文本、模型和提示词、智能体的端点、URL……
  • 参数——它使用的变量,来自某个字段或固定值。参见参数与模板。

测试与部署

在 Playground 中运行草稿:目的地只会被预览——不会发送任何内容——直到你打开真实执行目的地。然后部署:API 调用会触发新版本的目的地。

编辑器中位于策略之后的目的地卡片会列出决策的所有目的地(最多 20 个),并可添加不绑定到单个回答的目的地——例如每次决策,或行动为 escalate。

在可视化构建器中

构建器的节点面板有一个包含八种类型的目的地分组。目的地以节点形式出现在输出节点之后,通过一条标有触发条件的边相连(route = sales · route confidence ≥ 0.8)——目的地关闭时显示为虚线。choice 选项会显示挂在其上的目的地数量。选中一个节点即可在检查器中编辑它。

节点面板、其中的每个分组以及检查器都可以折叠;布局会记在你的浏览器中,选中节点会重新打开已折叠的检查器。

在 schema 中

decision.json (excerpt)
{
  "destinations": [
    {
      "key": "sales_reply",
      "type": "reply",
      "when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
      "reply": { "text": "Thanks! Someone from our sales team will contact you today.", "buttons": ["Book a demo", "See pricing"] }
    },
    {
      "key": "sales_crm",
      "type": "workflow",
      "when": {
        "conditions": [
          { "field": "route", "on": "output", "operator": "eq", "value": "sales" },
          { "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
        ]
      },
      "params": {
        "message": { "from": "state.message", "required": true },
        "company_size": { "from": "state.company_size" },
        "lead_score": { "from": "composites.lead_score" }
      },
      "workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
    },
    {
      "key": "hot_lead",
      "type": "function",
      "when": { "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] },
      "params": { "message": { "from": "state.message" } },
      "function": { "name": "assignToSales" }
    },
    {
      "key": "escalation_alert",
      "type": "http",
      "when": { "actions": ["escalate"] },
      "http": {
        "method": "POST",
        "url": "{{secrets.SLACK_WEBHOOK}}",
        "body": "{\"text\": \"A lead needs a person: {{decision.slug}} execution {{execution.id}}\"}"
      }
    }
  ]
}
字段类型默认值说明
keystring—在决策的目的地中唯一;snake_case,最多 48 个字符。它在响应、投递和概览中标识该条目。
descriptionstring—可选,最多 2,000 个字符。
enabledbooleantrue关闭的目的地永远不会触发。
whenobject每次决策conditions(AND)和 actions——参见触发条件。
typestring—reply、json、llm、agent、workflow、webhook、http 或 function。
paramsobject{}最多 30 个变量——参见参数与模板。
reply、json、llm、agent、workflow、webhook、http、functionobject—该类型的设置:恰好是 type 中指定的那个块。

保存或部署带有无效目的地的 schema 会以 422 INVALID_SCHEMA 失败,并附带 destinations.1.workflow.url 这样的路径——编辑器会通过跳转到错误链接到它。

角色

操作谁
添加、编辑和删除目的地(它们是决策的一部分),并部署它们成员、管理员和所有者
重新发送失败的投递成员、管理员和所有者
查看投递及其状态工作区中的每个人,包括查看者
查看工作区密钥的名称成员、管理员和所有者
添加、替换或删除密钥;显示或轮换签名密钥管理员和所有者

参见团队、角色与账户。

后续步骤

本页内容