更新实验运行。
接口说明
调用 UpdateExperimentRun 更新实验记录的名称、状态和任务计数。未传字段保持不变。离线实验典型顺序：running → 进度回写 → completed。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
PUT /api/v1/experimentruns/{agentSpace}/records/{recordId} HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| agentSpace |
string |
否 |
AgentSpace 名称。 |
al-playground-cn-hongkong |
| recordId |
string |
否 |
实验记录 ID。 |
a5397261-6e6d-4e45-bf52-feb8686f7524 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| clientToken |
string |
否 |
可选。 |
a1b2c3d4-1234-5678-90ab-cdef12345678 |
| body |
object |
否 |
请求体。未传字段保持不变。 |
{"status": "running", "totalTasks": 20, "executedAt": 1784719439255, "recordName": "rca_benchmark_eval_experiment 2026/07/22 19:23:59"} |
| recordName |
string |
否 |
实验记录名称。 |
rca_benchmark_eval_experiment 2026/07/22 19:23:59 |
| status |
string |
否 |
实验记录状态。设置为 cancelled 时取消执行。 枚举值：
|
running |
| totalTasks |
integer |
否 |
总任务数。 |
20 |
| completedTasks |
integer |
否 |
已完成任务数。 |
10 |
| failedTasks |
integer |
否 |
失败任务数。 |
0 |
| executedAt |
integer |
否 |
实验执行时间，毫秒级 Unix 时间戳。 |
1784719439255 |
| completedAt |
integer |
否 |
实验完成时间，毫秒级 Unix 时间戳。 |
1784719989371 |
离线实验：开始执行\n\n```json\n{
"status": "running",
"totalTasks": 20,
"executedAt": 1784719439255,
"recordName": "rca_benchmark_eval_experiment 2026/07/22 19:23:59"
}\n\n\n### 离线实验：进度回写\n\njson\n{
"completedTasks": 10,
"failedTasks": 0,
"totalTasks": 20
}\n\n\n### 离线实验：标记完成\n\njson\n{
"status": "completed",
"completedTasks": 20,
"failedTasks": 0,
"totalTasks": 20,
"completedAt": 1784719989371
}\n\n\n### 取消执行\n\njson\n{
"status": "cancelled"
}\n```
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
更新实验运行响应。 |
||
| requestId |
string |
请求 ID。 |
019F89B5-1B07-3BB3-A32E-F5B007029E9C |
| recordId |
string |
实验记录 ID。 |
a5397261-6e6d-4e45-bf52-feb8686f7524 |
| status |
string |
更新后的状态（落库值）。 枚举值：
|
running |
| message |
string |
提示信息。 |
实验记录更新成功 |
本接口返回的 status 为落库值。查询详情时 GetExperimentRun 可能将其展示为 evaluating / eval_cancelling 等计算状态。\n\njson\n{ "requestId": "019F89B5-1B07-3BB3-A32E-F5B007029E9C", "recordId": "a5397261-6e6d-4e45-bf52-feb8686f7524", "status": "running", "message": "实验记录更新成功" }\n
示例
正常返回示例
JSON格式
{
"requestId": "019F89B5-1B07-3BB3-A32E-F5B007029E9C",
"recordId": "a5397261-6e6d-4e45-bf52-feb8686f7524",
"status": "running",
"message": "实验记录更新成功"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。