Skip to main content

获取AI 日志详情接口

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

本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。使用 event_id 查询单条详情;不属于当前组织或日志类型的事件返回 404。

所需权限

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

公共请求头

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

请求参数

名称位置类型必填说明示例
event_idpathstring · uuid是事件 ID-

请求示例

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

响应状态表

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

响应结果

Content-Type: application/json
名称类型必填说明示例
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"-
org_idstring · uuid是事件所属组织 ID-
received_atstring · date-time是接收时间-
resultstring是执行结果; 取值:"success"、"failure"-
schema_versioninteger · int64是事件协议版本; minimum=1; maximum=1-
session_idstring是会话 ID;用户日志未采集时省略-
sourcestring是事件来源; 取值:"pc"-
source_ipstring是来源 IP-
turn_idstring是轮次 ID-
user_email_snapshotstring | null是事件发生时的邮箱快照;可为 null-
user_idstring · uuid是用户 ID-
user_name_snapshotstring是事件发生时的用户姓名快照-

data

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

data.calls[]

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

department_snapshots[]

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

响应示例

AI 日志的 event_name 为空时省略;以下示例展示非空名称。
{
  "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": {}
  },
  "schema_version": 1,
  "received_at": "2026-10-26T08:00:01Z",
  "org_id": "33333333-3333-4333-8333-333333333333"
}