AI 产品埋点模板

事件总表

事件名	触发时机	关键字段	用途
ai_task_submitted	用户提交任务	task_id、user_id、input_type、scene	计算任务量和入口转化
ai_context_built	上下文装配完成	context_tokens、file_count、retrieval_count	判断上下文是否过长或缺资料
ai_model_completed	模型返回结果	model、input_tokens、output_tokens、latency_ms、cost	监控成本、时延、模型表现
ai_tool_called	调用外部工具	tool_name、tool_type、permission_level、success	观察工具链稳定性
ai_rag_retrieved	RAG 召回完成	query、top_k、hit_count、rerank_score	评估召回和重排
ai_output_accepted	用户采纳输出	output_type、edit_distance、next_action	判断真实可用性
ai_handoff_triggered	转人工或人工确认	reason、risk_level、operator_id	分析失败和风险
ai_badcase_reported	用户或审核标记失败	badcase_type、expected_behavior	进入评测集和迭代闭环

字段	说明
event_name	事件名
task_id	一次用户任务的唯一 ID
trace_id	一次 Agent/RAG/模型链路的追踪 ID
user_id	用户 ID，注意脱敏
scene	业务场景，如客服、PRD、数据分析
input_type	文本、文件、图片、表格、网页、代码
model	模型名或模型分级
prompt_version	Prompt 版本
rag_index_version	知识库索引版本
tool_name	工具名
permission_level	read、write_with_approval、write_direct
success	true / false
error_type	model_error、tool_error、permission_error、parse_error、timeout、no_evidence
latency_ms	耗时
input_tokens	输入 token
output_tokens	输出 token
cached_tokens	缓存命中 token
cost	估算成本
user_action	复制、编辑、采纳、拒绝、转人工、重新生成