Análise de dados com o Codex: consultas, CSVs e resultados estruturados

O que o Codex faz em análise de dados

• Responde perguntas com SQL usando um role somente leitura ou uma réplica, e mostra a consulta junto com a resposta.
• Limpa e analisa exportações em CSV com Python e desenha os gráficos.
• Escreve um resumo semanal de métricas: o que mudou, quanto e o motivo provável.
• Aponta anomalias, como uma queda nos cadastros ou um pico de erros, antes que alguém precise notar.

Recursos do Codex para análise de dados

Como configurar o Codex para análise de dados

1. Conecte as ferramentas

   Dê ao Codex um role somente leitura e ligue o acesso à rede só se os dados não estiverem no workspace. Exportações em CSV na pasta do projeto não precisam de nada extra.

   # ~/.codex/config.toml: deixe os comandos acessarem o seu warehouse
   [sandbox_workspace_write]
   network_access = true

2. Escreva as regras no AGENTS.md

   O Codex lê o AGENTS.md antes de qualquer trabalho: ~/.codex/AGENTS.md e depois os arquivos da raiz do repositório até a pasta em que está trabalhando. Coloque ali as regras do trabalho, ou em uma skill em .agents/skills/ se forem longas. Veja o guia do AGENTS.md.

   ## Regras de dados
   - Somente leitura: use o role de analytics, nunca o usuário do
     banco do app. Nada de INSERT, UPDATE, DELETE ou mudanças de schema.
   - Mostre a consulta ou o script por trás de cada número.
   - Compare com o período anterior e diga quando uma mudança está
     dentro do ruído normal.
   - Não exporte dados pessoais; agregue antes de anotar qualquer
     coisa.
   - Resumo semanal: os cinco números que importam, o que mudou e
     uma pergunta que vale fazer na semana que vem.

3. Rode sem a interface interativa

   codex exec roda uma tarefa e encerra. O progresso vai para o stderr e a mensagem final para o stdout; -o também a grava em um arquivo e --json transmite os eventos. O sandbox é somente leitura, a menos que você passe --sandbox workspace-write.

   # Os números da semana passada em JSON que segue o seu schema
   codex exec --sandbox workspace-write --output-schema metrics.schema.json \
     -o metrics.json "Compare cadastros, ativação e receita da semana passada com a semana anterior"

4. Coloque em um agendamento

   Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), ou rode codex exec pelo cron. Veja como deixar o Codex proativo.

Fonte: documentação do Codex

Limites e segurança

• Dê a ele um role somente leitura. Um agente com permissão de escrita no banco consegue alterá-lo.
• Ele pode entender errado o que uma coluna significa. Escreva um dicionário de dados curto e confira as primeiras respostas.
• Resultados grandes custam contexto e uso. Consulte e agregue antes de ler linhas.
• O Codex roda os comandos em sandbox por padrão: as escritas ficam no workspace e a rede fica desligada. Deixe danger-full-access para um runner ou contêiner isolado.

Claude Code ou Codex para análise de dados?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: análise de dados com o Claude Code.

Coloque alguém responsável por análise de dados

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Codex em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

1. Comece pelo cargo

   O cargo de funcionário de IA que você escolher, com estas regras no brief.

2. Leve o trabalho para o quadro dele

   Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

3. Veja também

   O relatório diário de SEO é um exemplo prático de um trabalho recorrente de analytics.

Perguntas frequentes