Skip to main content

获取 Subagent

获取单个子 Agent 的详情,查看父 Agent、公开指令和生命周期状态。

接口

GET /agents/sessions/{session_id}/subagents/{subagent_id} 成功返回 200,响应体是单个 Subagent。查询不启动或恢复子 Agent,也不创建资源。

路径参数

session_id string (必选)Session ID,例如 sess_xxxsubagent_id string (必选)稳定的子 Agent ID,例如 subagent_xxx路径上下级必须匹配。子 Agent 不属于该 Session,或跨工作空间时不会返回数据。

请求示例

curl "$BASE_URL/agents/sessions/sess_xxx/subagents/subagent_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应字段

id string稳定的子 Agent IDobject stringSubagent 对象类型,固定为 agent.session.subagentsession_id string所属 Sessionparent_agent_id string父 Agentname string / null展示名instructions array / null公开指令内容status stringSubagent 状态:active 或 closedopened_at integer打开时间,Unix 秒closed_at integer / null关闭时间,Unix 秒;未关闭时为 nullactive 可以空闲等待,不表示持续运行。closed_at 在未关闭时为 null。

响应示例

{
  "id": "subagent_xxx",
  "object": "agent.session.subagent",
  "session_id": "sess_xxx",
  "parent_agent_id": "agent_xxx",
  "name": "researcher",
  "instructions": null,
  "status": "active",
  "opened_at": 1794118835,
  "closed_at": null
}

错误码

HTTP 状态码错误类型 / 错误码解决方案
404not_found_error / not_found_error确认 Session、Subagent 存在且属于同一工作空间,并使用匹配的路径层级
502server_error / agents_api_upstream_unavailable稍后重试;持续失败时提交工单并提供响应头中的 x-request-id