# 公开 Agent

`GET` `/v1/ai/agents`

列出平台上所有公开可用的 Agent——与探索页展示的是同一份目录。返回的 `uid` 即[发起对话](/zh-CN/docs/ai/chat/conversation)接口路径中使用的 Agent 标识。

与 [Workspace 下的 Agent](/zh-CN/docs/ai/workspace/agents) 不同，本接口不限定 Workspace：返回所有已发布且公开分享的 Agent。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | No | 页码，从 1 开始，默认 1 |
| `limit` | integer | No | 每页条数，默认 20，最大 50 |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/ai/agents' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `agents` | object[] | No | Agent 列表，按最后更新时间倒序 |
| `└ uid` | string | No | Agent UID，用作 [发起对话](/zh-CN/docs/ai/chat/conversation) 的路径参数 |
| `└ name` | string | No | Agent 名称，按 `Accept-Language` 请求头本地化 |
| `└ description` | string | No | Agent 描述，按 `Accept-Language` 请求头本地化 |
| `└ mode` | string | No | Agent 模式，如 `chat` |
| `└ icon` | string | No | 图标 URL |
| `└ is_published` | boolean | No | 本接口下恒为 `true` |
| `└ published_at` | integer | No | 发布时间，Unix 秒级时间戳 |
| `└ created_at` | integer | No | 创建时间，Unix 秒级时间戳 |
| `└ updated_at` | integer | No | 最后更新时间，Unix 秒级时间戳 |
| `total` | integer | No | 符合条件的公开 Agent 总数 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "agents": [
      {
        "uid": "ag_7d3f9b2c",
        "name": "US Stock Analyst",
        "description": "Answers US stock questions with market and fundamental data",
        "mode": "chat",
        "icon": "https://cdn.longbridge.com/icons/agent.png",
        "is_published": true,
        "published_at": 1742000000,
        "created_at": 1741000000,
        "updated_at": 1742001000
      }
    ],
    "total": 35
  }
}
```
