ListExperimentPlans - 查询实验计划列表-Agent 观测与优化 AgentLoop(AgentLoop)-阿里云帮助中心

接口说明

调用 ListExperimentPlans 查询当前账号在指定 AgentSpace 下的实验计划列表。支持按计划名称模糊搜索、按状态过滤，并使用 offset/limit 分页。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

agentloop:ListExperimentPlans

list

*Workspace

acs:agentloop:{#regionId}:{#accountId}:agentspace/{#AgentSpaceName}

无

请求语法

GET /api/v1/experiments/{agentSpace}/plans HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
agentSpace	string	否	AgentSpace 名称。	al-playground-cn-hongkong

请求参数

名称	类型	必填	描述	示例值
planName	string	否	按计划名称模糊搜索。	arms_agent
status	string	否	按状态精确过滤。枚举值： running : running stopped : stopped pending : pending	pending
offset	integer	否	偏移量，默认 0。	0
limit	integer	否	返回条数，默认 20。	20
maxResults	integer	否	可选。分页请优先使用 `offset` 与 `limit`。	20
nextToken	string	否	可选。分页请优先使用 `offset` 与 `limit`。	eyJsYXN0SWQiOjEyM30=

分页请使用 offset 与 limit。结果按创建时间倒序。

返回参数

名称	类型	描述	示例值
	object	实验计划列表响应。
requestId	string	请求 ID。	3FE4CD1E-FF41-56BE-B590-7A021D9C1524
total	integer	符合条件的总记录数。	6
page	integer	页码信息。	0
pageSize	integer	每页条数。	20
plans	array	实验计划摘要列表。	[{"planId": "exp-plan-e95bff54685a4ae29ff3a834c1008a71", "planName": "rca_benchmark_eval_experiment", "experimentType": "offline", "description": "", "status": "pending", "datasetId": "rca_benckmark_eval", "querySql": "", "experimentCount": 5, "createdAt": 1784612365000, "updatedAt": 1784619562000}, {"planId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e", "planName": "arms_agent_experiment", "experimentType": "online", "description": "", "status": "stopped", "datasetId": "arms_customer_agent_level1", "querySql": "", "experimentCount": 4, "createdAt": 1784257858000, "updatedAt": 1784721811000}, {"planId": "b7f0ad3d-3765-446a-a744-ab64ab8bf386", "planName": "arms_customer_agent_plan", "experimentType": "offline", "description": "", "status": "stopped", "datasetId": "arms_customer_agent_level1", "querySql": "where \"input\" LIKE '%探针%'", "experimentCount": 65, "createdAt": 1782310430000, "updatedAt": 1784692254000}]
	ExperimentPlanData	单个实验计划摘要对象。
maxResults	integer	最大返回条数。	20
nextToken	string	下一页 Token。	eyJsYXN0SWQiOjEwMX0=

列表不返回完整 experiments 与 datasetProject。需要完整配置时请调用 GetExperimentPlan。\n\njson\n{ "total": 6, "plans": [ { "planId": "exp-plan-e95bff54685a4ae29ff3a834c1008a71", "planName": "rca_benchmark_eval_experiment", "experimentType": "offline", "description": "", "status": "pending", "datasetId": "rca_benckmark_eval", "querySql": "", "experimentCount": 5, "createdAt": 1784612365000, "updatedAt": 1784619562000 }, { "planId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e", "planName": "arms_agent_experiment", "experimentType": "online", "description": "", "status": "stopped", "datasetId": "arms_customer_agent_level1", "querySql": "", "experimentCount": 4, "createdAt": 1784257858000, "updatedAt": 1784721811000 }, { "planId": "b7f0ad3d-3765-446a-a744-ab64ab8bf386", "planName": "arms_customer_agent_plan", "experimentType": "offline", "description": "", "status": "stopped", "datasetId": "arms_customer_agent_level1", "querySql": "where \"input\" LIKE '%探针%'", "experimentCount": 65, "createdAt": 1782310430000, "updatedAt": 1784692254000 } ] }\n

示例

正常返回示例

JSON格式

{
  "requestId": "3FE4CD1E-FF41-56BE-B590-7A021D9C1524",
  "total": 6,
  "page": 0,
  "pageSize": 20,
  "plans": [
    {
      "planId": "",
      "planName": "",
      "experimentType": "",
      "description": "",
      "status": "",
      "datasetId": "",
      "querySql": "",
      "experimentCount": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
  ],
  "maxResults": 20,
  "nextToken": "eyJsYXN0SWQiOjEwMX0="
}

错误码

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

变更历史

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