Skip to main content
控制通道把 PIN 控制平面的生命周期与干预命令下发给节点智能体,并返回回执。智能体轮询待处理的控制队列,每处理一条命令就确认一次。面向终端用户的任务生命周期控制在 /v1/jobs/:id/*(见生命周期);下面的接口都属于 agent 组路由。
所有 /v1/agent/* 路由(含控制接口)都需要同时携带 Authorization: Bearer <jwt-or-api-key> 与 X-Agent-Secret: <AGENT_REGISTER_SECRET>。

发送控制命令

给负责该任务的智能体入队一条命令。Bearer 身份必须拥有这个任务。
string
required
取值之一:run、stop、resume、delete。
返回信封里的 data.status 是智能体的确认结果。

轮询待处理命令

data 中返回 { "commands": [ … ] }。

确认命令

string
自由格式的结果摘要。
boolean
智能体无法执行该命令时为 true。
data 中返回 {"ok": true}。

应用干预

上报某条干预已在训练 worker 上应用。
string
智能体标识符。
string
任务标识符。
string
required
由干预分配的干预 id。
object
干预应用后的超参数。

列出待应用干预

返回智能体必须为该任务应用的干预(data.items)。

获取任务负载

返回已分配任务的完整负载,供重启后重新连接的智能体使用。

示例