测试目的地

在 Playground 中预览目的地(密钥已遮蔽),以 livemode false 真实运行它们,使用测试 API 密钥,并跟踪投递、尝试和接收方的回应。

Playground 中的预览

Playground 运行的是草稿,默认只预览目的地——不会调用或发送任何内容:

类型预览显示
固定回复回复内容,渲染为带按钮的聊天气泡。
LLM将要发送的提示:提供商、模型、渲染后的提示词和消息。不会调用模型。
Webhook、API 请求、工作流、智能体确切的请求——方法、URL、请求头和请求体——每个密钥都显示为 ••••。
函数你的代码将要进行的调用,例如 assignToSales({ "email": "ana@acme.com" })。
Preview entries
[
  {
    "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 事件。

部署,用测试密钥调用端点,然后把你的集成切换到正式密钥。在决策的概览中关注失败的目的地。

本页内容