A governança das atividades do Codex envolve análises interativas, geração de relatórios por API, controles de uso do ChatGPT e registros de auditoria. Escolha a ferramenta de acordo com a pergunta que você precisa responder. Os dados de análise e os de conformidade têm finalidades diferentes.
| Se você precisa | Comece por |
|---|---|
| Entender a adoção do ChatGPT como um todo | Análise do espaço de trabalho |
| Explorar de forma interativa a adoção e as atividades do Codex | Análise do Codex |
| Carregar dados agregados dos relatórios do Codex em outro sistema | API de análise |
| Exportar registros para auditoria ou investigação | API de Compliance |
| Consultar os controles de créditos disponíveis para o espaço de trabalho do ChatGPT conforme o plano | Limites de uso e controles de gastos do ChatGPT |
Acesse as ferramentas de administração
- Acesse a análise do espaço de trabalho para consultar relatórios interativos do espaço de trabalho. O guia de análise do espaço de trabalho descreve os perfis de acesso e as visualizações disponíveis atualmente.
- Consulte a referência da API de análise do Codex quando precisar agendar a geração de relatórios por API.
- Consulte a referência da API de administração e o guia da plataforma de conformidade para configurar integrações de auditoria e investigação.
Por exemplo, use a análise do espaço de trabalho para verificar rapidamente a adoção, a API de análise para carregar dados agregados dos relatórios do Codex em um sistema de inteligência de negócios e a API de Compliance para enviar registros auditáveis a um sistema SIEM ou a um fluxo de trabalho de descoberta eletrônica de provas.
Painel de análise
O ChatGPT fornece dados de análise para acompanhar a adoção e o engajamento em todo o espaço de trabalho. A análise do Codex se concentra nas atividades do Codex. As duas ferramentas oferecem relatórios interativos e não fornecem logs brutos de auditoria.
Consulte a página Análise do espaço de trabalho para comparar as duas ferramentas e encontrar as fontes atuais mantidas pelas equipes responsáveis. Você também pode acessar diretamente a análise do espaço de trabalho. Não defina contratos de dados de longo prazo para relatórios com base nos rótulos do painel ou nos campos dos relatórios baixados. Esses rótulos e campos podem mudar à medida que o produto evolui.
Controles de uso do ChatGPT relacionados ao Codex
Os controles de uso do espaço de trabalho do ChatGPT são independentes das ferramentas de análise e não definem a quais recursos cada usuário tem direito. Dependendo do plano, as atividades elegíveis do Codex podem consumir créditos do espaço de trabalho do ChatGPT. Quando os limites são atingidos, o acesso aos recursos elegíveis pode ser suspenso temporariamente. Esses controles não estabelecem um limite universal para o Codex nem determinam a cobrança pelo uso da API da plataforma.
Consulte Limites de uso e controles de gastos do ChatGPT para entender o escopo desses controles ao longo do tempo e encontrar as referências atuais da Central de Ajuda.
API de análise
Use a API de análise para obter, via código, dados agregados dos relatórios do Codex. Ela é adequada para data warehouses, sistemas de inteligência de negócios e relatórios internos que precisam ser independentes de um painel interativo.
Consulte a referência da API para obter detalhes sobre requisitos de acesso, rotas, schemas, campos, períodos cobertos pelos relatórios e paginação. A página API de análise contém orientações de integração e um link para a referência.
API de Compliance
O acesso ao computador local com o Work na nuvem conta com o mesmo suporte da API de Compliance que o próprio Work na nuvem, com registros em conversation_message e codex_log. A execução local gera eventos separados do OpenTelemetry (OTel). Para coletá-los, configure o endpoint de um coletor OTel. Use esses registros nos fluxos de auditoria e investigação compatíveis. Consulte os relatórios de adoção separadamente.
Automação de políticas. Use a API de políticas para gerenciar as configurações do escopo Global. Gerencie as configurações dos escopos Local e Codex Cloud na interface de segurança de agentes. Os fluxos de trabalho existentes que usam a API para gerenciar configurações do escopo Global continuam disponíveis após a migração. Teste os scripts e as integrações com o Terraform e confirme que as atribuições e a ordem das políticas continuam as mesmas. Revise a automação de políticas separadamente das integrações de relatórios.
Auditoria com hooks. Se os hooks MCP estiverem habilitados no seu espaço de trabalho, use os hooks definidos pelos administradores. Eles são executados no coordenador da nuvem (orquestrador) para os eventos de ciclo de vida e de ferramentas compatíveis. Antes de substituir um fluxo de auditoria existente, teste a conexão de callback, verifique quais eventos são cobertos e avalie o comportamento em caso de falha. Verifique esses registros separadamente da cobertura da API de Compliance.
Consulte API de Compliance e eventos de auditoria para conhecer os tipos de registro compatíveis e entender as diferenças entre os registros da API de Compliance, a telemetria local e os logs gerados por hooks. Por si só, o acesso às conversas não fornece um registro completo das ações locais.
Use a API de Compliance em fluxos de trabalho de segurança, jurídicos e de governança que exijam registros auditáveis. Ela não oferece um painel de adoção ou produtividade.
Consulte a referência da API para obter detalhes sobre os eventos cobertos, schemas, permissões, filtros, retenção e comportamento das solicitações. A página API de Compliance contém orientações de integração e um link para a referência.
Para definir a ordem das etapas de implantação e verificar cada uma dessas ferramentas, consulte o guia de implantação para administradores.