意图审计事件字段说明

更新时间:
复制 MD 格式

意图审计事件字段说明面向需要编写自定义查询、理解意图审计数据结构或对接外部分析系统的用户。本文说明用户意图识别结果表 audit-event 的字段含义,以及普通意图和风险意图的不同字段形态。字段和值可能随产品演进扩展,请以控制台展示和实际返回结果为准。

说明:本文中的示例值均为脱敏或合成内容,用于说明字段形态和数据语义,不代表真实用户数据,也不等同于完整识别条件。

表概述

用户意图识别从应用侧 agent-event 和 agent-event-webtracking 中读取用户会话,提取 Turn 起始位置的用户输入,再按用户和 Session 归纳主要意图。

识别结果写入 audit-event,每个意图对应一行记录。一个 Session 可以包含多个普通意图和风险意图,每条记录都引用一条代表性用户输入事件,并保留整个 Session 的关联标识。

audit-event 是多类审计结果共用的 Logstore。除意图识别结果外,其中还可能包含 event_domain=agent_context 的 Agent 上下文事实,例如 event_name=skill.read 的 Skill 读取记录。本文仅说明 event_name 为 intent.user_intent 或 intent.custom_user_intent 的意图记录;查询时应先按 event_name 限定范围。

普通意图描述用户使用 Agent 完成的工作,例如编码开发、数据分析或运维排障。风险意图描述用户明确表达的异常或恶意目标,例如越狱尝试、敏感信息窃取或外部数据外传。风险意图不证明 Agent 已经完成对应动作,确认实际副作用时需要继续回查 Session 和高保真安全事件。

通用字段

以下字段同时出现在普通意图和风险意图记录中。

字段

类型

说明

audit_event_id

string

意图识别结果的稳定主键,适合用于去重、幂等写入和外部系统引用。

event_name

string

意图来源。默认用户意图取 intent.user_intent,自定义用户意图取 intent.custom_user_intent。普通和风险结果保持相同的来源值。

event_domain

enum

结果类型。普通意图取 user_intent,风险意图取 security。

time_unix_nano

int64

代表性用户输入事件的纳秒级 Unix 时间戳。

source_scope

enum

固定为 application,表示结果来自应用侧会话数据。

service_name

string

Agent 应用或服务名称。

agent_type

string

Agent 类型,当前为 qoder。

user

string

用户实体的平铺查询列,优先取自 user.id。

host

string

主机实体的平铺查询列,优先取自 host.name;host.name 为空或缺失时,兼容使用 __tag__:__hostname__。

source_ip

string

Agent 主机 IP 实体的平铺查询列,优先取自 host.ip;host.ip 为空或缺失时,兼容使用 __source__。该字段不表示网络对端或外联目标。

entities

object[]

关联实体快照,保留用户、主机、Agent 主机 IP 等实体,用于多实体关系和精确实体反查。

reason

string

对当前意图分类的简要中文说明。

usage_total_tokens

int64

按意图占比分配的 Session Token 数。一个 Session 各意图的该字段之和等于该 Session 的总 Token 数。

evidence_event_id

string

代表当前意图的一条真实用户输入事件 ID。

evidence_session_id

string

当前意图所属的 Session ID,用于会话下钻和聚合。

operation_stage

enum

审计结果表的通用可空字段。用户意图不表示具体操作,因此该字段为空;风险意图不代表相关操作已发起或已执行。

detector_name

string

生成结果的检测器或服务名称。

detector_version

string

生成结果的检测器版本。

user、host 和 source_ip 是常用实体的平铺查询列,适合直接筛选和分组。多实体关系和精确实体反查仍应使用 entities。历史记录无法提取对应值时,这些平铺列可为空。

普通意图字段

普通意图记录满足 event_domain=user_intent,并使用以下分类字段:

字段

类型

说明

intent_category

string

普通意图领域,例如软件工程、数据与分析、运维与平台、产品与业务等。

intent_subcategory

string

普通意图类型,例如编码开发、数据分析、运维排障或产品规划。

普通意图不写入 risk_type、risk_subtype 和 severity。缺少这些风险字段表示当前记录是普通工作意图,不表示数据不完整。

风险意图字段

风险意图记录满足 event_domain=security,并使用以下风险字段:

字段

类型

说明

risk_type

string

安全风险大类,例如 credential_access。

risk_subtype

string

risk_type 下的安全风险子类,例如 private_key_read。

severity

enum

风险意图严重性,取 critical、high、medium 或 low。

evidence_security_event_ids

string[]

当前为空数组。用户意图识别直接分析原始会话,不依赖 security-event。

