Codex 101 para investigadores académicos

Esta es una guía de cinco partes para ayudar a investigadores académicos a comenzar con Codex.

La he escrito en un lenguaje accesible, y no necesitas ningún conocimiento técnico para entender este tutorial o usar Codex.

Parte 1: ¿Qué es Codex?

Codex es una herramienta que puede ejecutarse en tu computadora. No te intimides por la palabra "código". No necesitas ninguna habilidad de programación para usarlo. Instalas la aplicación de Codex en tu computadora como lo harías con una aplicación como Zoom o Zotero.

Una vez que lo tienes en tu computadora, abres la carpeta de tu proyecto (tesis, artículo, etc.) y dejas que Codex trabaje dentro de la carpeta. Codex puede leer archivos en la carpeta, editar archivos existentes y crear nuevos. También puede continuar con sesiones guardadas e instrucciones del proyecto cuando vuelvas a tu trabajo.

A diferencia de las aplicaciones basadas en navegador como ChatGPT y Gemini que solo "hablan", Codex realmente puede "hacer" cosas por ti.

1.1 ¿Por qué debería importarte?

Eres un investigador y tienes en tu computadora una carpeta con varios PDFs, borradores de tus artículos, hojas de cálculo, conjuntos de datos y algunas transcripciones de entrevistas. Todos estos documentos son relevantes para tu proyecto, pero necesitas establecer conexiones entre la literatura publicada, los datos recopilados y tus propias notas.

Este es el tipo de caso de uso para el que Codex es útil.

La mayoría de los académicos e investigadores han usado aplicaciones de IA en sus navegadores (ChatGPT, Claude, Gemini, etc.). Abres una pestaña, escribes un mensaje y la IA responde. Si quieres hacer preguntas sobre tus artículos o borradores, los agregas a ChatGPT o Claude.

Codex es diferente porque, en lugar de que tú lleves tus archivos a una IA en el navegador, tú traes la IA a la carpeta que contiene todos tus datos.

1.2 Por qué Codex es importante para el trabajo académico

Hay dos formas fundamentales en las que Codex puede funcionar como tu asistente de investigación confiable y poderoso.

Primero, Codex puede seguir instrucciones del proyecto sobre ti, tu investigación, tu estilo de escritura y tus requisitos de investigación en evolución. No tendrás que explicar tus requisitos repetidamente si los colocas en un archivo de instrucciones visible.

En segundo lugar, dado que Codex trabaja dentro de tu computadora, puede procesar varios archivos a la vez. Por ejemplo, puede revisar los PDFs que puede leer en tu carpeta y extraer información relevante (objetivos, metodología, etc.) de ellos. Incluso puedes pedirle que cree un nuevo archivo basado en la información extraída.

Codex puede trabajar con muchos tipos de archivos, desde archivos de Word hasta hojas de Excel, PDFs, etc., aunque los archivos escaneados o mal formateados pueden necesitar una verificación adicional.

1.3 ¿Qué significa en términos prácticos?

Si eres un investigador cualitativo, carga una carpeta llena de transcripciones de entrevistas y pídele a Codex que te dé cada instancia de una expresión particular, por ejemplo, cómo cada participante habló sobre un tema determinado. Luego pídele que busque temas generales en todas las entrevistas.

Si eres un investigador cuantitativo, agrega un CSV desordenado o una hoja de Excel en tu carpeta y pídele a Codex que lo limpie por ti. Puedes pedirle que ejecute estadísticas descriptivas o que explique un comentario crítico de un revisor.

1.4 Lo que Codex no es

Codex es una herramienta increíblemente poderosa, pero no reemplaza tu juicio experto. Puede redactar, resumir, codificar, pero lo que cuenta como argumento o evidencia es tu responsabilidad.

Los académicos que probablemente tengan éxito usando Codex son aquellos que lo tratan como un asistente de investigación y no aquellos que externalizan todo su pensamiento y juicio.

