API-AI-030：Runtime 获取 Snapshot 接口 #179

New Issue

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

wangdl commented

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

目标

Runtime 执行 job 时获取 Snapshot。

接口

GET /internal/runtime/jobs/{jobId}/snapshot

返回字段

jobId
snapshotId
snapshotVersion
privacyScope
userProfile
aiSettings
deviceContext
learningBehaviorSummary
materialProgressSummary
contentStructureSummary
behaviorSignals
scoreSignals
constraints
allowedModelFields

Snapshot 过期处理

API 需要检查 Snapshot 是否过期。
如果过期且 job 未开始，返回 SNAPSHOT_EXPIRED。
如果 job 已 running 但 Snapshot 超过 maxExecutableAge，返回 SNAPSHOT_EXPIRED。
Runtime 收到 SNAPSHOT_EXPIRED 后提交 retryable fail。

验收标准

只允许 Runtime 访问。
jobId 必须存在。
Snapshot 必须属于该 job。
返回内容必须经过隐私过滤。
不返回未授权字段。
提供测试。

## 目标 Runtime 执行 job 时获取 Snapshot。 ## 接口 ``` GET /internal/runtime/jobs/{jobId}/snapshot ``` ## 返回字段 - jobId - snapshotId - snapshotVersion - privacyScope - userProfile - aiSettings - deviceContext - learningBehaviorSummary - materialProgressSummary - contentStructureSummary - behaviorSignals - scoreSignals - constraints - allowedModelFields ## Snapshot 过期处理 1. API 需要检查 Snapshot 是否过期。 2. 如果过期且 job 未开始，返回 SNAPSHOT_EXPIRED。 3. 如果 job 已 running 但 Snapshot 超过 maxExecutableAge，返回 SNAPSHOT_EXPIRED。 4. Runtime 收到 SNAPSHOT_EXPIRED 后提交 retryable fail。 ## 验收标准 1. 只允许 Runtime 访问。 2. jobId 必须存在。 3. Snapshot 必须属于该 job。 4. 返回内容必须经过隐私过滤。 5. 不返回未授权字段。 6. 提供测试。

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

wangdl added the

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

Sign in to join this conversation.