Skip to main content
POST
确认收到投递的工作行

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

路径参数

environment_id
string
必填

工作行所属的环境。

id
string
必填

工作行 ID。

请求体

application/json

POST /v1/environments/{environment_id}/work/{id}/ack 的请求体。

worker_id
string
必填

持有租约的 worker。

Minimum string length: 1
generation
integer<int64>
必填

投递时返回的 fencing token。

必填范围: x >= 1

响应

已确认的工作行,状态转为 starting。

自托管工作队列中的一行:其沙箱工具调用在环境属主的 worker 上执行的会话。GET /v1/environments/{environment_id}/work/poll 投递工作行(ack 前仍为 queued);其携带的 generation 是 fencing token,后续每次 ack、心跳、stop 都必须携带。user.tool_result 回写无需显式携带:secret 中的会话级 work token 已绑定签发代次,平台由它派生 fencing。

id
string
必填

工作行 ID。

session_id
string
必填

该工作行所属的会话。

environment_id
string
必填

可认领该工作行的环境。

status
enum<string>
必填

生命周期状态;poll 只返回 queued。

可用选项:
queued,
starting,
active,
stopping,
completed,
failed,
cancelled
generation
integer<int64>
必填

fencing token:从 1 开始,平台每次将失联 worker 的工作行重新入队时加 1。在心跳、ack、stop 时携带当前值;过期的 token 将被拒绝并返回 412 failed_precondition_error。工具结果回写改由会话级 work token 承载 fencing,该路径无需显式携带 generation。

必填范围: x >= 1
lease_ttl_ms
integer<int64>
必填

租约时长(毫秒);心跳会续租。

created_at
string<date-time>
必填

工作行的入队时间。

worker_id
string

持有租约的 worker。

claimed_at
string<date-time>

当前认领的发生时间。

acknowledged_at
string<date-time>

worker 确认投递的时间——在投递窗口内由 ack 调用打戳。

started_at
string<date-time>

首次心跳把行激活为 active 的时间(starting → active 时打戳)。

latest_heartbeat_at
string<date-time>

最近一次心跳落库时间;首次心跳前缺省。

stop_requested_at
string<date-time>

首次停止请求时间,租约回收后保留。

stopped_at
string<date-time>

工作行进入终态的时间;活跃期间缺省。

secret
string

工作行所属会话的凭据包,仅在认领该工作行的 poll 响应中出现:base64url 编码的 JSON 对象。worker 解码该包,将其 sessions_token 成员作为 Authorization: Bearer 凭据用于该会话的写路径(如 POST /v1/sessions/{id}/events)以及该工作行的 ack/heartbeat/stop,作用域仅限该会话。包内其余成员保留,不得消费。凭据在工作行终结或被回收后失效——回收会将工作行交给持有新凭据的接替 worker,本凭据随即作废。任何其他端点都不会返回它。按机密处理:不要记录日志或持久化。