Este é um tutorial em cinco partes para ajudar pesquisadores acadêmicos a começarem a usar o Codex.
Escrevi em linguagem acessível, e você não precisa de nenhum conhecimento técnico para entender este tutorial ou usar o Codex.
Parte 1: O que é o Codex?
O Codex é uma ferramenta que pode ser executada no seu computador. Não se intimide com a palavra "código". Você não precisa de nenhuma habilidade de programação para usá-lo. Você instala o aplicativo Codex no seu computador como faria com um aplicativo como Zoom ou Zotero.
Depois de instalá-lo no computador, você abre sua pasta de projeto (tese, dissertação, artigo, etc.) e deixa o Codex trabalhar dentro da pasta. O Codex pode ler arquivos na pasta, editar arquivos existentes e criar novos. Ele também pode continuar com sessões salvas e instruções de projeto quando você retornar ao seu trabalho.
Ao contrário de aplicativos baseados em navegador, como ChatGPT e Gemini, que só "conversam", o Codex pode realmente "fazer" coisas para você.
1.1 Por que você deveria se importar com isso?
Você é um pesquisador e tem uma pasta no seu computador com vários PDFs, rascunhos dos seus artigos, planilhas, conjuntos de dados e algumas transcrições de entrevistas. Todos esses documentos são relevantes para o seu projeto, mas você precisa fazer conexões entre a literatura publicada, os dados coletados e suas próprias anotações.
Este é o tipo de caso de uso para o qual o Codex é útil.
A maioria dos acadêmicos e pesquisadores já usou aplicativos de IA em seus navegador (ChatGPT, Claude, Gemini, etc.). Você abre uma guia e digita um comando, e a IA responde. Se quiser fazer perguntas sobre seus artigos ou rascunhos, você os adiciona ao ChatGPT ou Claude.
O Codex é diferente porque, em vez de você levar seus arquivos para um aplicativo de IA no navegador, você traz a IA para a pasta que contém todos os seus dados.
1.2 Por que o Codex é importante para o trabalho acadêmico
Existem duas maneiras fundamentais pelas quais o Codex pode funcionar como seu assistente de pesquisa confiável e poderoso.
Primeiro, o Codex pode seguir instruções do Codex pode seguir instruções do projeto sobre você, sua pesquisa, seu estilo de escrita e seus requisitos de pesquisa em evolução. Você não terá que explicar seus requisitos repetidamente se colocá-los em um arquivo de instruções visível.
Segundo, como o Codex trabalha dentro de uma pasta no seu computador, ele pode processar vários arquivos ao mesmo tempo. Por exemplo, ele pode percorrer os PDFs que consegue ler na sua pasta e extrair informações relevantes (objetivos, metodologia, etc.) deles. Você pode até pedir que ele crie um novo arquivo com base nas informações extraídas.
O Codex pode trabalhar com muitos tipos de arquivos, desde arquivos Word até planilhas do Excel, PDFs, etc., embora arquivos escaneados ou mal formatados possam precisar de verificação extra.
1.3 O que isso significa na prática?
Se você é um pesquisador qualitativo, carregue uma pasta cheia de transcrições de entrevistas e peça ao Codex para fornecer cada instância de uma determinada fala, por exemplo, como cada participante falou sobre um determinado assunto. Em seguida, peça que ele procure temas abrangentes entre as entrevistas.
Se você é um pesquisador quantitativo, adicione um CSV confuso ou uma planilha do Excel na sua pasta e peça ao Codex para limpá-la para você. Você pode pedir que ele execute estatísticas descritivas ou explique um comentário crítico feito por um revisor.
1.4 O que o Codex não é
O Codex é uma ferramenta incrivelmente poderosa, mas não substitui seu julgamento especializado. Ele pode rascunhar, resumir, codificar, mas o que conta como argumento ou evidência é sua responsabilidade.
Os acadêmicos que provavelmente terão sucesso ao usar o Codex são aqueles que o tratam como um assistente de pesquisa e não aqueles que terceirizam todo o seu pensamento e julgamento para ele.
Parte 2: Instalando o Aplicativo Codex, Sua Primeira Sessão
Se você é novo no Codex, reserve 15-20 minutos para instalá-lo e configurá-lo. Você não precisa de nenhuma habilidade de programação para usar o Codex.
Você precisará de um plano ChatGPT Plus ou Pro para usar o Codex no seu computador.
2.1 Instalação
O aplicativo Codex está disponível para Windows e Mac. Vá para openai.com/codex e baixe a versão compatível com seu computador. Execute-o como faria com qualquer outro instalador (por exemplo, Zoom, Zotero, etc.).
Abra o aplicativo depois de instalá-lo. Na primeira vez que abri-lo, o Codex pedirá que você faça login através do navegador ou conecte sua conta. Depois de fazer login, você verá um espaço de trabalho onde pode iniciar sessões.
Por padrão, o Codex criará uma pasta em seus "Documentos" chamada "Playground". Tudo o que você fizer será feito dentro desta pasta, a menos que você se mova para outra pasta.
2.2 Abrindo sua Primeira Pasta (Projeto)
O Codex trata as pastas como "Projetos". Exceto pelos nomes, não há diferença entre os dois.
Para praticar, crie uma pasta chamada "Codex Research Assistant" no seu computador. Em seguida, clique em "Playground" abaixo da barra de bate-papo. No menu suspenso, selecione "Adicionar novo projeto" e navegue até a pasta que você acabou de criar.
Agora o Codex está dentro dessa pasta. Ele tem acesso aos arquivos e subpastas dentro da pasta principal, de acordo com as permissões que você conceder.
2.3 Como é uma Sessão
Uma sessão é a conversa que você tem com o Codex no painel de bate-papo principal, assim como faz em aplicativos de navegador como o ChatGPT.
A interação é semelhante à dos aplicativos baseados em navegador, como o ChatGPT. A única diferença é que agora o Codex tem acesso aos seus arquivos no seu computador. Ele também tem a capacidade de criar arquivos no seu computador.
Depois de estar na pasta, dê um comando simples ao Codex, como:
Leia todos os artigos na pasta e me dê seus principais argumentos como um arquivo separado.
É isso. A maior parte da sua interação com o Codex será escrever instruções como esta.
O Codex prosseguirá e recuperará as informações relevantes dos artigos e começará a criar um novo arquivo. Este arquivo aparecerá na pasta em que você está trabalhando.
À medida que avança, ele pode pedir sua permissão para fazê-lo. Você pode configurar as permissões do Codex, mas no início, é uma boa ideia fazer com que o Codex peça permissões. Você não quer que o Codex acabe excluindo ou alterando arquivos importantes sem perguntar.
Cada sessão que você inicia no Codex é salva no histórico de conversas do aplicativo.
Parte 3: O Codex como seu Assistente de Pesquisa
Quando o Codex começa a trabalhar em uma pasta, ele procura um arquivo chamado AGENTS.md com um conjunto de instruções a seguir. Observe as letras maiúsculas, isso é importante.
Existem duas maneiras de criar um arquivo AGENTS.md: automática e manual.
3.1 Manualmente
Se quiser fazê-lo manualmente, abra o Bloco de Notas no Windows ou o TextEdit no Mac e escreva o tipo de instruções que deseja que o Codex siga. Observe que você só precisa escrever essas instruções em linguagem simples. Você não precisa usar nenhuma linguagem de programação.
Você pode dividir o arquivo AGENTS.md nas seguintes seções:
#Função
A cerquilha indica que é um título.
Descreva o tipo de função que você gostaria que o Codex assumisse como seu assistente de pesquisa. Dê alguns detalhes sobre sua área de pesquisa e projeto atual.
#Padrões
Descreva os padrões acadêmicos relevantes para sua área de pesquisa. Por exemplo, você pode dizer ao Codex para seguir um determinado estilo de citação ou uma estrutura específica de um artigo de pesquisa.
#Estilo de Escrita
Diga ao Codex o tipo de estilo de escrita que você gostaria que ele seguisse, se deseja que ele responda em estilo acadêmico ou em estilo informal.
#Estilo de Crítica
Descreva como você gostaria que o Codex criticasse seu trabalho, se gostaria de focar em seu argumento, evidência ou metodologia.
Salve o arquivo como AGENTS.md na pasta principal do seu projeto no computador e pronto.
Você não precisa ter um arquivo AGENTS.md perfeitamente elaborado. Você sempre pode voltar e editá-lo à medida que seu projeto evolui.
3.2 Automaticamente
Se você não quiser criar um arquivo AGENTS.md manualmente, basta iniciar uma sessão de bate-papo no Codex e fornecer detalhes sobre sua função, padrão, estilo de escrita e estilo de crítica. Em seguida, peça que ele crie um arquivo AGENTS.md usando essas informações.
O Codex criará o arquivo e o salvará na pasta do seu projeto.
3.3 Memória e Contexto do Projeto
À medida que você trabalha no seu projeto, o Codex pode usar as instruções e os arquivos na pasta do seu projeto como contexto. Algumas configurações do Codex também podem ter recursos de memória, mas você não deve confiar na memória oculta como a principal maneira de o Codex se lembrar do seu projeto.
Cada vez que você inicia uma sessão, o Codex pode ler o AGENTS.md e os arquivos do projeto que você pedir para ele inspecione e usá-los para responder às suas perguntas.
Com o tempo, suas instruções e anotações visíveis do projeto dão ao Codex contexto suficiente sobre você e seu trabalho que ele se torna um assistente de pesquisa confiável.
Você pode perguntar ao Codex sobre suas instruções digitando "Diga-me quais instruções você está seguindo para este projeto." Se uma determinada informação estiver desatualizada (por exemplo, um estilo de citação), basta atualizar o AGENTS.md com a nova informação.
3.4 O que não colocar no AGENTS.md
Não coloque nenhuma informação confidencial no AGENTS.md ou qualquer coisa que você não queira que a IA use.
Não deixe o AGENTS.md se tornar um conjunto de informações desatualizadas, pois isso terá um impacto considerável em sua saída. Você pode querer atualizar o arquivo a cada poucas semanas.
Parte 4: Trabalhando com seus Documentos de Pesquisa
Uma pasta do Codex não precisa ser muito bem organizada. Isso não significa que você comece a colocar arquivos irrelevantes nesta pasta. O que significa é que você não deve gastar tempo organizando-a antes de começar. O Codex pode ajudá-lo com isso. A única coisa que você pode querer ter em mente é não dar aos seus arquivos nomes confusos como Dissertação (final) (final2) (use este).
Adicione um monte de PDFs, arquivos Word, conjuntos de dados, transcrições de entrevistas, etc. relacionados ao seu projeto.
Suponha que você tenha vinte artigos de pesquisa relacionados ao seu tópico de pesquisa e queira encontrar um tema comum que perpasse todos eles. Ou talvez você tenha uma certa afirmação ou argumento e esteja procurando artigos que apresentem evidências apoiando ou contrastando essa afirmação.
Abra a pasta no Codex e escreva um comando como:
Leia cada PDF nesta pasta e me diga quais artigos discordam do seguinte argumento: [cole o argumento aqui]
O Codex lerá os PDFs que puder acessar na pasta e fornecerá as informações relevantes desses artigos. A resposta do Codex pode estar na forma de uma tabela.
4.1 Assistente de Pesquisa para Revisão de Literatura
Se você é um pesquisador biomédico ou um cientista social que frequentemente realiza revisões sistemáticas, baixe cinquenta artigos de pesquisa e coloque-os em uma pasta intitulada "Revisão Sistemática com Codex".
Abra a pasta no Codex e forneça seus critérios de triagem (inclusão/exclusão) e peça que ele trie todos os artigos na pasta.
O Codex triará os artigos de acordo com seus critérios e fornecerá os resultados na forma de uma tabela. Você ainda deve verificar os resultados antes de confiar neles.
4.2 Trabalhando com Transcrições
Se você é um pesquisador qualitativo, pode adicionar transcrições de entrevistas na pasta do Codex e pedir que ele extraia informações relacionadas a um determinado tópico.
Por exemplo, você pode pedir que ele extraia como cada entrevistado responde a uma determinada pergunta.
4.3 Dê ao Codex uma Tarefa Tediosa
Coloque cerca de cinquenta PDFs em uma pasta e abra-a no Codex. Em seguida, peça que ele os percorra todos e os renomeie usando seus títulos.
Você verá que o Codex fez o necessário em alguns minutos. No início, peça que ele mostre os novos nomes propostos antes de realmente renomear os arquivos.
4.4 Pedindo ao Codex para Criar Arquivos
Como seu projeto vai evoluir, você vai querer que o Codex crie alguns arquivos para você também, para que possa voltar a eles, se necessário. Isso também ajudará o Codex na recuperação fácil à medida que o projeto se desenvolve.
Sempre que pedir ao Codex para fazer uma tarefa significativa, como triar artigos ou extrair informações de transcrições, peça que ele salve sua resposta na pasta como um arquivo.
Geralmente, o Codex salvará esses arquivos como markdown (md), que ocupam muito menos espaço e são muito fáceis para o Codex recuperar informações. Mas você também pode pedir que ele crie um arquivo Word ou uma planilha do Excel.
Parte 5: Habilidades do Codex
Uma Habilidade é um conjunto de instruções que torna o Codex um especialista para uma tarefa. Assim como o arquivo AGENTS.md, uma Habilidade também é escrita em inglês simples, mas no Codex geralmente reside em uma pasta com um arquivo chamado SKILL.md. E assim como o AGENTS.md, você pode criar um arquivo de Habilidade manual e automaticamente.
Depois de criar uma Habilidade, o Codex pode usá-la quando a tarefa corresponder à descrição da Habilidade. Você também pode invocar uma Habilidade pelo nome, por exemplo, digitando algo como "$nome-da-habilidade" seguido do seu comando.
A maneira mais fácil de criar uma Habilidade é pedir ao Codex que faça isso por você. Digamos que você tenha chamadas regulares do Zoom e tenha transcrições dessas chamadas. Para cada chamada ou transcrição, você deseja extrair itens acionáveis ou coisas a fazer.
Para criar uma Habilidade, inicie uma sessão do Codex e simplesmente peça que ele crie uma Habilidade para extrair itens acionáveis de transcrições do Zoom.
O Codex começará a trabalhar. Ele pode fazer perguntas de acompanhamento e criar um arquivo de Habilidade que você pode editar se desejar. Talvez você queira que o Codex siga uma estrutura específica ao responder.
Depois que a Habilidade for criada, reinicie o Codex ou recarregue o Codex ou recarregue o projeto e a Habilidade estará pronta para uso.
5.1 Diferença entre AGENTS.md e Habilidades
O AGENTS.md contém instruções globais ou de nível de projeto sobre você e seu projeto. Ele dá ao Codex uma visão geral sobre você e sua pesquisa.
As Habilidades, por outro lado, são destinadas a tarefas específicas. Esses arquivos contêm informações muito mais específicas e granulares. O AGENTS.md, as Habilidades e as anotações visíveis do projeto trabalham em conjunto para lhe dar a melhor resposta possível.
5.2 O que não delegar ao Codex
O Codex é excelente em tarefas trabalhosas, demoradas e repetitivas. Terceirize essas tarefas para o Codex. Mas o Codex não será capaz de criar o que realmente conta como conhecimento acadêmico, porque não será capaz de fornecer argumentos novos e originais.
Ele pode sintetizar informações que você pode usar a serviço do seu argumento, mas a tarefa de criar um argumento original continua sendo sua como pesquisador.
