> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 重启 PIN 训练智能体进程

> 在其 GPU 节点上重启 PIN 训练智能体进程，无需重新部署二进制，也不丢失其注册信息。

在不重新部署二进制的情况下重启智能体进程。适用于配置变更后或进程卡住时。智能体启动时会在控制平面上重新注册。

## 接口

```http theme={null}
POST /v1/agents/{id}/restart
```

## 认证

`Authorization: Bearer <api_key or JWT>`，且对目标智能体具有机队管理权限。

## 路径参数

<ParamField path="id" type="string" required>
  智能体标识符。
</ParamField>

## 响应

<ResponseField name="code" type="integer">
  重启请求被受理时为 `0`。
</ResponseField>

<ResponseField name="data" type="object">
  命令信封；已排队的重启命令通常为 `{ "ok": true, "command_id": "..." }`。
</ResponseField>

## 示例

```bash theme={null}
curl -X POST https://ariapin.example.com/v1/agents/ag_01H7Z.../restart \
  -H "Authorization: Bearer $ARIAPIN_API_KEY"
```

```json theme={null}
{
  "code": 0,
  "data": { "ok": true, "command_id": "cmd_9f8..." },
  "message": ""
}
```

<Note>
  重启是异步的。请轮询智能体状态接口以确认其已重新上线。
</Note>