腾讯云代码助手支持对企业内用户的使用情况进行度量统计，帮助企业管理者观测提效成果、制定优化方案。数据统计提供以下能力：
研效看板：对企业使用情况进行汇总统计，适用于度量企业整体的研效情况，本文介绍研效看板的具体使用方式。
明细数据：查看每个企业成员的数据明细，适用于细节评估与具体分析，详见 明细数据。
研效看板
看板支持指标视图和趋势视图两种视图切换查看。每种视图下均包含活跃情况、对话指标、补全指标、代码生成指标四类指标。此外，补全指标支持按语言进行展示和分析。您可以单击指标名称旁的 ⓘ 图标查看指标含义及计算方式。
注意：
当前研效看板已全新升级，支持查看升级后的指标数据；如需查看历史数据，请切换至旧版看板。
指标视图
活跃情况
活跃情况分类包含活跃用户数量、补全活跃用户数量、对话活跃用户数量三个指标，每个指标均以文本和图卡形式展示，并可查看各 IDE 的活跃数量占比。
对话指标
对话指标分类包含对话次数、对话使用指令次数、对话引用上下文次数、对话使用智能体次数、对话使用知识库次数、对话中代码段操作次数六个指标，每个指标均以文本和图卡形式展示。
补全指标
补全指标分为按次统计、按行统计和按字符统计三种统计口径，每种统计口径下包含对应的指标。每个指标支持按语言进行展示，帮助您深入分析。
代码生成指标
代码生成指标分为按行统计和按字符统计两种统计口径，每种统计口径下包含对应的指标。每个指标支持按语言、代码生成方式、客户端名称、客户端版本或插件版本进行展示，帮助您深入分析。
企业管理者通常最关注“代码助手帮助企业生成了多少代码”。代码助手将这一概念量化为代码生成率指标，下面介绍其计算逻辑。
根据统计口径不同，代码生成率可按行或按字符进行计算：
按行计算
代码生成率（按行）=（AI 生成代码行数 / 总新增代码行数）× 100%。例如，若代码生成率（按行）= 20%，则代表在统计时间段内，每 100 行代码中有 20 行是通过代码助手生成的。
按字符计算
代码生成率（按字符）=（AI 生成代码字符数 / 总新增代码字符数）× 100%。例如，若代码生成率（按字符）= 20%，则代表在统计时间段内，每 100 个生成字符中有 20 个字符是通过代码助手生成的。
通过代码生成率，企业可以量化代码助手对研发提效的作用，进而衡量相关投入产出比，实现研效可量化、可观测。
趋势视图
趋势视图中的各项指标与指标视图基本一一对应。
活跃情况
活跃情况分类包含活跃用户数量、补全活跃用户数量、对话活跃用户数量三个指标，每个指标可按不同 IDE 清晰展示。例如，可查看并分析本月各 IDE 活跃数量的趋势线。
对话指标
对话指标分类包含对话次数、对话使用指令次数、对话引用上下文次数、对话使用智能体次数、对话使用知识库次数、对话中代码段操作次数六个指标，可查看各指标的具体使用次数。例如，可查看并分析本月各对话指标的趋势线。
补全指标
补全指标同样分为按次统计、按行统计和按字符统计三种统计口径，每种统计口径下包含对应的指标，每个指标支持按语言清晰展示。例如，可查看并分析各指标下不同语言的趋势线。
代码生成指标
代码生成指标分为按行统计和按字符统计两种统计口径，每种统计口径下包含对应的指标，每个指标支持按语言进行展示。例如，可查看并分析各指标下不同语言的趋势线。
指标描述
下面是各项指标的描述：
指标名称 | 指标含义（统计周期内） |
活跃用户数量 | 使用过补全或对话的用户数量 |
补全活跃用户数量 | 使用过补全的用户数量 |
对话活跃用户数量 | 使用过对话的用户数量 |
对话次数 | 使用对话的总次数 |
对话使用指令次数 | 对话时使用的斜杠命令次数 |
对话引用上下文次数 | 对话时通过 @ 引用上下文的次数，添加的上下文类型包括文件、文件夹、Diff 文件、代码变更、知识库、终端命令等 |
对话使用智能体次数 | 对话时使用的智能体次数，例如“@workspace” |
对话使用知识库次数 | 对话时使用的知识库次数，例如“#Vue” |
对话中代码段操作次数 | 对于对话中返回的代码段执行的操作次数 |
补全生成次/行/字符数 | 触发补全的总次/行/字符数 |
补全采纳次/行/字符数 | 采纳补全内容的总次/行/字符数 |
补全采纳率（按次） | 补全采纳次数/补全次数 |
补全采纳率（按行） | 补全采纳行数/补全行数 |
补全采纳率（按字符） | 补全采纳字符数/补全字符数 |
AI 生成代码字符数 | 由 AI 生成的代码，生成方式包括代码补全、Craft、Ask（插入代码等操作）、Inline-Chat（内联对话） |
总新增代码字符数 | 总计新增的代码，包括用户手动编写的代码和 AI 生成的代码 |
代码生成率（按行） | AI 生成代码行数/总新增代码行数 |
代码生成率（按字符） | AI 生成代码字符数/总新增代码字符数 |
说明：
对于总新增行数或总新增字符数：包括用户手动键入与补全采纳的内容。复制或导入的代码需限制在 5 行以内，超过 5 行属于大幅度键入，不计入统计。
对于新增的代码（包括用户手动键入和补全采纳生成的代码、注释）：新增会计入统计，删除不计入统计。例如，新增了 10 行代码后又删除，则新增行数仍为 10 行。
对于补全次数：用户只要触发代码补全，无论是否执行采纳或拒绝操作，均会计入统计，且不受后续操作影响。补全行数和补全字符数同理。
补全次数/行数/字符数与补全采纳次数/行数/字符数的区别：后者（补全采纳）需要用户执行采纳操作（例如按 Tab 键）才计入统计；前者无论是否采纳，均会计入统计。
对于注释：补全生成的注释及其采纳操作，均会计入指标统计。
统计时间维度筛选和数据导出
看板支持按统计时间维度进行筛选，并支持各项指标数据的导出。
常见问题
Q1：导出数据中指标值为空？
指标值为空的情况主要出现在对话次数、补全采纳次数、补全采纳率等指标中。原因是在统计周期内，用户触发了补全但未执行采纳操作，或从未发起对话，导致上述指标无法计算，数据显示为空。
Q2：执行操作后指标数据没有更新？
研效看板数据同步需要约 15 分钟。若出现其他数据异常，可等待 15 分钟同步完成后再确认。
