Administration

治理

治理关注使用范围、审计、合规和人工责任。

治理和可观察性

Codex gives enterprise teams visibility into adoption and impact, plus the auditability needed for security and compliance programs. Use the self-serve dashboard for day-to-day tracking, the Analytics API for programmatic reporting, and the Compliance API to export detailed logs into your governance stack.

跟踪 Codex 使用情况的方法

根据您的需要,可以通过三种方式监控 Codex 使用情况:

分析仪表板:快速查看采用、使用和代码审查影响。

分析 API:将结构化每日指标拉入您的数据仓库或 BI 工具。

合规性 API:导出详细的活动日志以供审核、监控和调查。

分析仪表板

Codex 分析仪表板按模型显示信用和代币使用情况

仪表板视图

分析仪表板 允许 ChatGPT 工作区管理员和分析查看者跟踪 Codex 的采用、使用和代码审查反馈。使用数据最多可能滞后 12 小时。

Codex provides date-range controls for daily and weekly views. Key charts include:

按产品面划分的活跃用户,包括 CLI、IDE 扩展、云、桌面和代码审查

工作空间和个人使用情况细分,包括按产品表面或型号划分的信用和代币使用情况

客户的螺纹和匝数产品活动

用户排名表,带有客户端过滤器和排序选项,例如积分、线程、回合、文本标记和当前连胜

代码审查活动,包括审查的 PR、按优先级排列的问题、评论、回复、反应和反馈情绪

当您的工作区具有这些功能时,技能调用、代理身份使用和访问令牌使用

数据导出

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

工作空间使用情况,包括按表面划分的每日活跃用户数、线程数、轮数和积分

每个用户的使用情况,包括每日线程、回合和跨表面的积分,在允许的情况下可以使用可选的电子邮件地址

代码审查详细信息,包括每日评论、反应、回复和 priority-level 结果

分析 API

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

它衡量什么

企业分析 API 每天或每周返回工作区的 UTC 存储桶。它支持 workspace-level 和 per-user 使用、per-client 故障、代码审查吞吐量、代码审查评论优先级以及用户与代码审查评论的互动。

端点

基本 URL 是 https://api.chatgpt.com/v1/analytics/codex. 所有端点都返回带有 has_more 和 next_page 的分页页面对象。

使用 start_time 表示报告窗口开始时的包含 Unix 时间戳,使用 end_time 表示报告窗口结束时的独占 Unix 时间戳,使用 group_by 表示天或周存储桶、页面大小限制以及从上一个响应继续的页面。请求最多可追溯 90 天。

用法

GET /工作区/{workspace_id}/用法

返回每日或每周存储桶中线程、圈数、积分和 per-client 使用情况的总计。

省略组以返回 per-user 行。

设置 group=workspace 以返回 workspace-wide 行。

包括文本输入、缓存输入和输出令牌字段。

代码审查活动

GET /工作区/{workspace_id}/code_reviews

返回 Codex 完成的拉取请求审核。

返回 Codex 生成的评论总数。

按 P0、P1 和 P2 优先级细分评论。

用户参与代码审查

GET /工作区/{workspace_id}/code_review_responses

返回对 Codex 评论的回复和反应。

将反应分为积极反应、消极反应和其他反应。

统计收到反应、回复或任何形式参与的评论。

它是如何运作的

Analytics 使用时间窗口并支持日或周分组。结果是 time-ordered,并在带有 cursor-based 分页的页面中返回。使用范围为 codex.enterprise.analytics.read 的 API 密钥。

常见用例

工程可观测性仪表板

领导力更新的采用报告

使用治理和成本监控

合规性 API

当您需要安全、法律和治理工作流程的可审核记录时,请使用 合规性 API

它衡量什么

合规性 API 为企业提供了一种导出 Codex 活动日志和元数据的方法,以便您可以将该数据连接到现有的审核、监控和安全工作流程。它设计用于与 eDiscovery、DLP、SIEM 或其他合规系统等工具配合使用。

对于通过 ChatGPT 进行身份验证的 Codex 使用情况,合规性 API 导出提供 Codex 活动的审核记录,并可用于调查和合规性工作流程。这些审核日志最多保留 30 天。 API-key-authenticated Codex 的使用遵循您的 API 组织设置,并且不包含在合规性 API 导出中。

您可以导出什么

活动日志

发送至 Codex 的提示文本

生成响应 Codex

标识符,例如工作区、用户、时间戳和模型

令牌使用和相关请求元数据

用于审计和调查的元数据

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

谁运行了任务

谁创建或撤销了访问令牌

当它运行时

使用的是哪个型号

处理了多少内容

常见用例

安全调查

合规报告

政策执行审核

将事件路由到 SIEM 和电子数据展示管道

它不提供什么

生成的代码行(对生产力来说有点嘈杂,并且可能会激励错误的行为)

建议接受率(几乎100%,因为用户通常首先接受更改)

代码质量或性能 KPI

大多数企业结合使用:

用于 self-serve 监控和快速解答的分析仪表板

用于自动报告和 BI 集成的分析 API

用于审核出口和调查的合规 API

站内延伸阅读