Skip to main content
Seus engenheiros já executam o OpenAI Codex todos os dias. A captura de sessão 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 junto a tudo o mais que você observa. Ela complementa o Python SDK: o SDK instrumenta os agentes que você escreve, enquanto este recurso captura o trabalho que sua equipe já realiza no Codex — sem nenhuma alteração na forma como eles o executam. Um pequeno coletor em segundo plano lê os transcritos de sessão locais do Codex à medida que 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 — sem necessidade de configuração por superfície. O mesmo coletor também captura outros agentes — 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 que executa localmente produz os mesmos transcritos de sessão em disco, e o coletor processa todos eles:
  • 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 no 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 origem de cada sessão (CLI, IDE ou desktop) é registrada, permitindo diferenciá-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 na máquina — não há transcrito local para leitura. Somente sessões executadas localmente são capturadas.

​
Como ativar

A captura está 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, em seguida, novas atividades são transmitidas 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 entre reinicializações.

​
Onde aparece

As sessões capturadas aparecem em Sessions, e seus eventos no fluxo Events, da mesma forma que qualquer outro agente que você observa — portanto, replay de sessão, pesquisa, avaliações e alertas funcionam normalmente nelas. Filtre pelo agente do 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 o que o Codex leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão, portanto, ative a captura apenas em máquinas e para equipes nas quais centralizar esse conteúdo no AgentEye seja adequado, e forneça ao coletor uma chave com escopo apenas para events:add. Veja Segurança para entender como seus dados são mantidos isolados.