Agent

列出 Agent

分页列出工作空间下的 Agent

GET

/api/v1/agentstudio/agents

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/agents' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "agent_01JXH5K2M3N4P5Q6R7S8T9UV",
      "type": "agent",
      "version": 1,
      "name": "数据分析助手",
      "description": "帮助用户分析数据文件",
      "model": {
        "id": "qwen3-max"
      },
      "system": "你是一个专业的数据分析助手。",
      "tools": [
        {
          "type": "builtin_toolkit",
          "default_config": {
            "type": "allowed"
          }
        }
      ],
      "mcp_servers": [],
      "skills": [],
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-07-20T10:00:00Z",
      "updated_at": "2026-07-20T10:00:00Z",
      "workspace_id": "ws_xxx",
      "request_id": "req_xxx"
    }
  ],
  "has_more": false,
  "request_id": "req_xxx"
}

Authorizations

string

header

required

DashScope API Key

Response

200-application/json

object[]

Show child attributes

string

Agent ID，格式 agent_<ULID>

string

固定值 agent

integer

当前版本号

string

Agent 名称

string

Agent 描述

object

模型配置

Show child attributes

string

系统提示词

object[]

工具包列表

object[]

MCP Server 引用列表

object[]

挂载技能列表

object

业务自定义键值

string | null

归档时间，ISO 8601

string

创建时间，ISO 8601

string

更新时间，ISO 8601

string

所属工作空间 ID

string

请求唯一标识

boolean

string

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/agents' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "agent_01JXH5K2M3N4P5Q6R7S8T9UV",
      "type": "agent",
      "version": 1,
      "name": "数据分析助手",
      "description": "帮助用户分析数据文件",
      "model": {
        "id": "qwen3-max"
      },
      "system": "你是一个专业的数据分析助手。",
      "tools": [
        {
          "type": "builtin_toolkit",
          "default_config": {
            "type": "allowed"
          }
        }
      ],
      "mcp_servers": [],
      "skills": [],
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-07-20T10:00:00Z",
      "updated_at": "2026-07-20T10:00:00Z",
      "workspace_id": "ws_xxx",
      "request_id": "req_xxx"
    }
  ],
  "has_more": false,
  "request_id": "req_xxx"
}