Skip to main content

查询AI 日志接口

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。业务字段、筛选和返回结构与控制台一致。查询及导出最多七个自然日;用户日志 VPC 保留 90 天、K8S 保留 180 天,AI 日志保留 90 天。时间窗口由服务端按保留期截断,返回 effective_from/effective_to。

所需权限

Scope资源服务
admin.v1.ai-logs.readqwenwork-biz-service
GET /api/openapi/v1/ai-logs

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。 Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

名称位置类型必填说明示例
user_namequerystring否用户姓名筛选; maxLength=200-
auxiliary_identifierquerystring否辅助标识类型;与辅助标识值配合使用; maxLength=200-
auxiliary_valuequerystring否辅助标识值;提供时必须指定 EMAIL、PHONE、EMPLOYEE_NO 或 ACCOUNT 类型; maxLength=200-
session_idquerystring否会话 ID;用户日志未采集时省略; maxLength=200-
turn_idquerystring否轮次 ID; maxLength=200-
conversation_titlequerystring否会话标题; maxLength=200-
qquerystring否搜索关键词; maxLength=200-
resultquerystring否执行结果; 取值:"success"、"failure"-
rangequerystring否默认查询最近七个自然日;提供 from/to 时忽略此项; default="last7"; 取值:"last7"-
fromquerystring · date-time否起始时间;必须与 to 一起提供,最多七个自然日-
toquerystring · date-time否结束时间;必须晚于 from;窗口按 UI 保留期截断-
department_idquerystring · uuid否部门 ID 筛选-
pagequeryinteger · int64否页码,从 1 开始; minimum=1; default=1-
page_sizequeryinteger · int64否每页条数; default=20; 取值:10、20、50、100-
timezonequerystring否IANA 时区;省略时使用 UTC; maxLength=64-

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl '<BASE_URL>/api/openapi/v1/ai-logs' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取结果。
401身份认证失败见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构检查状态与 code;修正参数或授权,503 可稍后重试。
403缺少对应 Scope 或可信身份无效见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构检查状态与 code;修正参数或授权,503 可稍后重试。
422请求字段或时间窗口无效见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构检查状态与 code;修正参数或授权,503 可稍后重试。
503上游或审计依赖不可用见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构检查状态与 code;修正参数或授权,503 可稍后重试。
default其他认证、业务或依赖错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构检查状态与 code;修正参数或授权,503 可稍后重试。

响应结果

Content-Type: application/json
名称类型必填说明示例
effective_fromstring · date-time是实际生效的查询起始时间-
effective_tostring · date-time是实际生效的查询结束时间-
itemsarray<object>是结果列表;无结果时为空数组-
pageinteger · int64是页码,从 1 开始-
page_sizeinteger · int64是每页条数-
totalinteger · int64是符合筛选条件的总条数-

items[]

字段类型必填说明
actionstring是操作类型
dataobject是日志详情数据;用户日志未采集时省略
department_id_snapshotstring · uuid否主要部门 ID 快照;不存在时省略
department_name_snapshotstring否主要部门名称快照;不存在时省略
department_path_snapshotstring否主要部门路径快照;不存在时省略
department_snapshotsarray<object>否事件发生时的全部部门快照;未采集时省略
event_idstring · uuid是事件 ID
event_namestring否事件名称;为空时省略
event_timestring · date-time是事件发生时间
event_typestring是事件类型;用户日志为操作事件类型,AI 日志为 ai.turn; 取值:"ai.turn"
resultstring是执行结果; 取值:"success"、"failure"
session_idstring是会话 ID;用户日志未采集时省略
sourcestring是事件来源; 取值:"pc"
source_ipstring是来源 IP
turn_idstring是轮次 ID
user_email_snapshotstring | null是事件发生时的邮箱快照;可为 null
user_idstring · uuid是用户 ID
user_name_snapshotstring是事件发生时的用户姓名快照

items[].data

字段类型必填说明
artifactsarray<string>是产物列表;无产物时为空数组
callsarray<object>是调用明细;无调用时为空数组
conversation_titlestring是会话标题
extensionsobject是事件扩展对象;保留当前 UI 的扩展键和值
modelstring是使用的模型
uploaded_file_namesarray<string>否本轮附件名称;未采集时省略,空数组表示无附件,保留顺序和重名; maxItems=100

items[].data.calls[]

字段类型必填说明
namestring是名称
resultstring是执行结果; 取值:"success"、"failure"
typestring是调用类型; 取值:"skill"、"connector"、"plugin"

items[].department_snapshots[]

字段类型必填说明
idstring · uuid是标识 ID
namestring是名称
pathstring是部门路径

响应示例

AI 日志的 event_name 为空时省略;以下示例展示非空名称。
{
  "items": [
    {
      "event_id": "11111111-1111-4111-8111-111111111111",
      "event_time": "2026-10-26T08:00:00Z",
      "user_id": "22222222-2222-4222-8222-222222222222",
      "user_name_snapshot": "Alice",
      "user_email_snapshot": null,
      "result": "success",
      "source_ip": "192.0.2.1",
      "event_type": "ai.turn",
      "event_name": "Turn completed",
      "session_id": "session-1",
      "turn_id": "turn-1",
      "source": "pc",
      "action": "ai.turn.complete",
      "data": {
        "conversation_title": "Audit review",
        "model": "model-example",
        "calls": [
          {
            "type": "skill",
            "name": "Research",
            "result": "success"
          }
        ],
        "artifacts": [
          "report.md"
        ],
        "uploaded_file_names": [
          "input.txt"
        ],
        "extensions": {}
      }
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20,
  "effective_from": "2026-10-26T00:00:00Z",
  "effective_to": "2026-10-26T08:30:00Z"
}