执行实验。
接口说明
调用 CreateExperimentRun，基于已有实验计划发起一次实验执行。在线实验通常只需传 experimentPlanId；离线实验需传 offlineExperiments（1-5 个）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/experimentruns/{agentSpace}/execute HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| agentSpace |
string |
否 |
AgentSpace 名称。 |
al-playground-cn-hongkong |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| clientToken |
string |
否 |
可选。 |
a1b2c3d4-1234-5678-90ab-cdef12345678 |
| body |
object |
否 |
请求体。 |
{"experimentPlanId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e"} |
| experimentPlanId |
string |
是 |
实验计划 ID。 |
exp-plan-0242d983f5d340fd8479cf2c19eb279e |
| recordName |
string |
否 |
实验记录名称。不传时默认使用「计划名 + 时间戳」。 |
arms_agent_experiment 2026/07/22 20:02:55 |
| status |
string |
否 |
初始状态。不传时默认为 枚举值：
|
pending |
| totalTasks |
integer |
否 |
总任务数。在线实验不传时按生成任务数计。 |
40 |
| completedTasks |
integer |
否 |
已完成任务数。不传时默认 0。 |
0 |
| failedTasks |
integer |
否 |
失败任务数。不传时默认 0。 |
0 |
| executedAt |
integer |
否 |
执行时间，毫秒级 Unix 时间戳。 |
1784721775379 |
| completedAt |
integer |
否 |
完成时间，毫秒级 Unix 时间戳。 |
1784721811392 |
| offlineExperiments |
array |
否 |
离线实验配置列表。计划类型为 offline 时必填，数量 1-5。 |
[{"label": "experimentA", "name": "experimentA"}] |
|
OfflineExperimentConfig |
否 |
单个离线实验分组，含 label、name、可选 desc。 |
在线实验请求示例\n\n```json\n{
"experimentPlanId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e"
}\n\n\n### 离线实验请求示例\n\njson\n{
"experimentPlanId": "exp-plan-e95bff54685a4ae29ff3a834c1008a71",
"offlineExperiments": [
{
"label": "experimentA",
"name": "experimentA"
}
]
}\n```
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
执行实验响应。 |
||
| requestId |
string |
请求 ID。 |
019F89B5-1B07-3BB3-A32E-F5B007029E9C |
| recordId |
string |
实验记录 ID。在线实验多为 exp-run-{uuid32}；离线实验也可能为标准 UUID。 |
exp-run-f6d419b0ed3d43a7b585948a55efc07b |
| status |
string |
实验记录状态。创建后通常为 pending。 枚举值：
|
pending |
| message |
string |
提示信息。 |
实验已创建，开始执行 |
在线实验成功时 message 为「实验已创建，开始执行」；离线实验成功时 message 为「离线实验记录已创建，请通过 UpdateExperimentRun 接口更新执行进度」。\n\n### 在线实验响应示例\n\njson\n{ "recordId": "exp-run-f6d419b0ed3d43a7b585948a55efc07b", "requestId": "019F89B5-1B07-3BB3-A32E-F5B007029E9C", "message": "实验已创建，开始执行", "status": "pending" }\n\n\n### 离线实验响应示例\n\njson\n{ "recordId": "a5397261-6e6d-4e45-bf52-feb8686f7524", "requestId": "019F89B5-1B07-3BB3-A32E-F5B007029E9C", "message": "离线实验记录已创建，请通过 UpdateExperimentRun 接口更新执行进度", "status": "pending" }\n
示例
正常返回示例
JSON格式
{
"requestId": "019F89B5-1B07-3BB3-A32E-F5B007029E9C",
"recordId": "exp-run-f6d419b0ed3d43a7b585948a55efc07b",
"status": "pending",
"message": "实验已创建，开始执行"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。