作用看板已全新升级,选对视图决定了你看到的是当期汇总还是变化趋势。
操作进入腾讯云代码助手管理端,选择 数据统计 > 研效看板。看板支持指标视图和趋势视图两种方式切换查看;若需要查看更新前的历史数据,需切换到旧看板。两类视图下都包含活跃情况、对话指标、补全指标、代码生成指标四类指标参数,每个指标都有详细的计算方式介绍。
注意升级后指标口径可能有变化,跨版本对比数据前先确认两段时间是否落在同一版看板口径内。


作用活跃数据回答「有多少人在用」,对话数据回答「用得多深」,是评估推广效果的第一步。
操作在活跃情况分类中查看活跃用户数量、补全活跃用户数量、对话活跃用户数量三个指标,并观察各 IDE 的活跃数量占比;在对话指标分类中查看对话次数、对话使用指令次数、对话引用上下文次数、对话使用智能体次数、对话使用知识库次数、对话中代码段操作次数六个指标。
注意对话引用上下文次数统计的是通过 @ 引用的次数,上下文明细类型包括文件、文件夹、Diff 文件、变更、知识库、终端命令等,不同团队的引用习惯会显著影响该数值。

作用这两类指标直接关联企业最关心的提效成果,也是投产比测算的依据。
操作补全指标分为按次统计、按行统计和按字符统计三种口径,每种口径下都包含生成与采纳两类指标,且支持按语言展示与分析;代码生成指标分为按行统计和按字符统计两种口径,支持按语言、代码生成方式、客户端名称、客户端版本或插件版本展示。趋势视图中各指标与指标视图一一对应,例如可查看本月各 IDE 活跃数量的趋势线,或各语言下的指标趋势线。
注意代码生成率按行为 20% 代表统计时间段内每 100 行代码中有 20 行由代码助手生成;按字符为 20% 代表每生成 100 个字符中有 20 个来自代码助手。两种口径结论可能不同,汇报时务必标注清楚。

作用固定统计周期才能让数据可比,导出则便于做二次分析与汇报。
操作使用看板提供的统计时间维度筛选功能,锁定本周期范围后查看各项指标,再使用数据导出功能把各项指标导出。
注意导出的空值多出现在对话次数、补全采纳次数、补全采纳率等指标中,原因通常是用户触发了补全但未采纳,或统计周期内从未触发过对话。
作用整体看板适合汇报,细节评估与具体分析必须落到人和部门。
操作进入 数据统计 > 明细数据 > 成员明细,可查看全部明细指标,支持按用户 ID 筛选并一键导出为 Excel。若要看组织维度,进入 数据统计 > 明细数据 > 部门明细,指标与成员明细一致,支持按部门名称筛选或搜索部门 ID,同样支持导出为 Excel。
注意两个明细页都支持筛选统计时间维度;把明细与看板对账时,请确保时间范围一致,否则结论会互相打架。