Parte 2: Instalación de la aplicación Codex, tu primera sesión

Si eres nuevo en Codex, reserva de 15 a 20 minutos para instalarlo y configurarlo. No necesitas ninguna habilidad de programación para usar Codex.

Necesitarás un plan ChatGPT Plus o Pro para usar Codex en tu computadora.

2.1 Instalación

La aplicación de Codex está disponible tanto para Windows como para Mac. Ve a openai.com/codex y descarga la versión compatible con tu computadora. Ejecútala como lo harías con cualquier otro instalador (por ejemplo, Zoom, Zotero, etc.).

Abre la aplicación una vez que la hayas instalado. La primera vez que la abras, Codex te pedirá que inicies sesión a través del navegador o que conectes tu cuenta. Una vez que hayas iniciado sesión, verás un espacio de trabajo donde puedes iniciar sesiones.

De forma predeterminada, Codex creará una carpeta en "Documentos" llamada "Playground". Todo lo que hagas se hará dentro de esta carpeta a menos que te mue te muevas a otra carpeta.

2.2 Abrir tu primera carpeta (Proyecto)

Codex trata las carpetas como "Proyectos". Excepto por los nombres, no hay diferencia entre ambos.

Para practicar, crea una carpeta llamada "Codex Research Assistant" en tu computadora. Luego haz clic en "Playground" debajo de la barra de chat. En el menú desplegable, selecciona "Agregar nuevo proyecto" y navega hasta la carpeta que acabas de crear.

Ahora Codex está dentro de esa carpeta. Tiene acceso a los archivos y subcarpetas dentro de la carpeta principal, según los permisos que le otorgues.

2.3 Cómo es una sesión

Una sesión es la conversación que tienes con Codex en el panel de chat principal, como lo haces en aplicaciones de navegador como ChatGPT.

La interacción es similar a las aplicaciones basadas en navegador como ChatGPT. La única diferencia es que ahora Codex tiene acceso a tus archivos en tu computadora. También tiene la capacidad de crear archivos en tu computadora.

Una vez que estés en la carpeta, dale a Codex una instrucción simple como:

Lee todos los artículos de la carpeta y dame sus argumentos principales en un archivo separado.

Eso es. La mayor parte de tu interacción con Codex será escribir instrucciones como esta.

Codex procederá a recuperar información relevante de los artículos y comenzará a crear un nuevo archivo. Este archivo. Este archivo aparecerá en la carpeta en la que estás trabajando.

A medida que avance, puede pedirte permiso para hacerlo. Puedes configurar los permisos de Codex, pero al principio, es una buena idea que Codex pida permisos. No quieres que Codex termine eliminando o cambiando archivos importantes sin preguntarte.

Cada sesión que inicies en Codex se guarda en el historial de conversaciones de la aplicación.

Parte 3: Codex como tu asistente de investigación

Cuando Codex comienza a trabajar en una carpeta, busca un archivo llamado AGENTS.md con un conjunto de instrucciones a seguir. Observa las letras mayúsculas, esto es importante.

Hay dos formas de crear un archivo AGENTS.md: automática y manual.

3.1 Manualmente

Si quieres hacerlo manualmente, abre el Bloc de notas en Windows o TextEdit en una Mac y escribe el tipo de instrucciones que quieres que Codex siga. Ten en cuenta que solo necesitas escribir estas instrucciones en lenguaje sencillo. No necesitas usar ningún lenguaje de usar ningún lenguaje de programación.

Puedes dividir el archivo AGENTS.md en las siguientes secciones:

#Rol

El signo de numeral aquí indica que es un encabezado.

Describe el tipo de rol que te gustaría que Codex asumiera como tu asistente de investigación. Dale algunos detalles sobre tu campo de investigación y proyecto actual.

#Estándares

Describe los estándares

Describe los estándares académicos relevantes para tu campo de investigación. Por ejemplo, puedes decirle a Codex que siga un estilo de citación determinado o una estructura específica de un artículo de investigación.

