目的地概览
决策之后发生什么——按选项、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 对象。参见结构化输出。 |
llm | LLM | Dcision 使用你的密钥调用 OpenRouter 或 Vercel AI Gateway | 模型按路由的提示词作答;其文本在响应中返回。 |
agent | 智能体 | Dcision 调用你的智能体端点 | sync:智能体的回复在响应中返回。async:一次移交,在后台投递。 |
workflow | 工作流 | Dcision,在后台 | 携带路由的变量触发 n8n、Make、Zapier、Pipedream 或任意工作流 URL。 |
webhook | Webhook | Dcision,在后台 | 将签名后的决策结果 POST 到你的 URL。 |
http | API 请求 | 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。
{
"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,在决策中唯一)、一个启用开关,以及:
测试与部署
在 Playground 中运行草稿:目的地只会被预览——不会发送任何内容——直到你打开真实执行目的地。然后部署:API 调用会触发新版本的目的地。
编辑器中位于策略之后的目的地卡片会列出决策的所有目的地(最多 20 个),并可添加不绑定到单个回答的目的地——例如每次决策,或行动为 escalate。
在可视化构建器中
构建器的节点面板有一个包含八种类型的目的地分组。目的地以节点形式出现在输出节点之后,通过一条标有触发条件的边相连(route = sales · route confidence ≥ 0.8)——目的地关闭时显示为虚线。choice 选项会显示挂在其上的目的地数量。选中一个节点即可在检查器中编辑它。
节点面板、其中的每个分组以及检查器都可以折叠;布局会记在你的浏览器中,选中节点会重新打开已折叠的检查器。
在 schema 中
{
"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}}\"}"
}
}
]
}| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
key | string | — | 在决策的目的地中唯一;snake_case,最多 48 个字符。它在响应、投递和概览中标识该条目。 |
description | string | — | 可选,最多 2,000 个字符。 |
enabled | boolean | true | 关闭的目的地永远不会触发。 |
when | object | 每次决策 | conditions(AND)和 actions——参见触发条件。 |
type | string | — | reply、json、llm、agent、workflow、webhook、http 或 function。 |
params | object | {} | 最多 30 个变量——参见参数与模板。 |
reply、json、llm、agent、workflow、webhook、http、function | object | — | 该类型的设置:恰好是 type 中指定的那个块。 |
保存或部署带有无效目的地的 schema 会以 422 INVALID_SCHEMA 失败,并附带 destinations.1.workflow.url 这样的路径——编辑器会通过跳转到错误链接到它。
角色
| 操作 | 谁 |
|---|---|
| 添加、编辑和删除目的地(它们是决策的一部分),并部署它们 | 成员、管理员和所有者 |
| 重新发送失败的投递 | 成员、管理员和所有者 |
| 查看投递及其状态 | 工作区中的每个人,包括查看者 |
| 查看工作区密钥的名称 | 成员、管理员和所有者 |
| 添加、替换或删除密钥;显示或轮换签名密钥 | 管理员和所有者 |
参见团队、角色与账户。