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

查询agentrun的日志 -j9九游会登录

功能介绍

该接口用于查询agentrun的日志。

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::listopsagentrunlog

list

-

-

-
  • lts:logstream:searchlog
  • lts:logstream:listlogstream

uri

get /v1/ops/observation/agent-run/{agent_run_id}/log

表1 路径参数

参数

是否必选

参数类型

描述

agent_run_id

是

string

参数解释：

智能体运行id，用于标识单次智能体运行实例，可通过智能体运行记录或会话详情获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。
表2 query参数

参数

是否必选

参数类型

描述

log_type

否

string

参数解释：

日志类型。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

否

string

参数解释：

智能体类型。

约束限制：

不涉及。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

默认取值：

不涉及。

user_id

否

string

参数解释：

用户id,兼容officeclaw场景传用户id。

约束限制：

不涉及。

取值范围：

不涉及

默认取值：

不涉及。

start_time

是

string

参数解释：

开始时间，13位毫秒级时间戳（ms）。

约束限制：

由数字组成，必须为13位毫秒级时间戳。

取值范围：

不涉及。

默认取值：

不涉及。

end_time

是

string

参数解释：

结束时间，13位毫秒级时间戳（ms）。

约束限制：

由数字组成，必须为13位毫秒级时间戳。

取值范围：

不涉及。

默认取值：

不涉及。

limit

否

integer

参数解释：

每次返回的数量，用于分页查询时指定每页记录数。

约束限制：

不涉及。

取值范围：

取值范围0-1000。

默认取值：

不涉及。

scroll_id

否

string

参数解释：

分页查询滚动id，若上次查询的返回结果中包含字段scrollid，需要增加该字段参与分页查询以获取下一页数据。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

keyword

否

string

参数解释：

关键字查询，用于在日志内容中搜索包含指定关键字的日志记录。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

line_num

否

string

参数解释：

行数，首次为空，后面上一次的最后一个的line_num。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

is_desc

否

boolean

参数解释：

表示日志查询的顺序，当前支持顺序（false）或倒序查询（true）。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

count

integer

参数解释：

返回查询日志总条数。

取值范围：

取值范围0-1000000。

is_query_complete

boolean

参数解释：

是否查询出所有日志。

取值范围：

不涉及。

logs

array of agentlogcontent objects

参数解释：

日志内容。

取值范围：

不涉及。

scroll_id

string

滚动id，用于分页查询时获取下一页数据，首次查询不返回此字段。
表4 agentlogcontent

参数

参数类型

描述

content

string

参数解释：

日志内容。

取值范围：

不涉及。

line_num

string

参数解释：

日志单行序列号。

取值范围：

不涉及。

labels

map

日志标签，map类型，其中key表示标签名称，value表示标签值。

请求示例

get https://api.example.com/v1/ops/observation/agent-run/test-lw/log?log_type=agent&limit=100&start_time=1775871365836&end_time=1775874965836

响应示例

状态码：200

参数解释：

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

取值范围：

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

{
  "count" : 10,
  "is_query_complete" : true,
  "logs" : [ {
    "content" : "日志内容",
    "line_num" : "1775871365836000",
    "labels" : { }
  } ],
  "scroll_id" : "111"
}

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

错误码

请参见错误码。

父主题：

相关文档

网站地图