Skip to main content
Node agents push training telemetry and status transitions to the PIN control plane. Two endpoints: /v1/agent/metrics for per-step metrics, /v1/agent/status for job status transitions.
All /v1/agent/* routes require both Authorization: Bearer <jwt-or-api-key> and X-Agent-Secret: <AGENT_REGISTER_SECRET>.

Push metrics

Request body

string
required
Sending agent identifier.
string
required
Job the metrics belong to.
integer
required
Training step index.
object
required
Per-step metrics payload. JSON object, usually with fields like loss, reward, kl, response_len, repeat.

Push status

Request body

string
required
Sending agent identifier.
string
required
Job identifier.
string
required
New job status reported by the agent.
string
Optional MLflow run ID.
number
GPU-seconds consumed.
integer
Tokens processed.
string
Error message when the job failed.

Response

Both endpoints return {"code": 0, "data": {"ok": true}, "message": ""} on success.

Example