本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。
本接口读取应用所属组织的日志,须显式授权对应敏感 Scope,不受应用成员范围过滤。用户日志、AI 日志、管理员日志权限互不包含;组织身份来自认证上下文。使用 event_id 查询单条详情;不属于当前组织或日志类型的事件返回 404。
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
Content-Type: application/json
AI 日志的 event_name 为空时省略;以下示例展示非空名称。
所需权限
| Scope | 资源服务 |
|---|---|
| admin.v1.ai-logs.read | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。
Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| event_id | path | string · uuid | 是 | 事件 ID | - |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| 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
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| action | string | 是 | 操作类型 | - |
| data | object | 是 | 日志详情数据;用户日志未采集时省略 | - |
| department_id_snapshot | string · uuid | 否 | 主要部门 ID 快照;不存在时省略 | - |
| department_name_snapshot | string | 否 | 主要部门名称快照;不存在时省略 | - |
| department_path_snapshot | string | 否 | 主要部门路径快照;不存在时省略 | - |
| department_snapshots | array<object> | 否 | 事件发生时的全部部门快照;未采集时省略 | - |
| event_id | string · uuid | 是 | 事件 ID | - |
| event_name | string | 否 | 事件名称;为空时省略 | - |
| event_time | string · date-time | 是 | 事件发生时间 | - |
| event_type | string | 是 | 事件类型;用户日志为操作事件类型,AI 日志为 ai.turn; 取值:"ai.turn" | - |
| org_id | string · uuid | 是 | 事件所属组织 ID | - |
| received_at | string · date-time | 是 | 接收时间 | - |
| result | string | 是 | 执行结果; 取值:"success"、"failure" | - |
| schema_version | integer · int64 | 是 | 事件协议版本; minimum=1; maximum=1 | - |
| session_id | string | 是 | 会话 ID;用户日志未采集时省略 | - |
| source | string | 是 | 事件来源; 取值:"pc" | - |
| source_ip | string | 是 | 来源 IP | - |
| turn_id | string | 是 | 轮次 ID | - |
| user_email_snapshot | string | null | 是 | 事件发生时的邮箱快照;可为 null | - |
| user_id | string · uuid | 是 | 用户 ID | - |
| user_name_snapshot | string | 是 | 事件发生时的用户姓名快照 | - |
data
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| artifacts | array<string> | 是 | 产物列表;无产物时为空数组 |
| calls | array<object> | 是 | 调用明细;无调用时为空数组 |
| conversation_title | string | 是 | 会话标题 |
| extensions | object | 是 | 事件扩展对象;保留当前 UI 的扩展键和值 |
| model | string | 是 | 使用的模型 |
| uploaded_file_names | array<string> | 否 | 本轮附件名称;未采集时省略,空数组表示无附件,保留顺序和重名; maxItems=100 |
data.calls[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 名称 |
| result | string | 是 | 执行结果; 取值:"success"、"failure" |
| type | string | 是 | 调用类型; 取值:"skill"、"connector"、"plugin" |
department_snapshots[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string · uuid | 是 | 标识 ID |
| name | string | 是 | 名称 |
| path | string | 是 | 部门路径 |