文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 智能体管理/ 查询智能体列表 - ListOpsAgentObservation
更新时间:2026-04-15 GMT+08:00
分享

查询智能体列表 - ListOpsAgentObservation

功能介绍

在观测页面查询智能体列表。

URI

GET /v1/ops/observation/agents

表1 Query参数

参数

是否必选

参数类型

描述

agent_id

String

参数解释

智能体 ID。

约束限制

不涉及。

取值范围

长度限制1-64位。

默认取值

不涉及。

page

Integer

参数解释

分页页码。

约束限制

不涉及。

取值范围

取值范围1-10000。

默认取值

不涉及。

page_size

Integer

参数解释

查询结果每页最多显示的条数。

约束限制

不涉及。

取值范围

取值范围1-1000。

默认取值

不涉及。

agent_name

String

参数解释

智能体名称。

约束限制

长度限制1-64

取值范围

不涉及。

默认取值

不涉及。

agent_type

String

参数解释

智能体类型。

约束限制

不涉及。

取值范围

  • agent:单智能体。

  • multiagents:多智能体。

  • workflow:工作流。

  • all:全部。

默认取值

agent

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

app_info_list

Array of AgentInfo objects

参数解释

智能体列表。

取值范围

不涉及。

total_count

Integer

参数解释

智能体在库总数。

取值范围

不涉及。

表4 AgentInfo

参数

参数类型

描述

agent_id

String

参数解释

智能体 ID。

取值范围

不涉及。

name

String

参数解释

智能体名称。

取值范围

不涉及。

agent_type

String

参数解释

智能体类型。

取值范围

  • agent:单智能体。

  • multiagents:多智能体。

  • workflow:工作流。

create_time

Long

参数解释

创建时间。

取值范围

不涉及。

请求示例

GET https://*.com/v1/ops/observation/agents?page=1&page_size=1000&agent_type=agent

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************

响应示例

状态码:200

查询成功。

{
  "total_count" : 1,
  "app_info_list" : [ {
    "agent_id" : "000b2b01-6279-4c7a-a4e5-08fdca69cc66",
    "agent_type" : "agent",
    "create_time" : 1775728318359,
    "name" : "testagent"
  } ]
}

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码

相关文档