Skip to main content
GPU 节点智能体在启动时调用这个接口,向咏唱引擎 PIN 控制器注册。注册成功后,控制器返回智能体记录,其中包含稳定的 agent ID。
所有 /v1/agent/* 路由都需要同时携带 Authorization: Bearer <jwt-or-api-key> 与 X-Agent-Secret: <AGENT_REGISTER_SECRET>(须等于服务端环境变量)。这不是 HMAC 方案。

接口

POST /v1/agent/register

认证

请求体

string
可选的稳定 agent ID(例如由 systemd 注入的 ARIA_AGENT_ID)。如果匹配到已有的预创建行,控制器会更新那条记录。
string
required
这个智能体的主机名或显示名称。
string
智能体二进制版本。
array
GPU 清单对象列表。
array
可选的调度标签字符串列表。

响应

标准 PIN 信封(code / data / message)。data 为智能体记录:
string
分配的 agent ID。
string
智能体显示名称。
integer
上报的 GPU 总数。
array
回显的 GPU 清单。
string
智能体状态,例如 online。

示例