Este es un tutorial de cinco partes para ayudar a investigadores académicos a comenzar con Codex.
Lo he escrito en escrito en un lenguaje accesible, y no necesitas tener conocimientos técnicos 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 habilidades de codificación o programación para usarlo. Instalas la aplicación 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 tu carpeta de 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 una carpeta en tu computadora 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 hacer 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 aplicación de IA en el navegador, tú llevas 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 requisitos de investigación en evolución. No tendrás que explicar tus requisitos repetidamente si los colocas en un archivo de instrucciones visible.
Segundo, dado que Codex trabaja dentro de una carpeta en tu computadora, puede procesar múltiples 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, agre un CSV desordenado o una hoja de Excel desordenada en tu carpeta y pídele a Codex que la limpie. 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 es un reemplazo para 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 subcontratan todo su pensamiento y juicio.
Parte 2: Instalación de la aplicación Codex, tu primera sesión
Si eres nuevo en Codex, dedica 15-20 minutos para instalarlo y configurarlo. No necesitas habilidades de codificación para usar Codex.
Necesitarás de un plan ChatGPT Plus o Pro para usar Codex en tu computadora.
2.1 Instalación
La aplicación 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 tus "Documentos" llamada " llamada "Playground". Todo lo que hagas se realizará dentro de esta carpeta a menos que 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 ellos.
Para practicar, crea una carpeta llamada "Asistente de Investigación Codex" 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 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 se ve 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 en la carpeta y dame sus argumentos principales como un archivo separado.
Eso es todo. La mayor parte de tu interacción con Codex será escribir instrucciones como esta.
<payload-blockquote>
Codex procederá a recuperar información relevante de los artículos y comenzará a crear un nuevo 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 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 codificación o 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 asuma como tu asistente de investigación. Dale algunos detalles sobre tu campo de investigación y proyecto actual.
#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 específico o una estructura particular 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 critique tu trabajo, si te gustaría centrarte en tu argumento, evidencia o metodología.
Guarda el archivo como AGENTS.md en tu carpeta de proyecto principal 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ándares, 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 archivos en 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 forma principal en que Codex recuerda tu proyecto.
Cada vez que inicies 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 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 preguntarle 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.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 permitas que AGENTS.md se convierta en un conjunto de información desactualizada, ya que tendrá un impacto considerable en su resultado. Es posible que desees actualizar el archivo cada pocas semanas.
Parte 4: Trabajar con tus documentos de investigación
Una carpeta de investigación
Una carpeta de Codex no tiene que estar muy bien organizada. Esto no significa que comiences 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) (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 cierta afirmación o argumento, y estás buscando artículos que presenten evidencia que respalde respaldo o contraste.
Abre la carpeta en Codex y escribe un mensaje 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 revise todos los artículos en la carpeta.
Codex revisará los artículos según tus criterios y te dará los resultados en forma de tabla. Aún así debes verificar los resultados 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 dado.
Por ejemplo, puedes pedirle pidas que extraiga cómo cada encuestado 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 Pedir a Codex que cree archivos
Dado que tu proyecto va a evolucionar, querrás que Codex cree ciertos archivos para ti también para que puedas volver a ellos si es necesario. También ayudará a Codex con una recuperación fácil a medida que se desarrolla el proyecto.
Cada vez que le pidas a Codex una tarea importante, como revisar artículos o extraer información de transcripciones, píde que guarde tu respuesta en la carpeta como 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 vive 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 creas una Habilidad, Codex puede usarla cuando la tarea coincide con la descripción de la Habilidad. También puedes invocar una Habilidad tú mismo por nombre, por ejemplo escribiendo algo como "$nombre-de-la-habilidad" tu mensaje.
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 crea la Habilidad, reinicia Codex o recarga el proyecto y la Habilidad estará lista para usar.
5.1 Diferencia entre AGENTS.md y 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 destinadas a 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 darte la mejor respuesta posible.
5.2 Qué no delegar a Codex
Codex es excelente en tareas que requieren mucho trabajo, tiempo y son repetitivas. Externaliza estas tareas a Codex. Pero Codex no podrá crear lo que realmente cuenta como 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 el trabajo de crear un argumento original sigue siendo tuyo como investigador.
