Agent

获取 Agent

获取指定 Agent 的详情

GET

/api/v1/agentstudio/agents/{agent_id}

cURL

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

{
  "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"
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

Response

200-application/json

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

请求唯一标识

cURL

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

{
  "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"
}