English
主导航

推荐
API 仪表板

治理

在您的组织中管理 Codex 的治理指南

治理与可观测性

Codex 为企业团队提供了对采用情况和影响力的可见性，以及安全和合规计划所需的可审计性。使用自助式仪表板进行日常跟踪，使用 Analytics API 进行编程式报告，并使用 Compliance API 将详细日志导出到您的治理体系中。

追踪 Codex 使用情况的方法

根据您的需求，有三种方式可以监控 Codex 的使用情况：

  • Analytics 仪表板：快速了解采用率、使用情况以及代码审查的影响。
  • Analytics API：将结构化的每日指标拉取到您的数据仓库或 BI 工具中。
  • Compliance API：导出详细的活动日志，用于审计、监控和调查。

Analytics 仪表板

Codex analytics dashboard showing credit and token usage by model

仪表板视图

The Analytics 仪表板 允许 ChatGPT 工作区管理员和数据分析员追踪 Codex 的采用情况、使用情况以及 Code Review 反馈。使用数据可能会有最长 12 小时的延迟。

Codex 提供用于每日和每周视图的日期范围控件。主要图表包括：

  • 按产品界面统计的活跃用户，包括 CLI、IDE 扩展、云端、桌面端和 Code Review
  • 工作区和个人使用情况细分，包括按产品界面或模型统计的额度 (credit) 和 token 使用量
  • 按客户端统计的对话线程 (threads) 和轮次 (turns) 的产品活动情况
  • 用户排名表，支持按客户端过滤以及按额度、线程、轮次、文本 token 和当前连续活跃天数等选项进行排序
  • Code Review 活动，包括已审查的 PR、按优先级分类的问题、评论、回复、回应和反馈情感
  • 技能调用、Agent 身份使用情况以及工作区启用这些功能时的 Access Token 使用情况

数据导出

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

  • 工作区使用情况，包括按界面统计的每日活跃用户、线程、轮次和额度
  • 每位用户的使用情况，包括跨界面的每日线程、轮次和额度，以及在允许的情况下提供的电子邮件地址
  • Code Review 详情，包括每日评论、回应、回复和按优先级分类的发现结果

Analytics API

使用 Analytics API 当您需要自动化生成报告、构建内部仪表板，或将 Codex 指标与您现有的工程数据相结合时使用。

衡量内容

企业级 Analytics API 会返回某个工作区按日或按周（UTC）划分的数据汇总。它支持工作区级别和单用户的使用情况、按客户端的细分、Code Review 吞吐量、Code Review 评论优先级，以及用户与 Code Review 评论的互动情况。

端点

The base URL is https://api.chatgpt.com/v1/analytics/codex。所有端点均返回分页 page 对象设置过期策略， has_more and next_page.

使用 start_time 用于指定报告窗口开始时间的包含性 Unix 时间戳， end_time 用于指定报告窗口结束时间的排他性 Unix 时间戳， group_by for day or week 汇总 buckets， limit for page size, and page 用于从之前的响应继续。请求最长可回溯 90 天。

用量

GET /workspaces/{workspace_id}/usage

  • 返回按日或按周汇总的线程、轮次、额度以及按客户端的使用总计。
  • 之后。省略 group to return per-user rows.
  • 设置 group=workspace to return workspace-wide rows.
  • 包含文本输入、缓存输入和输出的 token 字段。

Code Review 活动

GET /workspaces/{workspace_id}/code_reviews

  • 返回由 Codex 完成的 Pull Request 审查。
  • 返回 Codex 生成的评论总数。
  • 按 P0、P1 和 P2 优先级细分评论。

用户与 Code Review 的互动

GET /workspaces/{workspace_id}/code_review_responses

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

工作原理

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

常见用例

  • 工程可观测性仪表板
  • 用于领导层汇报的采用情况报告
  • 使用情况治理与成本监控

Compliance API

使用 Compliance API 当您在安全、法律和治理工作流程中需要可审计的记录时使用。

衡量内容

Compliance API 为企业提供了一种导出 Codex 活动日志和元数据的方式，以便您将这些数据连接到现有的审计、监控和安全工作流程中。它旨在与 eDiscovery、DLP、SIEM 或其他合规系统等工具配合使用。

对于通过 ChatGPT 认证的 Codex 使用，Compliance API 导出功能可提供 Codex 活动的审计记录，并可用于调查和合规工作流程。这些审计日志最多保留 30 天。通过 API 密钥认证的 Codex 使用遵循您的 API 组织设置，并且不包含在 Compliance API 导出中。

您可以导出的内容

活动日志

  • 发送给 Codex 的提示文本
  • Codex 生成的回复
  • 标识符，例如工作区、用户、时间戳和模型
  • Token 使用量以及相关的请求元数据

用于审计和调查的元数据

使用记录元数据来回答以下问题：

  • 谁运行了任务
  • 谁创建或撤销了 Access Token
  • 何时运行的
  • 使用了哪个模型
  • 处理了多少内容

常见用例

  • 安全调查
  • 合规报告
  • 策略执行审计
  • 将事件路由到 SIEM 和电子发现管道

不提供的功能

  • 生成代码的行数（这是衡量生产力的一个干扰性指标，且可能诱发不当行为）
  • 建议的接受率（几乎为 100%，因为用户通常先接受更改）
  • 代码质量或性能 KPI

推荐模式

大多数企业会组合使用：

  1. Analytics 仪表板 用于自助监控和快速解答
  2. Analytics API 用于自动化报告和 BI 集成
  3. Compliance API 用于审计导出和调查