Skip to main content
Seus engenheiros já executam o OpenAI Codex todos os dias. A captura de sessões do Codex traz essas sessões de codificação para o AgentEye como sessões e eventos comuns, para que você possa pesquisar, reproduzir e avaliar tudo junto com o restante do que você observa. Ela complementa o Python SDK: o SDK instrumenta agentes que você escreve, enquanto este captura o trabalho do Codex que sua equipe já realiza — sem nenhuma mudança na forma como eles o executam. Um pequeno coletor em segundo plano lê os transcritos de sessão locais do Codex conforme são gravados e os envia para o AgentEye. Um coletor por máquina captura todas as superfícies locais do Codex de uma vez — não há configuração por superfície. O mesmo coletor captura outros agentes também — veja OpenClaw e Hermes. Ative cada um que você utiliza; um único coletor pode capturar vários ao mesmo tempo.

O que é capturado

Toda superfície do Codex executada localmente produz os mesmos transcritos de sessão em disco, e o coletor os recolhe todos:
  • o CLI do Codex e o codex exec
  • a extensão para VS Code / IDE
  • o aplicativo desktop, quando executa uma sessão localmente
Cada sessão do Codex se torna uma sessão do AgentEye; suas mensagens de usuário e assistente, raciocínio, chamadas de ferramentas, resultados de ferramentas e uso de tokens se tornam os eventos correspondentes. A superfície de onde cada sessão se originou (CLI, IDE ou desktop) é registrada, para que você possa distingui-las.
Sessões na nuvem não são capturadas. O aplicativo desktop executa cada vez mais sessões na nuvem do Codex e mantém apenas os metadados delas na máquina — não há transcrito local para leitura. Apenas sessões executadas localmente são capturadas.

Como ativar

A captura fica desativada até que você a habilite. Instale o coletor com uma chave de API que tenha a permissão events:add (veja Chaves de API) e ative a captura do Codex:
Isso instala o coletor, registra-o como um serviço em segundo plano e inicia a captura. Confirme que está em execução:
Na primeira execução, suas sessões do Codex existentes são preenchidas retroativamente uma vez e a nova atividade passa a ser transmitida em segundos. Os arquivos do próprio Codex são apenas lidos — nunca modificados, movidos ou excluídos — e cada sessão é enviada exatamente uma vez, mesmo após reinicializações.

Onde aparece

As sessões capturadas aparecem em Sessões, e seus eventos no fluxo de Eventos, da mesma forma que qualquer outro agente que você observa — assim, reprodução de sessão, pesquisa, avaliações e alertas funcionam nelas. Filtre pelo agente Codex para visualizá-las separadamente.

Privacidade

Os transcritos do Codex contêm a sessão completa — incluindo saída de comandos, conteúdo de arquivos e tudo que o Codex leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão; portanto, ative a captura somente em máquinas e para equipes em que centralizar esse conteúdo no AgentEye seja apropriado, e forneça ao coletor uma chave com escopo apenas para events:add. Consulte Segurança para saber como seus dados são mantidos isolados.