测试目的地
在 Playground 中预览目的地(密钥已遮蔽),以 livemode false 真实运行它们,使用测试 API 密钥,并跟踪投递、尝试和接收方的回应。
Playground 中的预览
Playground 运行的是草稿,默认只预览目的地——不会调用或发送任何内容:
| 类型 | 预览显示 |
|---|---|
| 固定回复 | 回复内容,渲染为带按钮的聊天气泡。 |
| LLM | 将要发送的提示:提供商、模型、渲染后的提示词和消息。不会调用模型。 |
| Webhook、API 请求、工作流、智能体 | 确切的请求——方法、URL、请求头和请求体——每个密钥都显示为 ••••。 |
| 函数 | 你的代码将要进行的调用,例如 assignToSales({ "email": "ana@acme.com" })。 |
[
{
"key": "sales_llm",
"type": "llm",
"status": "preview",
"prompt": {
"provider": "openrouter",
"model": "openai/gpt-5-mini",
"instructions": "You are Acme's sales team. Answer the lead in two sentences, say that a person will follow up today and never quote prices.",
"input": "We need pricing for 500 users and want to start next month."
}
},
{
"key": "create_lead",
"type": "http",
"status": "preview",
"request": {
"method": "POST",
"url": "https://api.crm.example.com/v2/leads?source=lead-qualification",
"headers": { "authorization": "Bearer ••••", "content-type": "application/json" },
"body": "{\"email\": \"ana@acme.com\", \"score\": 0.8414, \"note\": \"Routed to sales by Dcision\"}"
}
}
]预览与真实运行使用相同的渲染方式,因此在任何内容离开 Dcision 之前,这里正是检查 URL、编码和 JSON 请求体的地方。Dcision 自己的请求头——签名、投递 ID——会在请求真正发送时添加。
真实运行目的地
当决策带有目的地时,Playground 会在运行决策旁边显示真实执行目的地。打开它后,接下来的运行会:
- 以
sync模式调用 LLM 模型和智能体,并显示它们的回答; - 发送 webhook、API 请求、工作流以及
async智能体移交,带有常规的重试; - 把一切标记为测试:webhook 事件、工作流的
dcision对象以及智能体的decision对象中的livemode都为false,应用会将这些投递标记为测试模式。
Playground 的运行不计费——但 LLM 提供商仍会向你的密钥收取 token 费用——并且计入 Playground 每分钟 30 次、每天 2,000 次的限额。在 Playground 中,decision.version 为 null:它运行的是草稿。
测试 API 密钥
使用测试密钥(dcs_test_…)发起的调用会运行已部署的版本并真实投递,带有 livemode: false。将它们用于预发环境,以及针对预发接收方的 CI。它们与正式调用一样计费——参见正式密钥和测试密钥。
接收方应检查该标志,并让测试事件远离生产系统。API 请求不带 livemode 字段——测试期间请将其指向预发 URL。
跟踪发生了什么
- Playground 的目的地卡片会在每次投递运行时更新其状态:发送中、重试中、已投递或失败,以及尝试次数、HTTP 状态和延迟、下一次尝试和接收方的错误。重新发送会重试失败的投递。
- 执行记录为每次运行(包括来自 API 的运行)显示同样的卡片。
- 决策的概览按目的地统计返回的回答、已完成、失败和待处理的投递。
- CLI 的
dcision validate会列出 schema 的目的地,dcision decide --json会打印响应中的destinations。
上线之前
用几个真实的 state——每条路由一个——在 Playground 中预览目的地,并检查每个 URL、请求头和请求体。
针对预发接收方真实运行它们:验证签名、按投递 ID 去重,并忽略或单独路由 livemode: false 事件。
部署,用测试密钥调用端点,然后把你的集成切换到正式密钥。在决策的概览中关注失败的目的地。