Codex 활동을 관리할 때는 대화형 분석, API를 통한 보고, 관련 ChatGPT 사용량 제어 기능, 감사 기록을 활용할 수 있습니다. 분석 데이터와 규정 준수 데이터는 용도가 다르므로 확인하려는 내용에 맞게 선택하세요.
| 관리 목적 | 먼저 살펴볼 항목 |
|---|---|
| ChatGPT 전반의 도입 현황 파악 | 워크스페이스 분석 |
| Codex 도입 현황과 활동을 대화형으로 확인 | Codex 분석 |
| 집계된 Codex 보고 데이터를 다른 시스템에 적재 | Analytics API |
| 감사 또는 조사에 필요한 기록 내보내기 | Compliance API |
| 플랜별 ChatGPT 워크스페이스 크레딧 제어 기능 확인 | ChatGPT 사용량 한도 및 지출 제어 |
관리 도구 열기
- 워크스페이스 보고서를 대화형으로 살펴보려면 워크스페이스 분석을 여세요. 워크스페이스 분석 가이드에서 현재 지원하는 역할과 보기를 확인할 수 있습니다.
- 보고 데이터를 정해진 일정에 따라 프로그래밍 방식으로 가져오려면 Codex Analytics API 레퍼런스를 여세요.
- 감사 및 조사 시스템을 연동하려면 Admin API 레퍼런스와 컴플라이언스 플랫폼 가이드를 여세요.
예를 들어 도입 현황을 빠르게 확인하려면 워크스페이스 분석을 사용하세요. 집계된 Codex 보고 데이터를 비즈니스 인텔리전스 시스템에 적재하려면 Analytics API를, 감사 가능한 기록을 SIEM이나 전자증거개시 워크플로우로 전송하려면 Compliance API를 사용하세요.
분석 대시보드
ChatGPT는 워크스페이스 전체의 도입 현황과 사용자 참여도를 분석합니다. Codex 분석은 Codex 활동에 초점을 맞춥니다. 둘 다 보고 데이터를 대화형으로 살펴보는 도구이며 원본 감사 로그를 제공하지 않습니다.
워크스페이스 분석 문서에서 두 분석 도구를 비교하고 각 담당 팀이 관리하는 최신 자료를 찾을 수 있습니다. 워크스페이스 분석을 직접 열어도 됩니다. 제품이 발전하면서 대시보드의 레이블이나 다운로드한 보고서의 필드가 바뀔 수 있으므로, 이를 고정된 사양으로 간주해 보고 시스템을 구축하지 마세요.
관련 ChatGPT 사용량 제어 기능
ChatGPT 워크스페이스의 사용량 제어 기능은 분석과 별개이며 기능 사용 권한을 설정하지 않습니다. 플랜에 따라 일부 Codex 활동에 ChatGPT 워크스페이스 크레딧이 사용될 수 있으며, 사용량 한도에 도달하면 해당 기능에 대한 액세스가 일시 중지될 수 있습니다. 이러한 제어 기능은 Codex 전체에 공통 한도를 설정하지 않으며 Platform API 과금에도 적용되지 않습니다.
사용량 제어 기능의 적용 범위와 최신 도움말 센터 자료는 ChatGPT 사용량 한도 및 지출 제어를 참고하세요.
Analytics API
집계된 Codex 보고 데이터를 프로그래밍 방식으로 가져오려면 Analytics API를 사용하세요. 데이터 웨어하우스, 비즈니스 인텔리전스 시스템, 대화형 대시보드에 의존하지 않아야 하는 내부 보고 업무에 적합합니다.
액세스 요건, API 경로, 스키마, 필드, 보고 기간, 페이지네이션은 API 레퍼런스에서 확인하세요. Analytics API 문서에는 연동 방법과 레퍼런스 링크가 있습니다.
Compliance API
Work 클라우드를 통해 로컬 컴퓨터에 액세스할 때도 Work 클라우드와 동일한 범위로 Compliance API가 지원되며, 기록은 conversation_message와 codex_log에서 확인할 수 있습니다. 로컬에서 실행하면 별도의 OpenTelemetry(OTel) 이벤트가 생성됩니다. OTel 수집기 엔드포인트를 설정하면 이 이벤트를 수집할 수 있습니다. 지원되는 감사 및 조사 워크플로우에 이러한 기록을 사용하세요. 도입 현황은 별도 보고서에서 확인하세요.
정책 자동화. 전역 설정은 정책 API로 관리하세요. 로컬 및 Codex Cloud 설정은 Agent Security UI에서 관리하세요. 마이그레이션 후에도 기존 전역 API 워크플로우를 사용할 수 있습니다. 스크립트와 Terraform 연동을 테스트하고 정책 할당과 적용 순서가 그대로인지 확인하세요. 정책 자동화는 보고 시스템 연동과 별도로 검토하세요.
훅 기반 감사. 워크스페이스에서 이 기능이 활성화되어 있다면 관리자가 정의한 MCP 훅을 사용하세요. 이 훅은 지원되는 수명 주기 이벤트와 도구 이벤트가 발생할 때 클라우드 코디네이터(오케스트레이터)에서 실행됩니다. 기존 감사 워크플로우를 교체하기 전에 콜백 연결, 기록되는 이벤트의 범위, 실패 시 동작을 테스트하세요. 훅으로 남긴 기록은 Compliance API가 제공하는 기록 범위와 별도로 확인하세요.
지원되는 기록 유형과 Compliance API 기록, 로컬 텔레메트리, 훅 기반 로깅의 차이는 Compliance API 및 감사 이벤트를 참고하세요. 대화를 열람할 수 있다는 사실만으로 모든 로컬 작업이 기록되었다고 판단할 수는 없습니다.
감사 가능한 기록이 필요한 보안, 법무, 거버넌스 워크플로우에는 Compliance API를 사용하세요. 이 API는 도입 현황이나 생산성을 보여 주는 대시보드가 아닙니다.
지원되는 이벤트 범위, 스키마, 권한, 필터, 보존 기간, 요청 처리 방식은 API 레퍼런스에서 확인하세요. Compliance API 문서에는 연동 방법과 레퍼런스 링크가 있습니다.
각 관리 도구의 배포 순서와 검증 방법은 관리자 배포 가이드를 참고하세요.