j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / 查询智能体列表 - listopsagent
更新时间：2026-07-08 gmt 08:00
查看pdf

查询智能体列表 -j9九游会登录

功能介绍

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

调用方法

请参见如何调用api。

授权信息

当前api调用无需身份策略权限。

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：全部。

默认取值：

不涉及。

source

否

string

参数解释：

来源。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

time_order

否

boolean

参数解释：

默认创建时间倒序排列。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start_time

否

long

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

unix时间戳，单位为ms。

end_time

否

long

参数解释：

截止时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

unix时间戳，单位为ms。

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

app_info_list

array of agentinfo objects

参数解释：

智能体列表。

取值范围：

不涉及。

total_count

integer

参数解释：

智能体在库总数。

取值范围：

不涉及。
表3 agentinfo

参数

参数类型

描述

source

string

参数解释：

智能体来源。

取值范围：

  • studio

  • agentrun

  • api

agent_id

string

参数解释：

智能体id。

取值范围：

不涉及。

name

string

参数解释：

智能体名称。

取值范围：

不涉及。

agent_type

string

参数解释：

智能体类型。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

create_time

long

参数解释：

创建时间。

取值范围：

不涉及。

total_token

double

参数解释：

按照给定时间计算出tokens消耗。

取值范围：

不涉及。

avg_request_count

double

参数解释：

平均请求次数 单位为分钟。

取值范围：

不涉及。

avg_duration_time

double

参数解释：

平均延迟时间 延迟时间总和除以次数。

取值范围：

不涉及。

avg_fail_count

double

参数解释：

平均请求失败次数 单位为分钟。

取值范围：

不涉及。

apm_app_id

string

参数解释：

apm的app_id，非必填。

取值范围：

不涉及。

aom_prom_id

string

参数解释：

aom的app_id，非必填。

取值范围：

不涉及。

apm_app_token

string

参数解释：

apm token，加密存储，非必填。

取值范围：

不涉及。

aom_access_code

string

参数解释：

aom access_code，加密存储，非必填。

取值范围：

不涉及。

lts_group_id

string

参数解释：

lts_group_id，非必填。

取值范围：

不涉及。

lts_stream_id

string

参数解释：

lts_stream_id，非必填。

取值范围：

不涉及。

lts_label_name

string

参数解释：

用于过滤lts日志标签。

取值范围：

不涉及。

apm_exporter_endpoint

string

参数解释：

apm上报地址。

取值范围：

不涉及。

aom_exporter_endpoint

string

参数解释：

aom上报地址。

取值范围：

不涉及。

deleted

integer

参数解释：

是否被刪除。

取值范围：

不涉及。

请求示例

get https://api.example.com/v1/ops/observation/agents?page=1&page_size=1000&agent_type=agent

响应示例

状态码：200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

200表示成功，其他值表示失败，具体参见错误码文档。

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

状态码

状态码

描述

200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

200表示成功，其他值表示失败，具体参见错误码文档。

错误码

请参见错误码。

父主题：

相关文档

网站地图