CLI、App 与 Agents window 指标

客户端指标不完全共用同一层汇总。CLI、Copilot app、专用 VS Code Agents window 与第三方 agent apps，应按各自字段读取，不能因为都使用 agent 就相互替代。

CLI

daily_active_cli_users 与 IDE 活跃人数独立；totals_by_cli 不进入 totals_by_ide 或普通 totals_by_feature 的 IDE 用量定义。

totals_by_cli 子字段	含义
session_count	当天启动的不同 CLI 会话数
request_count	请求总数，包括用户提示与 agent 自动后续调用
prompt_count	会话中用户的提示、命令或查询
token_usage.output_tokens_sum	输出 token 合计
token_usage.prompt_tokens_sum	提示 token 合计
token_usage.avg_tokens_per_request	两类 token 之和除以请求数；无请求时为 null
last_known_cli_version	仅逐用户报告有，包含 cli_version 与 sampled_at；未知版本字符串为 unknown

当天没有 CLI 用量时，相应对象或活跃字段可以省略。虽然 feature 枚举列出 copilot_cli，字段专题仍明确上述独立采集范围，不应据枚举推测任意 IDE 数组都含 CLI。

Copilot app

totals_by_copilot_app 提供 session / request / prompt 和 token 对象，定义与上表相应项类似，但没有 last_known_app_version。

与 CLI 不同，app 编码活动还会进入顶层 code / LoC 和相关 feature、model、language 数组，feature 值为 copilot_app。不能把顶层这些值与 app 明细再相加，否则会重复计数。

专用 VS Code Agents window

used_vscode_agent、totals_by_vscode_agent 与 IDE 编辑器窗口的 used_agent、agent_edit、chat_panel_agent_mode 不同。专用窗口数据不进入通用顶层活动、普通明细或采用阶段数组。

该对象包含 session_count 和 total_user_messages，两项都可用时才出现，包括两者为零的情况。

聚合人数	时间窗口
daily_active_vscode_agent_users	记录当天
weekly_active_vscode_agent_users	星期日至记录当天，不是滚动七天
monthly_active_vscode_agent_users	当月首日至记录当天，不是滚动28天

周/月都没有相应活动时字段可缺省；其中一个期间有活动、另一个没有时，无活动期间为零。

第三方 agent apps

totals_by_3rd_party_agent 当前为 public preview，只在 API / NDJSON 提供具体明细。按稳定的 agent_id 分组，agent_name 仅用于显示，同一 agent 的集成合并统计。

嵌套 user_initiated_interaction_count 计的是启动的 jobs，每次启动加一；顶层同名字段计的是其他遥测中的明确提示，两者不可直接对账。

嵌套 session_count 只在企业/组织聚合报告提供，不在逐用户条目提供。因此无法通过逐用户团队关联推导团队的第三方 agent session 数。