意图审计事件字段说明面向需要编写自定义查询、理解意图审计数据结构或对接外部分析系统的用户。本文说明用户意图识别结果表 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 和高保真安全事件。
通用字段
以下字段同时出现在普通意图和风险意图记录中。
字段 | 类型 | 说明 |
| string | 意图识别结果的稳定主键,适合用于去重、幂等写入和外部系统引用。 |
| string | 意图来源。默认用户意图取 |
| enum | 结果类型。普通意图取 |
| int64 | 代表性用户输入事件的纳秒级 Unix 时间戳。 |
| enum | 固定为 |
| string | Agent 应用或服务名称。 |
| string | Agent 类型,当前为 |
| string | 用户实体的平铺查询列,优先取自 |
| string | 主机实体的平铺查询列,优先取自 |
| string | Agent 主机 IP 实体的平铺查询列,优先取自 |
| object[] | 关联实体快照,保留用户、主机、Agent 主机 IP 等实体,用于多实体关系和精确实体反查。 |
| string | 对当前意图分类的简要中文说明。 |
| int64 | 按意图占比分配的 Session Token 数。一个 Session 各意图的该字段之和等于该 Session 的总 Token 数。 |
| string | 代表当前意图的一条真实用户输入事件 ID。 |
| string | 当前意图所属的 Session ID,用于会话下钻和聚合。 |
| enum | 审计结果表的通用可空字段。用户意图不表示具体操作,因此该字段为空;风险意图不代表相关操作已发起或已执行。 |
| string | 生成结果的检测器或服务名称。 |
| string | 生成结果的检测器版本。 |
user、host 和 source_ip 是常用实体的平铺查询列,适合直接筛选和分组。多实体关系和精确实体反查仍应使用 entities。历史记录无法提取对应值时,这些平铺列可为空。
普通意图字段
普通意图记录满足 event_domain=user_intent,并使用以下分类字段:
字段 | 类型 | 说明 |
| string | 普通意图领域,例如软件工程、数据与分析、运维与平台、产品与业务等。 |
| string | 普通意图类型,例如编码开发、数据分析、运维排障或产品规划。 |
普通意图不写入 risk_type、risk_subtype 和 severity。缺少这些风险字段表示当前记录是普通工作意图,不表示数据不完整。
风险意图字段
风险意图记录满足 event_domain=security,并使用以下风险字段:
字段 | 类型 | 说明 |
| string | 安全风险大类,例如 |
| string |
|
| enum | 风险意图严重性,取 |
| string[] | 当前为空数组。用户意图识别直接分析原始会话,不依赖 |
风险意图不写入 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 已经获取凭证。
查询建议
场景 | 建议条件或字段 | 说明 |
查询全部意图结果 |
| 同时查询默认和自定义用户意图,排除 |
只查询普通意图 |
| 使用 |
只查询风险意图 |
| 使用完整的 |
按用户分析 |
| 直接使用平铺查询列筛选或分组;需要完整实体关系时再解析 |
按主机分析 |
| 分别按 Agent 运行主机和 Agent 主机 IP 筛选或分组。 |
回查原始用户输入 |
| 在 |
回查完整会话 |
| 在 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')
)
与其他审计数据的关系
数据 | 关系 |
| 用户意图识别的原始应用侧会话数据。 |
| 规则型低保真安全发现。用户意图识别不依赖该表。 |
| 高保真安全事件,用于确认已经发生的风险动作或数据暴露。 |
| 多类审计结果共用的 Logstore。意图记录同时保存普通意图和风险意图;其他 |