#Estilo de escritura

Dile a Codex el tipo de estilo de escritura que te gustaría que siguiera, si quieres que responda en estilo académico o en un estilo informal.

#Estilo de Crítica

Describe cómo te gustaría que Codex criticara tu trabajo, si te gustaría que se centrara en tu argumento, evidencia o metodología.

Guarda el archivo como AGENTS.md en la carpeta principal de tu proyecto en tu computadora y listo.

No necesitas tener un archivo AGENTS.md perfectamente elaborado. Siempre puedes volver y editarlo a medida que tu proyecto evolucione.

3.2 Automáticamente

Si no quieres crear un archivo AGENTS.md manualmente, simplemente inicia una sesión de chat en Codex y dale detalles sobre su rol, estándar, estilo de escritura y estilo de crítica. Luego pídele que cree un archivo AGENTS.md usando esta información.

Codex creará el archivo y lo guardará en tu carpeta de proyecto.

3.3 Memoria y contexto del proyecto

A medida que trabajas en tu proyecto, Codex puede usar las instrucciones y los archivos de tu carpeta de proyecto como contexto. Algunas configuraciones de Codex también pueden tener funciones de memoria, pero no debes confiar en la memoria oculta como la principal forma en que Codex recuerda tu proyecto.

Cada vez que inicias una sesión, Codex puede leer AGENTS.md y los archivos del proyecto que le pidas que inspeccione y los usa para responder tus preguntas.

Con el tiempo, tus instrucciones y las notas visibles del proyecto le dan a Codex suficiente contexto sobre ti y tu trabajo para que se convierta en un asistente de investigación confiable.

Puedes preguntar a Codex sobre sus instrucciones escribiendo "Dime qué instrucciones estás siguiendo para este proyecto". Si cierta información está desactualizada (por ejemplo, un estilo de citación), simplemente actualiza AGENTS.md con la nueva información.

3. información.

3.4 Qué no poner en AGENTS.md

No pongas información confidencial en AGENTS.md ni nada que no quieras que la IA use.

No dejes que la IA use.

No dejes que AGENTS.md se convierta en un conjunto de información desactualizada, ya que tendrá un impacto considerable en su producción. Es posible que desees actualizar el archivo cada pocas semanas.

Parte 4: Trabajar con tus documentos de investigación

Una carpeta de Codex no tiene que estar muy bien organizada. Esto no significa que empieces a poner archivos irrelevantes en esta carpeta. Lo que significa es que no debes perder tiempo organizándola antes de comenzar. Codex puede ayudarte a hacerlo. Lo único que debes tener en cuenta es no darles a tus archivos nombres confusos como Tesis (final) (final) (final2) (usa este).

Agrega un montón de PDFs, archivos de Word, conjuntos de datos, transcripciones de entrevistas, etc. relacionados con tu proyecto.

Supón que tienes veinte artículos de investigación relacionados con tu tema de investigación y quieres encontrar un tema común que atraviese todos ellos. O tal vez tienes una afirmación o un argumento argumento, y estás buscando artículos que presenten evidencia que respalde o contraste esa afirmación.

Abre la carpeta en Codex y escribe una instrucción como:

Lee cada PDF en esta carpeta y dime qué artículos están en desacuerdo con el siguiente argumento: [pega el argumento aquí]

Codex leerá los PDFs a los que pueda acceder en la carpeta y te dará la información relevante de estos artículos. La respuesta de Codex puede ser en forma de tabla.

4.1 Asistente de investigación para revisión de literatura

Si eres un investigador biomédico o un científico social que realiza revisiones sistemáticas con frecuencia, descarga cincuenta artículos de investigación y colócalos en una carpeta titulada "Revisión Sistemática con Codex".

Abre la carpeta en Codex y dale tus criterios de selección (inclusión/exclusión) y pídele que evalúe todos los artículos en la carpeta.

