API-AI-032：Runtime 提交执行结果接口 #181

New Issue

wangdl · 2026-06-10T21:03:46+08:00

wangdl commented

2026-06-10 21:03:46 +08:00

目标

Runtime 执行完成后提交结构化结果。

接口

POST /internal/runtime/jobs/{jobId}/result

请求字段

runtimeInstanceId
schemaVersion
status
rawOutput
validatedOutput
validationErrors
usage
attemptNo
outputHash

幂等机制

resultIdempotencyKey = jobId + attemptNo + outputHash。
如果同一 resultIdempotencyKey 已存在，则直接返回成功。
如果同一 job 已有 succeeded result，但 outputHash 不同，则拒绝，错误码 RESULT_ALREADY_EXISTS。
Admin 重跑不复用旧 job，而是创建新 job，并记录 retriedFromJobId。

处理流程

校验 Runtime token。
校验 job 状态。
写入 AiRuntimeResult。
更新 AiRuntimeJob 为 succeeded。
触发 API 侧业务落库处理。

验收标准

可提交 succeeded result。
result 与 job 一对一。
重复提交应幂等处理。
schemaVersion 必填。
validatedOutput 必填。
job 状态正确更新。
提供测试。

## 目标 Runtime 执行完成后提交结构化结果。 ## 接口 ``` POST /internal/runtime/jobs/{jobId}/result ``` ## 请求字段 - runtimeInstanceId - schemaVersion - status - rawOutput - validatedOutput - validationErrors - usage - attemptNo - outputHash ## 幂等机制 1. resultIdempotencyKey = jobId + attemptNo + outputHash。 2. 如果同一 resultIdempotencyKey 已存在，则直接返回成功。 3. 如果同一 job 已有 succeeded result，但 outputHash 不同，则拒绝，错误码 RESULT_ALREADY_EXISTS。 4. Admin 重跑不复用旧 job，而是创建新 job，并记录 retriedFromJobId。 ## 处理流程 1. 校验 Runtime token。 2. 校验 job 状态。 3. 写入 AiRuntimeResult。 4. 更新 AiRuntimeJob 为 succeeded。 5. 触发 API 侧业务落库处理。 ## 验收标准 1. 可提交 succeeded result。 2. result 与 job 一对一。 3. 重复提交应幂等处理。 4. schemaVersion 必填。 5. validatedOutput 必填。 6. job 状态正确更新。 7. 提供测试。

wangdl added this to the M-API-AI-RUNTIME：API AI Runtime 调度与落库 milestone 2026-06-10 21:03:46 +08:00

wangdl added the

labels 2026-06-10 21:03:46 +08:00

Sign in to join this conversation.