文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 日志管理/ 查询agentRun的日志 - ListOpsAgentRunLog
更新时间:2026-05-21 GMT+08:00
分享

查询agentRun的日志 - ListOpsAgentRunLog

功能介绍

该接口用于查询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位。

取值范围

不涉及。

默认取值

不涉及。

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位。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及。

取值范围:

application/json。

默认取值:

application/json。

Authorization

String

参数解释:

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

约束限制:

SDK自动填充,格式为SDK-HMAC-SHA256。

取值范围:

符合签名规范的字符串。

默认取值:

不涉及。

X-Sdk-Date

String

参数解释:

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

约束限制:

符合ISO 8601格式。

取值范围:

格式为YYYYMMDDTHHMMSSZ,如20240416T095341Z。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

count

Integer

参数解释

返回查询日志总条数。

取值范围

取值范围0-1000000。

is_query_complete

Boolean

参数解释

是否查询出所有日志。

取值范围

不涉及。

logs

Array of AgentLogContent objects

参数解释

日志内容。

取值范围

不涉及。

scroll_id

String

滚动ID,用于分页查询时获取下一页数据,首次查询不返回此字段。

表5 AgentLogContent

参数

参数类型

描述

content

String

参数解释

日志内容。

取值范围

不涉及。

line_num

String

参数解释

日志单行序列号。

取值范围

不涉及。

labels

Map<String,String>

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

请求示例

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

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

响应示例

状态码:200

参数解释

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

取值范围

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

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

状态码

状态码

描述

200

参数解释

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

取值范围

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

错误码

请参见错误码

相关文档