跳转到主要内容
在 Python 中用 JSON Schema 调用仪表板中的预设,然后验证回答,并记录调试所需的 ID。完成后,你会得到一个脚本:它发送 "model": "@release-summary",收到 {"summary": ..., "risk_level": ...},并打印该请求的提供商和插件详情。 把预设和 schema 换成你自己的之后,该脚本即可用于生产环境。请保留验证步骤:修复只处理语法,不处理内容。

构建

1

创建预设

在设置 → 预设中创建 release-summary,包含所有调用方应共享的系统提示、模型或允许的模型、提供商偏好、推理设置和 temperature。这样 Python 代码只需发送会变化的部分。预设说明了预设如何与请求合并。
2

安装 SDK

3

编写脚本

release_summary.py
4

运行

检查是否成功

脚本会打印响应 ID、实际回答的模型和提供商、插件记录,以及一个字典,其中包含 summary 和 low、medium、high 之一。在设置 → 用量 → 日志中搜索该响应 ID,即可看到同一请求及其路由详情。 不在预设允许模型范围内的模型会以 validation_error(关键字 preset_model_not_allowed)失败。validate() 抛出 ValueError 意味着 JSON 能解析但内容不对:请收紧 schema 或提示,而不是增加重试。

先调试,再覆盖

如果请求的路由与你的预期不同,请在日志中打开它,阅读路由可观测性和插件记录,等日志说明了发生了什么之后再修改预设。在单个请求上堆叠内联覆盖会违背使用预设的初衷;如果某个调用方确实需要不同的行为,就给它单独设置一个预设。
最后修改于 2026年11月5日