> ## 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 列出智能体（在线智能体）。

列出当前可见的智能体。响应是一个智能体对象数组，字段与[获取智能体](/api-reference/pin/agents/get)一致。

## 接口

**GET** `/v1/agents`

认证：需要 Bearer API 密钥。

## 响应

<ResponseField name="items" type="array">
  智能体对象数组。每个对象包含 `id`、`name`、`gpu_count`、`gpu_mem_gb`、`labels`、`gpus`、`last_heartbeat`、`status`、`node_id`、`version`、`deploy_state`、`last_error`、`agent_uid`，字段说明见[获取智能体](/api-reference/pin/agents/get)。
</ResponseField>

## 示例

```bash theme={null}
curl -s http://<pin-host>:8001/v1/agents \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "items": [
    {
      "id": "ag_7f8e9d0c",
      "name": "training-agent",
      "gpu_count": 8,
      "gpu_mem_gb": 640,
      "labels": ["training", "a100"],
      "status": "online",
      "node_id": "gn_a1b2c3d4",
      "version": "1.2.0",
      "deploy_state": "deployed"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.