文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 观测/ 日志管理/ 查询agentRun的日志 - ListOpsAgentRunLog
更新时间：2026-09-14 GMT+08:00
查看PDF
分享

查询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

参数解释：

日志类型，用来过滤日志查询中的task_type标签。

约束限制：

长度限制为1~64个字符。

取值范围：

不涉及。

默认取值：

默认为agent，查询智能体调用链相关日志。

resource_type

否

String

参数解释：

智能体类型。

约束限制：

不涉及。

取值范围：

  • agent：单智能体；

  • multiagents：多智能体；

  • workflow：工作流。

默认取值：

不涉及。

user_id

否

String

参数解释：

用户id，兼容officeclaw场景传用户id，获取方式在控制台右上角“我的凭证”中复制得到。

约束限制：

不涉及。

取值范围：

不涉及

默认取值：

不涉及。

start_time

是

String

参数解释：

查询日志的开始时间，13位毫秒级时间戳（ms）。

约束限制：

必须与end_time同时使用，start_time不能晚于end_time。

取值范围：

由数字组成的13位毫秒级时间戳。

默认取值：

不涉及。

end_time

是

String

参数解释：

查询日志的结束时间，13位毫秒级时间戳（ms）。

约束限制：

必须与start_time同时使用且end_time不能早于start_time。

取值范围：

不涉及。

默认取值：

不涉及。

limit

否

Integer

参数解释：

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

约束限制：

不涉及。

取值范围：

0~1000。

默认取值：

默认值为50。

scroll_id

否

String

参数解释：

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

约束限制：

仅在非首次分页查询时使用，值来自上次查询返回的scroll_id，为系统生成值，无需用户指定字符类型。

取值范围：

长度限制为1~64个字符。

默认取值：

不涉及。

keyword

否

String

参数解释：

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

约束限制：

长度限制为1~64个字符。

取值范围：

不涉及。

默认取值：

不涉及。

line_num

否

String

参数解释：

日志行号，用于分页查询时指定起始行位置。首次查询时无需传入，后续查询时传入上次查询结果中最后一条日志的line_num以获取下一页数据。

约束限制：

长度限制为1~64个字符。

取值范围：

不涉及。

默认取值：

不涉及。

is_desc

否

Boolean

参数解释：

表示日志查询的顺序。

约束限制：

不涉及。

取值范围：

  • true：支持倒序查询。

  • false：支持顺序查询。

默认取值：

默认值为false。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

count

Integer

参数解释：

返回查询日志总条数。

取值范围：

条数范围0~1000000。

is_query_complete

Boolean

参数解释：

是否查询出所有日志。

取值范围：

不涉及。

logs

Array of AgentLogContent objects

参数解释：

日志内容列表，元素类型为AgentLogContent对象，包含日志内容、行号、标签等信息。

取值范围：

不涉及。

scroll_id

String

参数解释：

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

取值范围：

不涉及。
表4 AgentLogContent

参数

参数类型

描述

content

String

参数解释：

日志内容。

取值范围：

不涉及。

line_num

String

参数解释：

日志单行序列号。

取值范围：

不涉及。

labels

Map<String,String>

参数解释：

日志标签，Map类型，其中key表示标签名称，类型为String，任意字符串；value表示标签值，类型为String，任意字符串。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

不涉及。

details

Array of OpsObserverCommonError objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

不涉及。
表7 OpsObserverCommonError

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：429

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

GET https://api.example.com/v1/ops/observation/agent-run/9cddb31b438f30e9/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"
}

状态码：400

参数解释：

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

取值范围：

400表示请求参数不正确。

{
  "error_code" : "AgentArts.05001003",
  "error_msg" : "请求参数不正确"
}

状态码：403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

{
  "error_code" : "AgentArts.05004003",
  "error_msg" : "权限不足，拒绝访问",
  "encode_authorization_message" : "eyJIcnJvciI6ICJVbmF1dGhvcm16ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.05001003"
  }, {
    "error_msg" : "请求参数不正确"
  } ]
}

状态码：429

参数解释：

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

取值范围：

429表示请求过多，触发流控。

{
  "error_code" : "AgentArts.05008004",
  "error_msg" : "请求过多，触发流控"
}

状态码：500

参数解释：

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

取值范围：

500表示内部服务器错误。

{
  "error_code" : "AgentArts.05005000",
  "error_msg" : "内部服务器错误"
}

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

400

参数解释：

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

取值范围：

400表示请求参数不正确。

403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

429

参数解释：

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

取值范围：

429表示请求过多，触发流控。

500

参数解释：

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

取值范围：

500表示内部服务器错误。

错误码

请参见错误码。

父主题： 日志管理

相关文档