Ceci est un tutoriel en cinq parties pour aider les chercheurs académiques à démarrer avec Codex.
Je l'ai rédigé dans un langage accessible, et vous n'avez besoin d'aucune connaissance technique pour comprendre ce tutoriel ou utiliser Codex.
Partie 1 : Qu'est-ce que Codex ?
Codex est un outil qui peut fonctionner sur votre ordinateur. Ne vous laissez pas intimider par le mot « code ». Vous n'avez besoin d'aucune compétence en codage ou en programmation pour l'utiliser. Vous installez l'application Codex sur votre ordinateur comme vous le feriez pour une application comme Zoom ou Zotero.
Une fois que vous l'avez sur votre ordinateur, vous ouvrez votre dossier de projet (thèse, article, etc.) et laissez Codex travailler à l'intérieur du dossier. Codex peut lire les fichiers dans le dossier, modifier les fichiers existants et en créer de nouveaux. Il peut également reprendre des sessions sauvegardées et des instructions de projet lorsque vous revenez à votre travail.
Contrairement aux applications basées sur un navigateur comme ChatGPT et Gemini qui ne font que « parler », Codex peut réellement « faire » des choses pour vous.
1.1 Pourquoi devriez-vous vous y intéresser ?
Vous êtes chercheur et vous avez un dossier sur votre ordinateur contenant plusieurs PDF, des brouillons de vos articles, des feuilles de calcul, des ensembles de données et quelques transcriptions d'entretiens. Tous ces documents sont pertinents pour votre projet, mais vous devez établir des liens entre la littérature publiée, les données collectées et vos propres notes.
C'est le genre de cas d'utilisation pour lequel Codex est utile.
La plupart des universitaires et chercheurs ont utilisé des applications d'IA dans leur navigateur (ChatGPT, Claude, etc.). Vous ouvrez un onglet, tapez une instruction et l'IA répond. Si vous souhaitez poser des questions sur vos articles ou brouillons, vous les ajoutez à ChatGPT ou Claude.
Codex est différent car au lieu que vous apportiez vos fichiers à une application d'IA dans le navigateur, vous amenez l'IA dans le dossier contenant toutes vos données.
1.2 Pourquoi Codex est important pour le travail académique
Il existe deux manières fondamentales par lesquelles Codex peut fonctionner comme votre assistant de recherche fiable et puissant.
Premièrement, Codex peut suivre des instructions de projet vous concernant, votre recherche, votre style d'écriture et vos exigences de recherche en évolution. Vous n'aurez pas à expliquer vos exigences à plusieurs reprises si vous les placez dans un fichier d'instructions visible.
Deuxièmement, comme Codex travaille dans un dossier sur votre ordinateur, il peut traiter plusieurs fichiers à la fois. Par exemple, il peut parcourir les PDF qu'il peut lire dans votre dossier et en extraire des informations pertinentes (objectifs, méthodologie, etc.). Vous pouvez même lui demander de créer un nouveau fichier basé sur les informations extraites.
Codex peut travailler avec de nombreux types de nombreux types de fichiers, des fichiers Word aux feuilles Excel, PDF, etc., bien que les fichiers numérisés ou mal formatés puissent nécessiter une vérification supplémentaire.
1.3 Qu'est-ce que cela signifie en termes pratiques ?
Si vous êtes un chercheur qualitatif, chargez un dossier rempli de transcriptions d'entretiens et demandez à Codex de vous donner chaque occurrence d'une énonciation particulière, par exemple comment chaque participant a parlé d'un sujet donné. Demandez-lui ensuite de rechercher des thèmes généraux dans les entretiens.
Si vous êtes un chercheur quantitatif, ajoutez un CSV désordonné ou une feuille Excel dans votre dossier et demandez à Codex de le nettoyer pour vous. Vous pouvez lui demander d'effectuer des statistiques descriptives ou d'expliquer un commentaire critique fait par un relecteur.
1.4 Ce que Codex n'est pas
Codex est un outil incroyablement puissant, mais ce n'est pas un remplacement pour votre jugement d'expert. Il peut rédiger, résumer, coder, mais ce qui compte comme argument ou preuve est votre responsabilité.
Les universitaires qui réussiront probablement à utiliser Codex sont ceux qui le traitent comme un assistant de recherche et non ceux qui lui confient toute leur réflexion et leur jugement.
Partie 2 : Installation de l'application Codex, votre première session
Si vous débutez avec Codex, prévoyez 15 à 20 minutes pour l'installer et le configurer. Vous n'avez besoin d'aucune compétence en codage pour utiliser Codex.
Vous aurez besoin d'un abonnement ChatGPT Plus ou Pro pour utiliser Codex sur votre ordinateur.
2.1 Installation
L'application Codex est disponible pour Windows et Mac. Allez sur openai.com/codex et téléchargez la version compatible avec votre ordinateur. Exécutez-la comme vous le feriez pour tout autre installateur (par exemple Zoom, Zotero, etc.).
Ouvrez l'application une fois que vous l'avez installée. La première fois que vous l'ouvrez, Codex vous demandera de vous connecter via le navigateur ou connecter votre compte. Une fois connecté, vous verrez un espace de travail où vous pouvez démarrer des sessions.
Par défaut, Codex créera un dossier dans vos « Documents » appelé « Playground ». Tout ce que vous ferez sera fait dans ce dossier à moins que vous ne vous déplaciez vers un autre dossier.
2.2 Ouverture de votre premier dossier (Projet)
Codex traite les dossiers comme des « Projets ». À part les noms, il n'y a aucune différence entre les deux.
Pour vous entraîner, créez un dossier appelé « Codex Research Assistant de recherche Codex » sur votre ordinateur. Cliquez ensuite sur « Playground » sous la barre de chat. Dans le menu déroulant, sélectionnez « Ajouter un nouveau projet » et naviguez jusqu'au dossier que vous venez de créer.
Maintenant, Codex est à l'intérieur de ce dossier. Il a accès aux fichiers et sous-dossiers du dossier principal, selon les autorisations que vous lui donnez.
2.3 À quoi ressemble une session
Une session est la conversation que vous avez avec Codex dans le panneau de chat principal, comme vous le faites dans les applications navigateur comme ChatGPT.
L'interaction est similaire à celle des applications basées sur un navigateur comme ChatGPT. La seule différence est que Codex a désormais accès à vos fichiers sur votre ordinateur. Il a également la capacité de créer des fichiers sur votre ordinateur.
Une fois que vous êtes dans le dossier, donnez une instruction simple à Codex comme :
Lisez tous les articles du dossier et donnez-moi leurs principaux arguments dans un fichier séparé.
Voilà. La plupart de vos interactions avec Codex consisteront à écrire des instructions comme celle-ci.
Codex va récupérer les informations pertinformatiques pertinentes des articles et commencer à créer un nouveau fichier. Ce fichier apparaîtra dans le dossier sur lequel vous travaillez.
Au fur et à mesure, il peut vous demander l'autorisation de le faire. Vous pouvez configurer les autorisations de Codex, mais au début, il est bon de faire demander des autorisations. Vous ne voulez pas que Codex supprime ou modifie des fichiers importants sans vous demander.
Chaque session que vous démarrez dans est sauvegardée dans l'historique des conversations de conversations de l'application.
Partie 3 : Codex en tant qu'assistant de recherche
Lorsque Codex commence à travailler dans un dossier, il cherche un fichier AGENTS.md contenant un ensemble d'instructions à suivre. Remarquez les lettres majuscules, c'est important.
Il existe deux façons de créer un fichier AGENTS.md : automatique et manuelle.
3.1 Manuellement
Si vous souhaitez le faire manuellement, ouvrez Notepad sur Windows ou TextEdit sur un Mac et notez le type d'instructions que vous voulez que Codex suive. Veuillez noter que vous avez besoin d'écrire ces instructions en langage simple. Vous n'avez besoin d'utiliser aucun langage de codage ou de programmation.
Vous pouvez diviser le fichier AGENTS.md en sections suivantes :
#Rôle
Le signe dièse indique qu'il s'agit d'un titre.
Décrivez le type de rôle que vous souhaitez que Codex assume en tant qu'assistant de recherche. Donnez-lui quelques détails sur votre domaine de recherche et votre projet actuel.
#Normes
Décrivez les normes académiques pertinentes pour votre domaine de recherche. Par exemple, vous pouvez dire à Codex de suivre un style de citation donné ou une structure spécifique d'un article de recherche.
#Style d'écriture
Dites à Codex le style d'écriture que vous souhaitez qu'il suive, que vous vouliez qu'il réponde dans un style académique ou informel.
#Style de critique
Décrivez comment vous souhaitez que Codex critique votre travail, que vous souhaitiez vous concentrer sur votre argument, les preuves ou la méthodologie.
Enregistrez le fichier sous AGENTS.md dans votre dossier de projet principal sur votre ordinateur et vous avez terminé.
Vous n'avez pas besoin d'avoir un fichier AGENTS.md parfaitement rédigé. Vous pouvez toujours revenir en arrière et le modifier à mesure que votre projet évolue.
3.2 Automatiquement
Si vous ne voulez pas créer un fichier AGENTS.md manuellement, démarrez simplement une session de chat dans Codex et donnez-lui des détails sur son rôle, ses normes, son style d'écriture et son style de critique. Demandez-lui ensuite de créer un fichier AGENTS.md en utilisant ces informations.
Codex créera le fichier et l'enregistrera dans votre dossier de projet.
3.3 Mémoire et contexte du projet
Au fur et à mesure que vous travaillez sur votre projet, Codex peut utiliser les instructions et les fichiers de votre dossier de projet comme contexte. Certaines configurations de Codex peuvent également avoir des fonctionnalités de mémoire, mais vous ne devez pas compter sur la mémoire cachée comme principal moyen pour Codex de se souvenir de votre projet.
Chaque fois que vous démarrez une session, Codex peut lire AGENTS.md et les fichiers du projet que vous lui demandez d'inspecter et les utilise pour répondre à vos questions.
Au fil du temps, vos instructions et vos notes de projet visibles donnent à Codex suffisamment de contexte sur vous et votre travail pour qu'il devienne un assistant de recherche fiable.
Vous pouvez demander à Codex à propos de ses instructions en tapant « Dis-moi quelles instructions tu suis pour ce projet ». Si une certaine information est obsolète (par exemple un style de citation), mettez simplement à jour AGENTS.md avec les nouvelles informations.
3.4 Ce qu'il ne faut pas mettre dans AGENTS.md
Ne mettez aucune information confidentielle dans AGENTS.md ni rien que vous ne voulez pas que l'IA utilise.
Ne laissez pas AGENTS.md devenir un ensemble d'informations obsolètes car cela aura un impact considérable sur sa sortie. Vous voudrez peut-être mettre à jour le fichier toutes les quelques semaines.
Partie 4 : Travailler avec vos documents de recherche
Un dossier Codex ne doit pas être très bien organisé. Cela ne signifie pas que vous commenciez à y mettre des fichiers non pertinents. Cela signifie que vous ne devez pas passer de temps à l'organiser avant de commencer. Codex peut vous aider à le faire. La seule chose que vous voudrez peut-être garder à l'esprit est de ne pas donner à vos fichiers des noms confus comme Thèse (finale) (finale2) (utilisez celle-ci).
Ajoutez un tas de PDF, fichiers Word, ensembles de données, transcriptions d'entretiens, etc. liés à votre projet.
Supposons que vous ayez vingt articles de recherche liés à votre sujet de recherche et que vous souhaitiez trouver un thème commun qui les traverse tous. Ou peut-être avez-vous une certaine affirmation ou un certain argument, et vous cherchez des articles qui présentent des preuves soutenant ou contrastant cette affirmation.
Ouvrez le dossier dans Codex et écrivez une instruction comme :
Lisez chaque PDF de ce dossier et dites-moi quels articles sont en désaccord avec l'argument suivant : [collez l'argument ici]
Codex lira les PDF auxquels il peut accéder dans le dossier et vous donnera les informations pertinentes de ces articles. La réponse de Codex peut se présenter sous forme de tableau.
4.1 Assistant de recherche pour la revue de littérature
Si vous êtes un chercheur biomédical ou un chercheur en sciences sociales qui effectue fréquemment des revues systématiques, téléchargez cinquante articles de recherche et placez-les dans un dossier intitulé « Revue systématique avec Codex ».
Ouvrez le dossier dans Codex et donnez-lui vos critères de sélection (inclusion/exclusion) et demandez-lui de filtrer tous les articles du dossier.
Codex filtrera les articles selon vos critères et vous donnera les résultats sous forme de tableau. Vous devez toujours vérifier les résultats vous-même avant de vous y fier.
4.2 Travailler avec des transcriptions
Si vous êtes un chercheur qualitatif, vous pouvez ajouter des transcriptions d'entretiens dans le dossier Codex et lui demander d'extraire des informations liées à un sujet donné.
Par exemple, vous pouvez lui demander d'extraire comment chaque répondant répond à une question donnée.
4.3 Confiez une tâche fastidieuse à Codex
Mettez une cinquantaine de PDF dans un dossier et ouvrez-le dans Codex. Demandez-lui ensuite de les parcourir tous et de les renommer en utilisant leurs titres.
Vous verrez que Codex a fait le nécessaire en quelques minutes. Au début, demandez-lui de vous montrer les nouveaux noms proposés avant de renommer les fichiers.
4.4 Demander à Codex de créer des fichiers
Comme votre projet va évoluer, vous voudrez que Codex crée certains fichiers pour vous aussi afin que vous puissiez y revenir si nécessaire. Cela aidera également Codex à les récupérer facilement au fur et à mesure que le projet se développe.
Chaque fois que vous demandez à Codex d'effectuer une tâche importante comme filtrer des articles ou extraire des informations de transcriptions, demandez-lui d'enregistrer votre réponse dans le dossier sous forme de fichier.
Généralement, Codex enregistrera ces fichiers en markdown (md), qui prennent très peu de place et sont très faciles pour Codex pour en récupérer des informations. Mais vous pouvez aussi lui demander de créer un fichier Word ou une feuille Excel.
Partie 5 : Les compétences de Codex
Une compétence est un ensemble d'instructions qui fait de Codex un spécialiste pour une tâche. Tout comme le fichier AGENTS.md, une compétence est également rédigée en anglais simple, mais dans Codex, elle réside généralement dans un dossier avec un fichier SKILL.md. Et tout comme AGENTS.md, vous pouvez créer un fichier de compétence à la fois manuellement et automatiquement.
Une fois que vous créez une compétence, Codex peut l'utiliser lorsque la tâche correspond à la description de la compétence. Vous pouvez également invoquer une compétence vous-même par son nom, par exemple en tapant quelque chose comme « $nom-de-la-compétence » votre instruction.
La façon la plus simple de créer une compétence est de demander à Codex de le faire pour vous. Disons que vous avez des appels Zoom réguliers et que vous avez des transcriptions de ces appels. Pour chaque appel ou transcription, vous souhaitez extraire des éléments actionnables ou des choses à faire.
Pour créer une compétence, démarrez une session Codex et demandez-lui simplement de créer une compétence pour extraire des éléments actionnables des transcriptions Zoom.
Codex se mettra au travail. Il peut vous poser des questions de suivi et créer un fichier de compétence que vous pouvez modifier si vous le souhaitez. Peut-être que vous voulez que Codex suive une structure spécifique en répondant.
Une fois la compétence créée, redémarrez Codex ou rechargez le projet et la compétence sera prête à être utilisée.
5.1 Différence entre AGENTS.md et les compétences
AGENTS.md contient des instructions globales ou au niveau du projet vous concernant et votre projet. Il donne à Codex la vue d'ensemble de vous et de votre recherche.
Les compétences, en revanche, sont destinées à des tâches particulières. Ces fichiers contiennent des informations beaucoup plus spécifiques et granulaires. AGENTS.md, les compétences et les notes de projet visibles travaillent de concert pour vous donner la meilleure réponse possible.
5.2 Ce qu'il ne faut pas déléguer à Codex
Codex est excellent pour les tâches à forte intensité de main-d'œuvre, longues et répétitives. Externalisez ces tâches à Codex. Mais Codex ne pourra pas créer ce qui constitue réellement une bourse d'études car il ne pourra pas vous donner des arguments nouveaux et originaux.
Il peut synthétiser des informations que vous pouvez ensuite utiliser au service de votre argument, mais le travail de trouver un argument original reste le vôtre en tant que chercheur.
