获取 Agent

根据智能体 ID 返回完整配置。默认返回最新版本，可通过 version 参数指定历史版本。

前提

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

接口

GET /agents/{agent_id}

Query 参数

请求示例

# 默认返回最新版本
curl "$AGENTSTUDIO_URL/agents/agent_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

# 指定版本
curl "$AGENTSTUDIO_URL/agents/agent_xxx?version=3" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

# 默认返回最新版本
agent = client.agents.retrieve("agent_xxx")

# 指定版本
agent = client.agents.retrieve("agent_xxx", version=3)

// 默认返回最新版本
Agent agent = client.agents().retrieve("agent_xxx");

// 指定版本
Agent agentV2 = client.agents().retrieve("agent_xxx", 2);

响应示例

{
  "id": "agent_xxx",
  "type": "agent",
  "version": 1,
  "name": "data-analyst",
  "description": "数据分析助手",
  "model": {"id": "qwen3.7-max"},
  "system": "你是数据分析专家，使用 pandas 处理 CSV 文件。",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "multiagent": {
    "type": "coordinator",
    "agents": [
      {"type": "self"},
      {"type": "agent", "id": "agent_researcher", "version": 3}
    ]
  },
  "metadata": {"team": "data"},
  "created_at": "2026-05-28T16:23:11.456+08:00",
  "updated_at": "2026-05-28T16:23:11.456+08:00",
  "archived_at": null,
  "workspace_id": "ws_xxx",
  "request_id": "req_xxx"
}

响应字段