AI 调用日志与成功率
AI 调用日志记录每次 AI 请求的动作类型、问题、数据源、Token 消耗、耗时和执行结果，用于问题追溯、成本观察与效果评估。智能助理另提供成功率报表，按场景和失败原因聚合轮次数据。
入口
| 功能 | 入口 |
|---|---|
| AI 调用日志 | 账户中心 → AI 服务 → AI 调用日志 |
| 成功率报表 | AI 助手 → 左侧配置菜单 → 成功率报表 |
两个入口都只展示当前项目的数据，由后端按项目上下文隔离，不提供跨项目汇总。
AI 调用日志
记录范围
日志由各 AI 调用链路异步写入，覆盖以下动作：
| 动作码 | 来源 | 说明 |
|---|---|---|
GENERATE | SQL 生成 | 根据问题生成 SQL 草稿 |
OPTIMIZE | SQL 优化 | 基于当前 SQL 做只读优化 |
QUERY | 自然语言问数 | 生成 SQL 并执行预览 |
INSIGHT | 结果洞察 | 对查询结果生成结论 |
AGENT_CHAT | 智能助理 | 一次对话轮次的工具调用与回答 |
AGENT_CONFIRM | 智能助理 | 用户确认敏感操作后的续跑轮次 |
AGENT_TURN | 智能助理观测 | 轮次汇总行，成功率报表的数据来源 |
SEMANTIC_RESOLVE | 观测埋点 | 语义层解析 |
LLM_STEP | 观测埋点 | 单步模型调用 |
SQL_GEN | 观测埋点 | 场景内的 SQL 生成阶段 |
ANSWER_GEN | 观测埋点 | 场景内的回答生成阶段 |
CLOSURE_REPAIR | 智能助理 | 消息序列闭合修复告警，success=0 便于监测 |
列表中的动作显示
列表的「操作类型」筛选只提供“全部 / 生成 / 优化 / 查询”，映射到 SQL 相关的三种动作。AGENT_*、INSIGHT 等动作仍会出现在列表中，但以原始动作码展示，且无法通过该下拉框单独筛选。
列表字段
| 列 | 含义 |
|---|---|
| 用户ID | 发起调用的用户编号 |
| 操作类型 | 动作码；生成/优化/查询会显示为标签 |
| 问题 | 用户输入的问题文本 |
| 数据源类型 | 本次调用的数据源类型 |
| Token 消耗 | total_tokens，Prompt 与 Completion 之和 |
| 耗时(ms) | 本次调用耗时；500–999ms 显示橙色，≥1000ms 显示红色 |
| 结果 | 成功显示绿色，失败显示红色 |
| 调用时间 | 日志创建时间 |
筛选与分页
- 关键字：按问题内容模糊匹配；
- 操作类型：全部、生成、优化、查询；
- 时间范围：近一小时、近 24 小时、近七天快捷选项，或自定义起止时间；
- 点击「查询」按当前条件重新加载，页码回到第 1 页。
分页默认每页 10 条，可切换 10 / 20 / 50 / 100，后端单页上限为 100。
设计逻辑
- 异步写入：日志在请求线程中组装项目、用户和问题等信息，再交由
aiAuditExecutor线程池插入，写入失败只记录告警，不影响主业务流程； - 项目固化：异步线程不继承项目上下文，因此
projectId必须在请求线程内写入日志实体； - 文本裁剪：问题、当前 SQL、生成 SQL 等长文本最多保存 4000 字符，错误信息最多 500 字符，避免单条日志过大；
- 前端不展示的字段：表中还保存会话 ID、轮次 ID、命中场景、实际模型、模式、生成 SQL、Schema、参考表、工具调用链、Prompt/Completion Token、首事件耗时和失败原因。这些字段用于排查与报表，当前页面不展示，可按需在数据库中查看；
- 无自动清理：当前没有日志归档或定期清理任务，日志会持续累积。生产环境应结合数据库容量制定保留策略，或在数据库侧做分区/归档。
排查建议
| 现象 | 先看什么 |
|---|---|
| 某次 AI 请求失败 | 「结果」为失败的行，结合数据库中的 error_msg、fail_reason 定位 |
| 响应慢 | 耗时列高亮的记录；结合 first_event_ms 判断是首字节慢还是整体慢 |
| Token 成本升高 | 按问题关键字和时间范围筛选，观察 total_tokens 分布 |
| 智能助理操作未生效 | 查看 AGENT_CHAT / AGENT_CONFIRM 记录及工具调用链 |
成功率报表
成功率报表位于 AI 助手左侧配置菜单，按场景 + 失败原因聚合 AGENT_TURN 轮次，用于观察智能助理的回答质量。
使用方式
- 在 AI 助手页面打开左侧配置菜单；
- 选择「成功率报表」；
- 可选选择日期范围（按天，包含起止当天）；
- 点击「查询」刷新数据。
不选择日期时统计全部历史数据。
报表字段
| 列 | 说明 |
|---|---|
| 场景 | 命中的场景编码，同一场景可能有多行 |
| 失败原因 | 成功行显示“成功”标签，失败行显示超时、限流、工具失败等原因 |
| 次数 | 该场景 + 失败原因组合的轮次总数 |
| 场景成功率 | 该场景所有分组的成功数之和 ÷ 总轮次 |
| 平均 Tokens | 该分组的平均总 Token |
| 平均耗时(ms) | 该分组的平均耗时 |
场景成功率按颜色分级：≥90% 绿色，≥70% 橙色，低于 70% 红色。
失败原因对照
| 原因码 | 含义 |
|---|---|
MODEL_TIMEOUT | 模型调用超时 |
MODEL_429 | 模型服务限流 |
MODEL_ERROR | 模型返回错误 |
TOOL_ERROR | 工具执行失败 |
USER_REJECTED | 用户拒绝确认 |
EXPIRED | 确认已过期 |
CANCELLED | 用户取消 |
STEP_LIMIT | 超过最大推理步数 |
设计逻辑
- 报表只聚合
AGENT_TURN汇总行，普通 SQL 生成/优化日志不会进入统计； - 场景成功率不是取单行数值，而是把同一场景下所有失败原因分组的成功数与总数分别求和后计算，避免分组失真；
- 平均 Tokens 与平均耗时由数据库聚合，前端只做展示与颜色分级；
- 报表与日志同为项目隔离，且报表接口要求智能助理功能已启用。
限制与注意事项
- 日志写入是异步的，刚完成的调用可能延迟数秒才出现在列表中；
- 日志记录的是调用元数据，不包含完整的模型请求体和响应体；
- 问题文本可能包含业务数据，应按敏感信息管理日志库的访问权限；
- 项目切换后日志范围随之切换，历史项目数据不会混入当前项目；
CLOSURE_REPAIR属于异常告警记录，出现时建议排查消息持久化链路，而不是当作普通用户操作。