Codex の利用を管理するために、対話型の分析機能、プログラムからレポートを取得するための API、関連する ChatGPT の使用量管理機能、監査記録を利用できます。分析データとコンプライアンスデータは用途が異なるため、確認したい内容に応じて使い分けてください。
| 目的 | 最初に参照するページ |
|---|---|
| ChatGPT 全体の利用の広がりを把握する | ワークスペース分析 |
| Codex の利用の広がりやアクティビティを画面上で確認する | Codex 分析 |
| Codex の集計データを別のシステムに取り込む | Analytics API |
| 監査や調査のために記録をエクスポートする | Compliance API |
| ChatGPT ワークスペースのクレジットを管理するために各プランで利用できる機能を確認する | ChatGPT の使用量上限と支出管理 |
管理画面と API リファレンスへのアクセス
- ワークスペースのレポートを画面上で確認するには、ワークスペース分析を開きます。現在のロールと表示できる画面については、ワークスペース分析ガイドを参照してください。
- プログラムからレポートを定期的に取得するには、Codex Analytics API リファレンスを参照してください。
- 監査や調査に使うシステムと連携するには、Admin API リファレンスと Compliance Platform ガイドを参照してください。
たとえば、利用の広がりを手早く確認するにはワークスペース分析を使います。Codex の集計データをビジネスインテリジェンスシステムに取り込むには Analytics API を、監査可能な記録を SIEM や電子証拠開示のワークフローに送るには Compliance API を使います。
分析ダッシュボード
ChatGPT の分析機能では、ワークスペース全体で利用がどの程度広がっているか、どれだけ活用されているかを確認できます。Codex 分析は Codex のアクティビティに焦点を当てています。どちらも画面上でレポートを確認するための機能で、生の監査ログは提供しません。
ワークスペース分析では、両者の違いを確認し、それぞれの担当チームが更新している資料を参照できます。ワークスペース分析の画面を直接開くこともできます。ダッシュボードの項目名やダウンロードしたレポートのフィールドは、製品の更新に伴って変わることがあります。長期的に運用するレポートの仕様をこれらに依存させないでください。
関連する ChatGPT の使用量管理機能
ChatGPT ワークスペースの使用量管理は分析とは別の機能です。各機能の利用資格を設定するものではありません。プランによっては、対象となる Codex のアクティビティで ChatGPT ワークスペースのクレジットを消費し、上限に達すると対象機能へのアクセスが一時停止することがあります。この管理機能では、Codex 全体に共通の上限を設定したり、Platform API の課金を管理したりすることはできません。
使用量管理の基本的な適用範囲とヘルプセンターの最新資料については、ChatGPT の使用量上限と支出管理を参照してください。
Analytics API
Codex の集計データをプログラムから取得するには、Analytics API を使います。データウェアハウスやビジネスインテリジェンスシステムへの取り込み、対話型ダッシュボードに依存せずに社内レポートを作成する用途に適しています。
アクセス要件、ルート、スキーマ、フィールド、レポートの対象期間、ページネーションは API リファレンスで確認してください。連携方法とリファレンスへのリンクは、Analytics API を参照してください。
Compliance API
Work Cloud からローカルコンピューターにアクセスする場合も、Work Cloud と同様に Compliance API を利用できます。記録の種類は conversation_message と codex_log です。ローカルでの実行時には、これらとは別に OpenTelemetry（OTel）イベントが生成されます。OTel コレクターのエンドポイントを設定すると、これらのイベントを収集できます。記録は、サポート対象の監査や調査のワークフローで使用してください。利用の広がりは別途レポートで確認してください。
ポリシー管理の自動化。グローバル設定はポリシー API で管理します。ローカル設定と Codex Cloud の設定は Agent Security の管理画面で管理します。グローバル設定用の既存の API ワークフローは、移行後も利用できます。スクリプトと Terraform 連携をテストし、ポリシーの割り当てと適用順序が変わっていないことを確認してください。ポリシー管理の自動化は、レポート取得のための連携とは別に確認してください。
フックを使った監査。ワークスペースでこの機能が有効になっている場合は、サポート対象のライフサイクルイベントやツールイベントに対して、管理者が定義した MCP フックを使います。フックはクラウドコーディネーター（オーケストレーター）上で実行されます。既存の監査ワークフローを置き換える前に、コールバック先に接続できるか、どのイベントが記録されるか、障害時にどう動作するかをテストしてください。フックによる記録は、Compliance API の記録対象とは別に確認してください。
サポート対象の記録の種類と、Compliance API の記録、ローカルのテレメトリ、フックによるログ記録の違いについては、Compliance API と監査イベントを参照してください。会話を閲覧できるだけでは、ローカルで行われた操作がすべて記録されているとは判断できません。
セキュリティ、法務、ガバナンスのワークフローで監査可能な記録が必要な場合は、Compliance API を使います。この API は、利用の広がりや生産性を確認するためのダッシュボードではありません。
対象イベント、スキーマ、権限、フィルター、データの保持期間、リクエスト時の動作は API リファレンスで確認してください。連携方法とリファレンスへのリンクは、Compliance API を参照してください。
これらの機能を導入する順序と検証方法については、管理者向け導入ガイドを参照してください。