ListManagedAgents - 查询托管智能体列表-智能体构建和治理平台 AgentCore-阿里云帮助中心

查询指定工作空间下的托管智能体列表。

接口说明

分页查询指定工作空间下的托管智能体列表，返回每个智能体的标识、名称、状态、模板及规格等摘要信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:ListManagedAgents

list

*ManagedAgent

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/managedAgent/*

无

请求语法

GET /workspaces/{workspaceId}/managed-agents HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	工作空间 ID。	ws-1

请求参数

名称	类型	必填	描述	示例值
maxResults	integer	否	单页最大返回条数，默认 20，取值范围 1~100。	20
nextToken	string	否	分页令牌。首次调用为空，后续使用上一次响应返回的 nextToken 值。	next-token-1

返回参数

名称	类型	描述	示例值
	object
code	string	业务状态码。成功时为 SUCCESS。	SUCCESS
httpStatusCode	integer	HTTP 状态码。成功时为 200。	200
items	array<object>	托管智能体列表。	[{"agentId":"agent-xxxxxx","workspaceId":"ws-xxxxxx","agentName":"demo-agent","status":"Running","template":{"templateId":"tpl-xxxxxx","templateVersion":"v1.0.0"},"spec":{"replicas":1,"cpu":"2","memory":"4Gi"},"createTime":"2026-01-01T00:00:00Z","updateTime":"2026-01-01T00:00:00Z"}]
	array<object>
accessMode	string	入站访问方式	API_KEY
accessScope	string	用户访问范围	ALL
agentId	string	托管智能体 ID。	agent-1
createMode	string	创建模式。	Managed
createdAt	string	创建时间，RFC 3339 格式。	2026-01-01T00:00:00Z
deployType	string	部署类型。	Managed
description	string	托管智能体描述。	用于代码评审的智能体
harness	object	智能体运行框架
configuration	object	运行框架配置
connectorServiceAccountKey	string	Connector Service Account Key	key-xxxx
connectorServiceAccountName	string	Connector Service Account Name	my-connector-key
type	string	运行框架类型	qodercli
latestSpecVersion	integer	最新规格版本号。	1
name	string	托管智能体名称。	my-agent
runtime	string	运行时类型。	Managed
status	string	托管智能体状态。枚举值： Creating : 创建中 Failed : 失败 Running : 运行中 Updating : 更新中 Deleted : 已删除 Deleting : 删除中	Running
updatedAt	string	更新时间，RFC 3339 格式。	2026-01-01T00:00:00Z
workspaceId	string	工作空间 ID。	ws-1
maxResults	integer	本次请求返回的最大结果数。	20
message	string	请求处理结果消息。	success
nextToken	string	下一页的令牌。为空表示已到末尾。	next-token-1
requestId	string	请求 ID。	1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx
success	boolean	请求是否成功。	true
totalCount	integer	总记录数。	100

示例

正常返回示例

JSON格式

{
  "code": "SUCCESS",
  "httpStatusCode": 200,
  "items": [
    {
      "accessMode": "API_KEY",
      "accessScope": "ALL",
      "agentId": "agent-1",
      "createMode": "Managed",
      "createdAt": "2026-01-01T00:00:00Z",
      "deployType": "Managed",
      "description": "用于代码评审的智能体",
      "harness": {
        "configuration": {
          "connectorServiceAccountKey": "key-xxxx",
          "connectorServiceAccountName": "my-connector-key"
        },
        "type": "qodercli"
      },
      "latestSpecVersion": 1,
      "name": "my-agent",
      "runtime": "Managed",
      "status": "Running",
      "updatedAt": "2026-01-01T00:00:00Z",
      "workspaceId": "ws-1"
    }
  ],
  "maxResults": 20,
  "message": "success",
  "nextToken": "next-token-1",
  "requestId": "1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "success": true,
  "totalCount": 100
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。