OpenAI Codex 中文教程
联系我 goolvyouyou@gmail.com

治理与可观测性

通过分析仪表板、Analytics API 和 Compliance API 跟踪 Codex 的采用、影响与审计记录。

Codex 为企业团队提供对采用情况和影响的可见性，以及安全和合规项目所需的可审计能力。你可以使用自助分析仪表板做日常跟踪，使用 Analytics API 做程序化报表，并通过 Compliance API 将详细日志导出到你现有的治理栈中。

跟踪 Codex 使用情况的方式

根据你的目标不同，可以通过三种方式监控 Codex 使用情况：

  • 分析仪表板（Analytics Dashboard）：快速查看采用情况以及代码审查带来的影响
  • Analytics API：把结构化的每日指标拉取到你的数据仓库或 BI 工具中
  • Compliance API：导出详细活动日志，用于审计、监控和调查

分析仪表板

Codex 分析仪表板

仪表板视图

分析仪表板（Analytics Dashboard） 可供 ChatGPT 工作区管理员和分析查看者跟踪 Codex 采用情况、使用量以及 Code Review（代码评审）反馈。使用量数据最多可能延迟 12 小时。

Codex 提供日期范围控制，可切换每日和每周视图。关键图表包括：

  • 按产品界面划分的活跃用户，包括 CLI、IDE 扩展、云端、桌面端和 Code Review
  • 工作区与个人用量拆分，包括各产品界面的额度和 token 用量
  • 按客户端划分的线程和 turn 活动
  • 用户排名表，支持按客户端筛选，并可按额度、线程数、 turn 数、文本 token 和当前连续使用天数等选项排序
  • Code Review 活动，包括已评审的 PR、按优先级划分的问题、评论、回复、反馈反应和反馈情感
  • 当工作区具备相关功能时，还会显示技能调用、智能体身份使用情况和访问令牌使用情况

数据导出

管理员还可以将 Codex 分析数据导出为 CSV 或 JSON。Codex 提供以下导出项：

  • 工作区用量，包括按产品界面划分的每日活跃用户数、线程数、 turn 数和额度用量
  • 用户级用量，包括跨产品界面的每日线程数、 turn 数和额度用量；在允许的情况下，也可包含邮箱地址
  • Code Review 明细，包括每日评论数、反馈反应数、回复数，以及按优先级划分的发现数量

Analytics API

当你需要自动化报表、搭建内部仪表板，或把 Codex 指标与现有工程数据联结时，请使用 Analytics API。

它衡量什么

企业 Analytics API 会返回工作区按天或按周聚合的 UTC bucket。它支持工作区级和用户级用量、按客户端拆分、Code Review 吞吐量、Code Review 评论优先级，以及用户与 Code Review 评论的互动情况。

端点

基础 URL 为 https://api.chatgpt.com/v1/analytics/codex。所有端点都会返回分页的 page 对象，其中包含 has_more 和 next_page。

使用 start_time 表示报告窗口开始处的包含式 Unix timestamp，使用 end_time 表示报告窗口结束处的排除式 Unix timestamp，使用 group_by 指定 day 或 week bucket，使用 limit 设置分页大小，并使用 page 从上一次 response 继续读取。请求最多可以回看 90 天。

用量

GET /workspaces/{workspace_id}/usage

  • 返回每日或每周 bucket 中的线程数、 turn 数、额度总量以及按客户端划分的用量。
  • 省略 group 会返回按用户划分的行。
  • 设置 group=workspace 会返回工作区级汇总行。
  • 包含 text input、cached input 和 output token 字段。

代码审查活动

GET /workspaces/{workspace_id}/code_reviews

  • 返回 Codex 完成的 pull request 评审数量。
  • 返回 Codex 生成的评论总数。
  • 按 P0、P1 和 P2 优先级拆分评论。

用户与代码审查的互动

GET /workspaces/{workspace_id}/code_review_responses

  • 返回对 Codex 评论的回复和反馈反应。
  • 将反馈反应拆分为正向、负向和其他反应。
  • 统计收到反馈反应、回复或任一互动形式的评论数量。

工作方式

Analytics 使用时间窗口，并支持按天或按周分组。结果按时间排序，并通过基于 cursor 的分页返回。请使用权限范围限定为 codex.enterprise.analytics.read 的 API key。

常见用例

  • 工程可观测性仪表板
  • 面向管理层更新的采用情况报表
  • 使用治理与成本监控

Compliance API

当你需要可审计记录来支持安全、法务和治理流程时，请使用 Compliance API。

它衡量什么

Compliance API 让企业能够导出 Codex 活动的日志与元数据，以便接入你现有的审计、监控和安全工作流。它适合与 eDiscovery、DLP、SIEM 或其他合规系统集成。

对于通过 ChatGPT 认证的 Codex 使用，Compliance API 导出会提供 Codex 活动的审计记录，可用于调查和合规流程。这些审计日志最多保留 30 天。通过 API key 认证的 Codex 使用遵循你所在 API 组织的设置，不会出现在 Compliance API 导出中。

你可以导出什么

活动日志

  • 发送给 Codex 的提示词文本
  • Codex 生成的响应
  • 工作区、用户、时间戳和模型等标识信息
  • token 用量及相关请求元数据

用于审计与调查的元数据

你可以利用这些记录元数据回答如下问题：

  • 谁运行了某个任务
  • 谁创建或撤销了访问令牌
  • 任务是在什么时候运行的
  • 使用了哪个模型
  • 处理了多少内容

常见用例

  • 安全调查
  • 合规报表
  • 策略执行审计
  • 将事件路由到 SIEM 和 eDiscovery 流水线

它不提供什么

  • 生成了多少行代码：这只是一个噪声较大的生产力代理指标，而且可能激励错误行为
  • 建议接受率：这个指标通常接近 100%，因为用户往往会先接受变更
  • 代码质量或性能 KPI

推荐组合

大多数企业会组合使用以下三者：

  1. 分析仪表板（Analytics Dashboard）：用于自助监控和快速获取结论
  2. Analytics API：用于自动化报表和 BI 集成
  3. Compliance API：用于审计导出和调查