Codex evaluará los artículos según tus criterios y te dará los resultados en forma de tabla. Aún así debes verificar los resultados tú mismo antes de confiar en ellos.

4.2 Trabajar con transcripciones

Si eres un investigador cualitativo, puedes agregar transcripciones de entrevistas en la carpeta de Codex y pedirle que extraiga información relacionada con un tema determinado.

Por ejemplo, puedes pedirle que extraiga cómo cada entrevistado responde a una pregunta determinada.

4.3 Dale a Codex una tarea tediosa

Coloca unos cincuenta PDFs en una carpeta y ábrela en Codex. Luego pídele que los revise todos y los renombre usando sus títulos.

Verás que Codex ha hecho lo necesario en un par de minutos. Al principio, pídele que te muestre los nuevos nombres propuestos antes de renombrar los archivos.

4.4 Pedirle a Codex que cree archivos

Dado que tu proyecto va a evolucionar, querrás que Codex también cree ciertos archivos para ti para que puedas volver a ellos si es necesario. También ayudará a Codex con una recuperación fácil a medida que se desarrolle el proyecto.

Cada vez que le pidas a Codex que realice una tarea importante, como evaluar artículos o extraer información de transcripciones, pídele que guarde tu respuesta en la carpeta como un archivo.

Generalmente, Codex guardará estos archivos como markdown (md), que ocupan muy poco espacio y son muy fáciles para que Codex recupere información. Pero también puedes pedirle que cree un archivo de Word o una hoja de Excel.

Parte 5: Habilidades de Codex

Una Habilidad es un conjunto de instrucciones que convierte a Codex en un especialista para una tarea. Al igual que el archivo AGENTS.md, una Habilidad también se escribe en inglés sencillo, pero en Codex generalmente reside en una carpeta con un archivo llamado SKILL.md. Y al igual que AGENTS.md, puedes crear un archivo de Habilidad tanto manual como automáticamente.

Una vez que crees una Habilidad, Codex puede usarla cuando la tarea coincida con la descripción de la Habilidad. También puedes invocar una Habilidad tú mismo por nombre, por ejemplo escribiendo algo como "$nombre-de-habilidad" seguido de tu instrucción.

La forma más fácil de crear una Habilidad es pedirle a Codex que lo haga por ti. Digamos que tienes llamadas de Zoom regulares y tienes transcripciones de esas llamadas. Para cada llamada o transcripción, quieres extraer elementos procesables o cosas por hacer.

Para crear una Habilidad, inicia una sesión de Codex y simplemente pídele que cree una Habilidad para extraer elementos procesables de las transcripciones de Zoom.

Codex se pondrá a trabajar. Puede hacerte preguntas de seguimiento y crear un archivo de Habilidad que puedas editar si quieres. Tal vez quieras que Codex siga una estructura específica al responder.

Una vez que se haya creado la Habilidad, reinicia Codex o recarga el proyecto y la Habilidad estará lista para usar.

5.1 Diferencia entre AGENTS.md y las Habilidades

AGENTS.md contiene instrucciones globales o a nivel de proyecto sobre ti y tu proyecto. Le da a Codex la visión general sobre ti y tu investigación.

Las Habilidades, por otro lado, están diseñadas para tareas particulares. Estos archivos contienen información mucho más específica y detallada. AGENTS.md, las Habilidades y las notas visibles del proyecto trabajan en conjunto para brindarte la mejor respuesta posible.

5.2 Qué no delegar a Codex

Codex es excelente para tareas que requieren mucho trabajo, mucho tiempo y repetitivas. Externaliza estas tareas a Codex. Pero Codex no podrá crear lo que realmente constituye conocimiento académico porque no podrá darte argumentos nuevos y originales.

Puede sintetizar información que luego puedas usar al servicio de tu argumento, pero la tarea de crear un argumento original sigue siendo tuya como investigador.