为指定优化任务创建运行并返回运行标识。preview=true 时执行独立预运行，生成候选结果和证据；预运行不发布候选产物，也不推进正式运行历史。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /agentspace/{agentSpace}/optimizetasks/{optimizeTaskName}/runs HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| agentSpace |
string |
否 |
AgentSpace 名称 |
my-agent-space |
| optimizeTaskName |
string |
否 |
优化任务名称 |
experience-mining |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| clientToken |
string |
否 |
幂等 Token；重试同一次创建请求时使用相同值 |
a1b2c3d4-1234-5678-90ab-cdef12345678 |
| body |
object |
否 |
运行输入及预运行选项 |
|
| input |
any |
是 |
任务类型定义的 JSON 输入，保持对象或数组原始结构。ExperienceMining 接受 start/end/processTimeMaxNS 对象；SkillOptimize 接受内联输入数组、SLS 的 skills/window 对象，或 ATIF/xTrace 的 skills/records 对象。服务端按任务类型和配置校验输入；记忆抽取继续使用原有 ContextStore 接口。 |
{"start":1727136000,"end":1727139600,"processTimeMaxNS":1727139600000000000} |
| preview |
boolean |
否 |
完整算法的独立预运行；生成候选结果和证据，不发布到目标 Dataset，也不推进正式运行历史。正式运行独立执行算法。 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
创建优化任务运行响应 |
||
| requestId |
string |
请求 Id |
9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M |
| optimizeRunId |
string |
运行 Id |
opr-20261014 |
| optimizeRun |
object |
已创建的运行详情；可通过 GetOptimizeRun 查询后续状态 |
{"optimizeRunId":"opr-20261014","status":"Pending"} |
|
any |
运行详情中单个字段的值。例如 status 字段的值为 Pending。 |
Pending |
示例
正常返回示例
JSON格式
{
"requestId": "9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M",
"optimizeRunId": "opr-20261014",
"optimizeRun": {
"key": "Pending"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。