执行记录与用量

每次运行都会被记录,包括其版本、行动原因、置信度,以及——如果你允许——输入和输出。查找执行记录、查看用量,并了解日志保留多久。

执行记录

每次运行——无论来自 API 还是 Playground,成功与否——都会被记录为一条执行记录。其 ID 就是响应中的 execution_id。

记录内容说明
决策和版本v3,Playground 运行则为 draft
来源API 或 Playground
状态和错误成功或错误,附带错误码和消息
行动和行动原因适用于成功的运行
延迟、模型、输入和输出 token、估算成本模型是作答的确切版本
请求 ID调用的 X-Request-ID——你提供的或 Dcision 生成的
输入(state)仅当决策的 storeInput 开启时
输出、置信度、加权级别、复合指标、分布仅当 storeOutput 开启时
目的地本次运行的目的地条目——回复、LLM 和智能体回答、带参数的函数、排队的投递——不论 storeInput 和 storeOutput 如何设置

失败的调用也会被记录——包括无效的状态(INVALID_STATE,含 token 预算超限)和引擎错误——这样你就能看到你的集成发送了什么。以引擎错误 fallback 作答的调用会被记录为错误,并带有引擎的错误码,尽管 API 返回了 200。在决策运行之前被拒绝的请求——无效的密钥或请求体、未知、已停用或未部署的决策、速率限制、配额拦截、幂等重放——不会被记录。

查找执行记录

执行记录按从新到旧列出最近的运行,每次 50 条(点击加载更早的记录查看更多)。可按状态、来源和决策筛选,或按执行 ID 的开头、决策名称或 slug 搜索。选择一次运行会打开其详情:行动和原因、错误、延迟、模型、估算成本、请求 ID、输入、输出、每个问题的分布、其目的地及投递的实时状态——外加在 Playground 中重新运行此输入。

记录这些 ID

把 execution_id 与你的应用据以采取行动的记录一起保存,并发送你自己的 X-Request-ID,以便将 Dcision 的运行与你的日志关联起来。

从代码中读取执行记录

GET /v1/executions 使用 API 密钥列出同样的运行——回答、行动、原因、状态、错误码和指标,可按决策和状态筛选,从新到旧。它从不返回输入:已存储的状态保留在应用中,供工作区成员查看。

用量

用量汇总今天、最近 7 天或最近 30 天的数据:

  • API 调用和 Playground 运行;
  • 成功的决策和错误率;
  • 所有运行的平均延迟,以及成功运行的 p50 和 p95 延迟;
  • 估算的引擎成本和输入 token;
  • 调用量图表——今天按小时,其他按天——错误以虚线表示;
  • 按决策细分:调用次数、错误、平均延迟、估算成本和占比。

顶部卡片显示当前计费周期的计费决策与套餐包含量的对比——也可以在代码中通过 GET /v1/me 获取。仪表盘会重复显示关键数字(已执行的决策、p95 延迟、成功率、估算的引擎成本),以及你的上线决策、最近的执行记录和入门清单。

按决策:概览

每个决策的第一个标签页概览会汇总其 7、30 或 90 天内的运行——成功率、延迟、成本、行动及其原因、按问题统计、目的地——并建议需要校准的地方。参见概览与校准。

保留期

一个每日任务会删除超过你套餐保留期与工作区设置(设置 → 执行日志保留期)两者中较短者的执行记录:

套餐日志保留期
Genesis7 天
Developer14 天
Growth30 天
Enterprise365 天

例如,设置为 7 天的 Growth 工作区保留 7 天;设置为 90 天的 Genesis 工作区保留 7 天。

  • 用量图表和表格是根据执行记录计算的,因此只涵盖仍被保留的运行。
  • 计费不依赖日志。计费决策按小时单独计数,这些计数器会保留约 400 天:保留期永远不会退还配额或改变你的费用。
  • 删除决策会立即删除其执行记录。
  • 目的地投递遵循自己的保留期:它们在创建 30 天后删除——参见投递与重试。

配额提醒

当本周期的计费决策达到包含量的 80% 和 100% 时,工作区所有者会收到电子邮件——每个周期每个级别一次。参见套餐、配额与计费。

本页内容