作用大部分「数据异常」其实是同步延迟或统计口径问题,先排除这两类再深入排查。
操作若发现数据显示异常,先等待约 15 分钟再确认,因为研效度量数据同步需要 15 分钟。同时回顾统计口径:总新增行数或字符数包含手动键入与补全采纳,复制或导入超过 5 行的代码不计入;新增代码计入统计而删除不回退;补全生成的注释及其采纳也计入指标。
注意例如新增 10 行后又删除,新增行数仍记为 10 行;这类口径差异会让数据与代码仓库的实际净增量不一致,属正常现象。
```markdown
我要向团队解释「代码生成率」这个指标,请帮我写一份口径说明。
必须准确包含的事实(不要增删):
- 代码生成率(按行)=(AI 生成代码行数 / 总新增代码行数)× 100%;
- 代码生成率(按字符)=(AI 生成代码字符数 / 总新增代码字符数)× 100%;
- 举例:按行为 20% 代表统计时间段内每 100 行代码中有 20 行由代码助手生成;按字符为 20% 代表每生成 100 个字符中有 20 个字符来自代码助手;
- AI 生成代码的生成方式包括代码补全、Craft、Ask(插入代码等操作)、Inline-Chat(内联对话);
- 总新增代码包括用户手动编写的代码和 AI 生成的代码;
- 总新增行数或字符数包括手动键入与补全采纳,复制或导入的代码需限制在 5 行以内,超过 5 行属于大幅度键入不计入统计;
- 新增的代码计入统计,删除的不回退,例如新增 10 行后又删除,新增行数仍为 10 行;
- 补全次数只要触发即计入,不管是否采纳;补全采纳次数需用户执行采纳操作(例如 Tab)才计入;补全生成的注释及采纳也计入统计。
请输出:1)一段面向非技术管理者的白话解释(不超过 200 字);2)一张「常见误解 vs 实际口径」对照表,至少 5 行;3)一段使用该指标做投产比测算时的注意事项(不超过 150 字)。
```得到一段白话解释、一张误解对照表和一段注意事项,所有计算口径与边界条件与给定信息完全一致。
```markdown
我要做一份季度研效汇报,请帮我设计取数清单。
可查看的指标(请只基于这些设计,不要新增指标):
- 活跃情况:活跃用户数量、补全活跃用户数量、对话活跃用户数量,可看各 IDE 活跃占比;
- 对话指标:对话次数、对话使用指令次数、对话引用上下文次数、对话使用智能体次数、对话使用知识库次数、对话中代码段操作次数;
- 补全指标:按次/按行/按字符三种口径下的补全生成数、补全采纳数与补全采纳率,支持按语言展示;
- 代码生成指标:按行/按字符两种口径,支持按语言、代码生成方式、客户端名称、客户端版本或插件版本展示;
- 成员明细与部门明细:指标与看板一致,支持按用户 ID 或部门名称/部门 ID 筛选,支持一键导出 Excel;
- 看板支持按统计时间维度筛选与数据导出。
已知约束:研效度量数据同步需要 15 分钟;导出中空值多出现在对话次数、补全采纳次数、补全采纳率,原因是用户触发补全未采纳或从未触发对话。
请输出:1)一张取数清单表(指标 / 从哪个页面取 / 用什么维度筛选 / 汇报中用来说明什么 / 需要注意的坑);2)一段汇报主线的建议顺序(不超过 200 字);3)一段「数据为空时如何解释」的话术。
```得到一张取数清单表、汇报主线建议和空值解释话术,指标来源页面标注准确,且提示了 15 分钟同步延迟。
```markdown
我拿到了本季度的研效度量数据,需要诊断提效瓶颈。
已知指标口径(请严格按此推断,不要编造新指标):
- 活跃用户数量:使用过补全或对话的用户数量;补全活跃用户数量:使用过补全的用户数量;对话活跃用户数量:使用过对话的用户数量;
- 对话次数:使用对话的总次数;对话使用指令次数:对话时使用的斜杠命令次数;对话引用上下文次数:对话时通过 @ 引用上下文的次数,类型包括文件、文件夹、Diff 文件、变更、知识库、终端命令等;对话使用智能体次数:对话时使用的智能体次数,例如 @workspace;对话使用知识库次数:对话时使用的知识库次数;对话中代码段操作次数:对对话中返回的代码段执行的操作次数;
- 补全采纳率(按次/按行/按字符):采纳数除以生成数。
我的数据特征:活跃用户数不低,但对话引用上下文次数和对话使用知识库次数接近 0,补全采纳率(按次)偏低,代码生成率(按行)中等。
请输出:1)一张「现象—可能原因—验证方法—改进动作」四列诊断表,至少 4 行;2)一段优先行动建议(不超过 150 字),说明先做哪一件事及理由;3)一份改进后用什么指标验证效果的方案(不超过 150 字)。
```得到一张结构化诊断表、优先行动建议和效果验证方案,推断严格基于给定指标含义,未编造新指标。