风险意图不写入 intent_category 和 intent_subcategory。使用风险意图结果时,应结合 event_domain、risk_type 和 risk_subtype 判断,不要把缺少普通意图字段解释为数据异常。

默认用户意图和自定义用户意图使用同一套安全风险两级分类。两者只通过 event_name 区分来源,风险严重性和占比含义相同。风险分类与安全检测一致,但风险意图只表示用户表达的目标,不代表对应动作已经发生。

历史风险意图

升级前写入的历史记录使用 risk_type=user_intent_risk,并保留原有 11 个 risk_subtype。控制台继续按原中文名称展示、查询和筛选这些记录,不会自动转换成新的安全风险分类。查询跨越升级时间点时,应始终按完整的 risk_type + risk_subtype 组合聚合;即使新旧记录的 risk_subtype 文本相同,也不能合并。

事件示例

以下示例只展示意图审计常用字段。

普通意图

{
  "audit_event_id": "intent-demo-normal-001",
  "event_name": "intent.user_intent",
  "event_domain": "user_intent",
  "time_unix_nano": 1786208400000000000,
  "source_scope": "application",
  "service_name": "ai-coding-agent-qoder",
  "agent_type": "qoder",
  "user": "user-demo-001",
  "host": "demo-host",
  "source_ip": "10.0.1.42",
  "intent_category": "software_engineering",
  "intent_subcategory": "coding",
  "reason": "用户主要要求 Agent 完成接口开发和代码调整。",
  "usage_total_tokens": 8400,
  "evidence_event_id": "evt-user-query-001",
  "evidence_session_id": "session-demo-001",
  "entities": [
    {
      "type": "user",
      "id": "user-demo-001",
      "display_name": "示例用户"
    }
  ]
}

风险意图

{
  "audit_event_id": "intent-demo-risk-001",
  "event_name": "intent.user_intent",
  "event_domain": "security",
  "time_unix_nano": 1786208460000000000,
  "source_scope": "application",
  "service_name": "ai-coding-agent-qoder",
  "agent_type": "qoder",
  "user": "user-demo-001",
  "host": "demo-host",
  "source_ip": "10.0.1.42",
  "risk_type": "credential_access",
  "risk_subtype": "private_key_read",
  "severity": "high",
  "reason": "用户明确要求获取不属于当前任务范围的访问凭证。",
  "usage_total_tokens": 3600,
  "evidence_event_id": "evt-user-query-002",
  "evidence_session_id": "session-demo-001",
  "evidence_security_event_ids": [],
  "entities": [
    {
      "type": "user",
      "id": "user-demo-001",
      "display_name": "示例用户"
    }
  ]
}

这两个示例来自同一个 Session,意图占比合计为 100%,分配的 Token 数合计等于 Session Token 总数。风险意图只证明用户表达了风险目标,不代表 Agent 已经获取凭证。

查询建议

场景

建议条件或字段

说明

查询全部意图结果

event_name IN ('intent.user_intent', 'intent.custom_user_intent')

同时查询默认和自定义用户意图,排除 audit-event 中其他类型的审计结果。

只查询普通意图

event_domain = 'user_intent'

使用 intent_category 和 intent_subcategory 聚合。

只查询风险意图

event_domain = 'security'

使用完整的 risk_type、risk_subtype 和 severity 聚合。

按用户分析

user

直接使用平铺查询列筛选或分组;需要完整实体关系时再解析 entities。

按主机分析

host、source_ip

分别按 Agent 运行主机和 Agent 主机 IP 筛选或分组。

回查原始用户输入

evidence_event_id

在 agent-event 和 agent-event-webtracking 中定位代表性用户输入事件。

回查完整会话

evidence_session_id

在 Session 浏览中查看同一会话的用户输入、模型响应和工具行为。

风险分布应同时按风险大类和风险子类聚合:

GROUP BY risk_type, risk_subtype

筛选多个风险分类时,应按完整的风险大类和风险子类组合生成条件,不能分别对两个字段使用独立的 IN:

(
  (risk_type = 'credential_access' AND risk_subtype = 'private_key_read')
  OR
  (risk_type = 'user_intent_risk' AND risk_subtype = 'jailbreak')
)

与其他审计数据的关系

数据

关系

agent-event / agent-event-webtracking

用户意图识别的原始应用侧会话数据。

security-event

规则型低保真安全发现。用户意图识别不依赖该表。

incident-event

高保真安全事件,用于确认已经发生的风险动作或数据暴露。

audit-event

多类审计结果共用的 Logstore。意图记录同时保存普通意图和风险意图;其他 event_domain 可以保存 Agent 上下文等非意图事实。