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

站内延伸阅读