> ## 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.

# 列出咏唱引擎云会话

> 列出咏唱引擎云会话，可按智能体可选筛选，并使用兼容 OpenAI Agents SDK 的游标分页。

列出会话。可按绑定到特定智能体的条件进行可选筛选。分页基于游标，使用 `after` 与 `limit`，与 OpenAI Agents SDK 一致。

## 接口

```http theme={null}
GET /v1/agents/sessions
```

## 认证

`Authorization: Bearer <api_key>` 或 `Authorization: ApiKey <api_key>`。

## 查询参数

<ParamField query="agent_id" type="string">
  筛选绑定到某个智能体的会话。
</ParamField>

<ParamField query="limit" type="integer">
  返回的最大会话数。
</ParamField>

<ParamField query="after" type="string">
  游标：用于翻页的会话标识符。
</ParamField>

## 响应

<ResponseField name="object" type="string">
  恒为 `list`。
</ResponseField>

<ResponseField name="data" type="array">
  会话对象数组（参见 [获取会话](/api-reference/agent/sessions/get)）。
</ResponseField>

## 示例

```bash theme={null}
curl "https://agent.example.com/v1/agents/sessions?agent_id=ag_0198a...&limit=20" \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "sess_0198c...",
      "object": "agent.session",
      "agent_id": "ag_0198a...",
      "status": "active",
      "created_at": 1735000000
    }
  ]
}
```