Questo è un tutorial in cinque parti per aiutare i ricercatori accademici a iniziare con Codex.
L'ho scritto in un linguaggio accessibile, e non hai bisogno di alcuna conoscenza tecnica per capire questo tutorial o usare Codex.
Parte 1: Cos'è Codex?
Codex è uno strumento che può essere eseguito sul tuo computer. Non lasciarti intimidire dalla parola "codice". Non hai bisogno di competenze di programmazione o coding per usarlo. Installa l'app Codex sul tuo computer proprio come faresti con un'app come Zoom o Zotero.
Una volta che lo hai sul computer, apri la cartella del tuo progetto (tesi, articolo, ecc.) e lascia che Codex lavori all'interno della cartella. Codex può leggere i file nella cartella, modificare file esistenti e crearne di nuovi. Può anche continuare con sessioni salvate e istruzioni di progetto quando torni al tuo lavoro.
A differenza delle app basate su browser come ChatGPT e Gemini che "parlano" e basta, Codex può effettivamente "fare" cose per te.
1.1 Perché Dovresti Interessartene?
Sei un ricercatore e hai una cartella sul tuo computer con diversi PDF, bozze dei tuoi articoli, fogli di calcolo, dataset e alcune trascrizioni di interviste. Tutti questi documenti sono pertinenti al tuo progetto, ma devi creare connessioni tra la letteratura pubblicata, dati raccolti e tue note.
Questo è il tipo di caso d'uso per cui Codex è utile.
La maggior parte degli accademici e dei ricercatori ha usato app AI nei propri browser (ChatGPT, Claude, Gemini, ecc.). Apri una scheda, scrivi un prompt e l'AI risponde. Se vuoi fare domande sui tuoi articoli o bozze, li aggiungi a ChatGPT o Claude.
Codex è diverso perché invece di portare i tuoi file a un'app AI nel browser, porti l'AI nella cartella che contiene tutti i tuoi dati.
dati.
1.2 Perché Codex è Importante per il Lavoro Accademico
Ci sono due modi fondamentali in cui Codex può funzionare come tuo assistente di ricerca affidabile e potente.
In primo luogo, Codex può seguire le istruzioni di progetto su di te, la tua ricerca, il tuo stile di scrittura e le tue esigenze di ricerca in evoluzione. Non dovrai spiegare le tue richieste ripetutamente se le inserisci in un file di istruzioni visibile.
In secondo luogo, poiché Codex lavora all'interno di una cartella sul tuo computer, può elaborare più file contemporaneamente. Ad esempio, può esaminare i PDF che può leggere nella tua cartella ed estrarre informazioni pertinenti (obiettivi, metodologia, ecc.) da essi. Puoi persino chiedergli di creare un nuovo file basato sulle informazioni estratte.
Codex può lavorare con molti tipi di file, dai file Word ai fogli Excel, PDF, ecc., anche se i file scansionati o mal formattati potrebbero richiedere un controllo aggiuntivo.
1.3 Cosa Significa in Termini Pratici?
Se sei un ricercatore qualitativo, carica una cartella piena di trascrizioni di interviste e chiedi a Codex di darti ogni occorrenza di una particolare espressione, ad esempio come ogni partecipante ha parlato di un dato argomento. Poi chiedigli di cercare temi ricorrenti tra le interviste.
Se ricercatore quantitativo, aggiungi un CSV disordinato o un foglio Excel nella tua cartella e chiedi a Codex di pulirlo per te. Puoi chiedergli di eseguire statistiche descrittive o di spiegare un commento critico fatto da un revisore.
1.4 Cosa Codex Non È
Codex è uno strumento incredibilmente potente, ma non è un sostituto del tuo giudizio esperto. Può abbozzare, riassumere, codificare, ma ciò che conta come argomento o prova è una tua responsabilità.
Gli accademici che probabilmente avranno successo usando Codex sono quelli che lo trattano come un assistente di ricerca e non quelli che esternalizzano tutto il loro pensiero e giudizio ad esso.
Parte 2: Installare l'App Codex, La Tua Prima Sessione
Se sei nuovo di Codex, metti da parte 15-20 minuti per installarlo e configurarlo. Non hai bisogno di competenze di programmazione per usare Codex.
Avrai bisogno di un piano ChatGPT Plus o Pro per usare Codex sul tuo computer.
sul tuo computer.
2.1 Installazione
L'app Codex è disponibile sia per Windows che per Mac. Vai su openai.com/codex e scarica la versione compatibile con il tuo computer. Esegui come faresti con qualsiasi altro programma di installazione (es. Zoom, Zotero, ecc.).
Apri l'app una volta installata. La prima volta che la apri, Codex ti chiederà di accedere tramite il browser o di collegare il tuo account. Una volta effettuato l'accesso, vedrai un'area di lavoro dove puoi avviare le sessioni.
Per impostazione predefinita, Codex creerà una cartella nei "Documenti" chiamata "Playground". Tutto ciò che fai avverrà all'interno di questa cartella a meno che non ti sposti in un'altra cartella.
2.2 Aprire La Tua Prima Cartella (Progetto)
Codex tratta le cartelle come "Progetti". Eccetto per i nomi, non c'è differenza tra i due.
Per esercitarti, crea una cartella chiamata "Codex Research Assistant" sul tuo computer. Quindi clicca su "Playground" sotto la barra della chat. Dal menu a tendina, seleziona "Aggiungi nuovo progetto" e vai alla cartella che hai appena creato.
Ora Codex è all'interno di quella cartella. Ha accesso ai file e alle sottocartelle all'interno della cartella principale, secondo le autorizzazioni che gli concedi.
2.3 Com'è una Sessione
Una sessione è la conversazione che hai con Codex nel pannello di chat principale, proprio come fai nelle app browser come ChatGPT.
L'interazione è simile alle app basate su browser come ChatGPT. L'unica differenza è che ora Codex ha accesso ai tuoi file sul tuo computer. Ha anche la capacità di creare file sul tuo computer.
Una volta che sei nella cartella, dai a Codex un prompt semplice come:
Leggi tutti gli articoli nella cartella e dammi i loro argomenti principali in un file separato.
Tutto qui. La maggior parte della tua interazione con Codex consisterà nello scrivere istruzioni come questa.
Codex procederà a recuperare le informazioni pertinenti dagli articoli e inizierà a creare un nuovo file. Questo file apparirà nella cartella in cui stai lavorando.
Mentre procede, potrebbe chiederti il permesso di farlo. Puoi configurare le autorizzazioni di Codex, ma all'inizio è una buona idea farlo chiedere il permesso. Non vuoi che Codex cancelli o modifichi file importanti senza chiedertelo.
Ogni sessione che avvii in Codex viene salvata nella cronologia delle conversazioni dell'app.
Parte 3: Codex Come Tuo Assistente di Ricerca
Quando Codex inizia a lavorare in una cartella, cerca un file chiamato AGENTS.md con una serie di istruzioni da seguire. Nota le lettere maiuscole, questo è importante.
Ci sono due modi per l'importante.
Ci sono due modi per creare un file AGENTS.md: automatico e manuale.
3.1 Manualmente
Se vuoi farlo manualmente, apri Blocco note su Windows o TextEdit su un Mac e scrivi il tipo di istruzioni che vuoi che Codex segua. Nota che devi scrivere queste istruzioni in linguaggio semplice. Non hai bisogno di usare alcun linguaggio di programmazione o coding.
Puoi dividere il file AGENTS.md nelle seguenti sezioni:
#Ruolo
Il cancelletto qui indica che è un'intestazione.
Descrivi il tipo di ruolo che vorresti che Codex assumesse come tuo assistente di ricerca. Fornisci alcuni dettagli sul tuo campo di ricerca e sul progetto attuale.
#Standard
Descrivi gli standard accademici pertinenti al tuo campo di ricerca. Ad esempio, puoi dire a Codex di seguire un determinato stile di citazione o una struttura specifica di un articolo di ricerca.
#Stile di Scrittura
Di' a Codex il tipo di stile di scrittura che vorresti che seguisse, se vuoi che risponda in stile accademico o in stile informale.
#Stile di Critica
Descrivi come vorresti che Codex criticasse il tuo lavoro, se vuoi che si concentri sul tuo argomento, sulle prove o sulla metodologia.
Salva il file come AGENTS.md nella cartella principale del tuo progetto sul tuo computer e il gioco è fatto.
Non hai bisogno di un file AGENTS.md perfettamente elaborato. Puoi sempre tornare indietro e modificarlo man mano che il tuo progetto evolve.
3.2 Automaticamente
Se non vuoi creare un file AGENTS.md manualmente, avvia semplicemente una sessione di chat in Codex e fornisci dettagli sul suo ruolo, standard, stile di scrittura e stile di critica. Poi chiedigli di creare un file AGENTS.md usando queste informazioni.
Codex creerà il file e lo salverà nella cartella del tuo progetto.
3.3 Memoria e Contesto del Progetto
Mentre lavori al tuo progetto, Codex può usare le istruzioni e i file nella cartella del progetto come contesto. Alcune configurazioni di Codex potrebbero anche avere funzionalità di memoria, ma non dovresti fare affidamento sulla memoria nascosta come modo principale per ricordare il tuo progetto.
Ogni volta che avvii una sessione, Codex può leggere AGENTS.md e i file di progetto che gli chiedi di ispezionare e li usa per rispondere alle tue domande.
Nel tempo, le tue istruzioni e le note di progetto visibili danno a Codex abbastanza contesto su di te e del tuo lavoro da diventare un assistente di ricerca affidabile.
Puoi chiedere a Codex informazioni sulle sue istruzioni digitando "Dimmi quali istruzioni stai seguendo per questo progetto". Se una certa informazione è obsoleta (es. uno stile di citazione), aggiorna semplicemente AGENTS.md con le nuove informazioni.
3.4 Cosa Non Mettere in AGENTS.md
Non inserire informazioni riservate in AGENTS.md o qualsiasi cosa che non vuoi che l'AI usi.
Non lasciare che AGENTS.md diventi un insieme di informazioni obsolete, perché ciò avrà un impatto considerevole sul suo output. Potresti voler aggiornare il file ogni poche settimane.
Parte 4: Lavorare con i Tuoi Documenti di Ricerca
Una cartella di Codex non deve essere molto ben organizzata. Questo non significa che inizi a mettere file irrilevanti in questa cartella. Significa che non dovresti passare tempo a organizzarla prima di iniziare. Codex può aiutarti a farlo. L'unica cosa che potresti voler tenere a mente è di non dare ai tuoi file nomi confusionari come Tesi (finale) (finale2) (usa questo).
Aggiungi un mucchio di PDF, file Word, dataset, trascrizioni di interviste, ecc. relativi al tuo progetto.
Supponi supponi di avere venti articoli di ricerca relativi al tuo argomento di ricerca e vuoi trovare un tema comune che li attraversa tutti. O forse hai una certa affermazione o argomento, e stai cercando articoli che presentino prove a sostegno o in contrasto con tale affermazione.
Apri la cartella in Codex e scrivi un prompt come:
Leggi ogni PDF in questa cartella e dimmi quali articoli sono in disaccordo con il seguente argomento: [incolla l'argomento qui]
Codex leggerà i PDF a cui può accedere nella cartella e ti darà le informazioni pertinenti da questi articoli. La risposta di Codex potrebbe essere sotto forma di tabella.
4.1 Assistente di Ricerca per la Revisione della Letteratura
Se sei un ricercatore biomedico o uno scienziato sociale che conduce frequentemente revisioni sistematiche, scarica cinquanta articoli di ricerca e mettili in una cartella intitolata "Revisione Sistematica con Codex".
Apri la cartella in Codex e fornisci i tuoi criteri di screening (inclusione/esclusione) e chiedigli di selezionare tutti gli articoli nella cartella.
Codex selezionerà gli articoli secondo i tuoi criteri e ti darà i risultati sotto forma di tabella. Dovresti verificare i risultati da solo prima di fare affidamento su di essi.
4.2 Lavorare con le Trascrizioni
Se sei un ricercatore qualitativo, puoi aggiungere trascrizioni di interviste nella cartella di Codex e chiedergli di estrarre informazioni relative a un dato argomento.
Ad esempio, puoi chiedergli di estrarre come ogni intervistato risponde a una determinata domanda.
4.3 Dai a Codex un Compito Noioso
Metti una cinquantina di PDF in una cartella e aprila in Codex. Poi chiedigli di esaminarli tutti e rinominarli usando i loro titoli.
Vedrai che Codex ha fatto il necessario in un paio di minuti. All'inizio, chiedigli di mostrarti i nuovi nomi proposti prima di rinominare effettivamente i file.
4.4 Chiedere a Codex di Creare File
Poiché il tuo progetto si evolverà, vorrai che Codex crei anche alcuni file per te in modo da poterli recuperare se necessario. Aiuterà anche Codex con un facile recupero man mano che il progetto si sviluppa.
Ogni volta che chiedi a Codex di svolgere un compito significativo come selezionare articoli o estrarre informazioni dalle trascrizioni, chiedigli di salvare la risposta nella cartella come file.
Generalmente, Codex salverà questi file come markdown (md), che occupano molto meno spazio e sono molto facili per Codex recuperare informazioni. Ma puoi anche chiedergli di creare un file Word o un foglio Excel.
Parte 5: Competenze di Codex
Una Competenza (Skill) è un insieme di istruzioni che rende Codex specializzato per un compito. Proprio come il file AGENTS.md, una Competenza è scritta in inglese semplice, ma in Codex di solito risiede in una cartella con un file chiamato SKILL.md. E proprio come AGENTS.md, puoi creare un file di Competenza sia manualmente che manualmente che automaticamente.
Una volta creata una Competenza, Codex può usarla quando il compito corrisponde alla descrizione della Competenza. Puoi anche invocare una Competenza tu stesso per nome, ad esempio digitando qualcosa come "$nome-competenza"
Il modo più semplice per creare una Competenza è chiedere a Codex di farlo per te. Diciamo che hai regolari chiamate Zoom e hai le trascrizioni di queste chiamate. Per ogni chiamata o trascrizione, vuoi estrarre elementi attuabili o cose da fare.
Per creare una Competenza, avvia una sessione di Codex e chiedigli semplicemente di creare una Competenza per estrarre elementi attuabili dalle trascrizioni di Zoom.
Codex si metterà al lavoro. Potrebbe farti domande di approfondimento e creare un file di Competenza che puoi modificare se vuoi. Forse vuoi che Codex segua una struttura specifica mentre risponde.
Una volta creata la Competenza, riavvia Codex o ricarica il progetto e la Competenza sarà pronta per l'uso.
5.1 Differenza tra AGENTS.md e Competenze
AGENTS.md contiene istruzioni globali o a livello di progetto su di te e il tuo progetto. Dà a Codex il quadro generale su di te e la tua ricerca.
Le Competenze, d'altra parte, sono destinate a compiti particolari. Questi file contengono informazioni molto più specifiche e granulari. AGENTS.md, le Competenze e le note di progetto visibili lavorano in concerto per darti la migliore risposta possibile.
5.2 Cosa Non Delegare a Codex
Codex è ottimo per compiti che richiedono molto lavoro, tempo e sono ripetitivi. Esternalizza questi compiti a Codex. Ma Codex non sarà in grado di creare ciò che conta come borsa di studio, perché non sarà in grado di darti argomenti nuovi e originali.
Può sintetizzare informazioni che puoi poi utilizzare a sostegno del tuo argomento, ma il compito di elaborare un argomento originale rimane tuo come ricercatore.
