列出智能体 API：GET /agents-大模型服务平台百炼(Model Studio)-阿里云帮助中心

分页列出当前工作空间下的智能体，按 created_at 倒序返回。默认不包含已归档项。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /agents

Query 参数

参数	必填	类型	说明
`limit`	否	int	单页条数，默认 20，最大 100
`page`	否	string	分页游标。首次不传，后续传上一次响应的 `next_page` 翻下一页
`include_archived`	否	bool	是否包含已归档智能体，默认 `false`

请求示例

Bash

curl "$AGENTSTUDIO_URL/agents?limit=20&include_archived=true" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Python

for agent in client.agents.list(limit=20, include_archived=True):
    print(agent.id, agent.name, agent.model['id'])

Java

CursorPage<Agent> page = client.agents().list(AgentListParam.builder()
    .limit(20).includeArchived(true).build());
for (Agent a : page.getData()) System.out.println(a.getId() + " " + a.getName());

响应说明

响应包含 data（Agent 对象数组）、next_page（下一页游标，无更多数据时为 null）与 request_id。每个 Agent 对象的字段同创建 Agent响应，字段说明如下：

Agent 对象字段

字段	类型	说明
`id`	string	智能体 ID，格式 `agent_<ULID>`
`type`	string	固定为 `agent`
`version`	int	当前版本号，每次更新自动递增
`name` / `description` / `system`	string	智能体名称、用途说明、系统提示词
`model` / `tools` / `mcp_servers` / `skills` / `metadata`	object / array	模型、工具包、MCP 引用、技能、业务元数据
`archived_at`	string \| null	归档时间，未归档时为 `null`
`created_at` / `updated_at`	string	创建/最近更新时间，ISO 8601
`workspace_id`	string	所属工作空间 ID