Código por descripción: cómo elaborar una tarea precisa

Por qué la precisión de la tarea es importante

El generador de código no lee tus pensamientos. Analiza el texto y intenta restablecer la tarea supuesta. Si la descripción es vaga, el modelo puede elegir un lenguaje, biblioteca o estructura de programa inadecuados. Cuanto más específico describas los datos de entrada, el resultado deseado y las limitaciones, mayor será la probabilidad de obtener código funcional.

Además, una tarea precisa ahorra tiempo en correcciones. En lugar de reescribir código después de generarlo, defines los límites inmediatamente: por ejemplo, "sin bibliotecas externas", "solo la biblioteca estándar de Python", "salida en formato JSON". Esto reduce la cantidad de iteraciones.

Finalmente, una tarea precisa te ayuda a ti mismo a comprender mejor la tarea. Al formular los requisitos, estructuras tus pensamientos y evitas suposiciones ocultas que luego pueden llevar a errores.

Mala tarea: "Escribe un programa para trabajar con archivos". Buena: "Escribe una función en Python que lee un archivo de texto línea por línea y devuelve una lista de cadenas sin caracteres de nueva línea. Usa solo la biblioteca estándar. Se asume que el archivo existe y está disponible para leer".

Qué indicar en la entrada: contexto, objetivo, formato, restricciones

El contexto ayuda al modelo a comprender dónde se utilizará el código. Especifica el lenguaje de programación, la versión, la plataforma (Windows, Linux, navegador web), así como el entorno de ejecución. Por ejemplo: "Python 3.9, ejecución en la línea de comandos de Linux". Si el código debe ser parte de un proyecto mayor, menciona eso.

El objetivo es la acción concreta que debe realizar el programa. Describe qué se ingresa como entrada y qué se espera como salida. Por ejemplo: "La función recibe una lista de números y devuelve su suma". Evita frases generales como "procesar datos".

El formato de salida es importante si planeas usar el resultado posteriormente. Especifica si necesitas JSON, CSV, texto simple o estructura de datos. También vale la pena decir si se necesitan comentarios, documentación, ejemplos de uso.

Las restricciones son reglas que el código debe seguir. Por ejemplo: "no usar recursión", "abstenerse de bibliotecas externas", "funcionar en O(n) en tiempo". Cuantas más restricciones, más preciso el resultado, pero no te excedas: requisitos excesivos pueden confundir al modelo.

Malo: "Haz una clasificación". Bueno: "Escribe una función en Python que acepta una lista de diccionarios con la clave 'age' y devuelve una nueva lista, ordenada por edad de forma ascendente. Usa la biblioteca estándar. No modifiques la lista original".

Ejemplo de mala y buena tarea

Consideremos la tarea: eliminar duplicados de una lista, conservando el orden. Mala tarea: "Quita repeticiones de una lista". Aquí no está claro: qué lenguaje, qué hacer con el orden, si es necesario devolver una nueva lista o modificar la existente, qué tipos de datos son admisibles.

Buena tarea: "Escribe una función en Python remove_duplicates, que acepta una lista y devuelve una nueva lista sin elementos repetidos, conservando el orden original. Usa solo la biblioteca estándar. Se asume que los elementos son hashables. No modifiques la lista de entrada. Agrega una línea de documentación y un ejemplo de llamada".

La diferencia es evidente: en el segundo caso el modelo recibe toda la información necesaria y genera exactamente lo que se necesita. Podrás verificar el código inmediatamente y usarlo.

Mala tarea: "Quita repeticiones de una lista". Buena tarea: "Escribe una función en Python remove_duplicates, que acepta una lista y devuelve una nueva lista sin elementos repetidos, conservando el orden original. Usa solo la biblioteca estándar. Se asume que los elementos son hashables. No modifiques la lista de entrada. Agrega una línea de documentación y un ejemplo de llamada".

Cómo verificar el código generado

Después de generar, lee el código con atención. Asegúrate de que corresponde a tu tarea: lenguaje, estructura, restricciones. Verifica que no haya errores de sintaxis. Si es posible, ejecuta el código en un entorno seguro (por ejemplo, localmente o en una sandbox).

Presta atención a las suposiciones que pudo haber hecho el generador. Por ejemplo, si no indicaste que el archivo existe, el código puede no manejar excepciones. Verifica casos límite: lista vacía, archivo inexistente, datos incorrectos.

Si el código no funciona o no funciona como se esperaba, perfecciona la tarea y vuelve a generar. No temas a las iteraciones: es un proceso normal. También puedes pedirle al modelo que explique el código o agregue comentarios.

Después de generar la función remove_duplicates, verifica: se conserva el orden, no se modifica la lista original, ¿funciona con una lista vacía? Si algo no está bien, agrega una precisión en la tarea.

Limitaciones de la herramienta

El generador crea pequeños programas, pero no garantiza la absoluta corrección. El modelo puede cometer errores, especialmente en algoritmos complejos. Siempre verifica el código antes de usarlo en producción.

La herramienta no ejecuta código automáticamente. Obtienes solo el texto del programa. El lanzamiento y depuración — tu responsabilidad. También no hay posibilidad de cargar documentos o usar OCR.

No esperes que el generador escriba una aplicación completa con interfaz gráfica o arquitectura compleja. Está orientado a funciones pequeñas y scripts. Para proyectos mayores, es mejor usar entornos de desarrollo especializados.

Si necesitas un programa con GUI, el generador probablemente no sea adecuado. Mejor funciona con utilidades de consola y funciones.

Recomendaciones prácticas

Antes de ingresar la tarea, formulala en papel o en un editor de texto. Divídela en puntos: lenguaje, entrada, salida, restricciones, formato. Esto te ayudará a no olvidar nada.

Usa ejemplos concretos. Si es posible, proporciona ejemplos de datos de entrada y el resultado esperado. Esto aumenta significativamente la precisión.

No especifiques detalles innecesarios si no son importantes. Por ejemplo, no es necesario describir el color de los botones, si se trata de un programa de consola. Concéntrate en la lógica.

Si el resultado no es satisfactorio, intenta reformular la tarea, agregando detalles que falten. A veces ayuda dividir la tarea en varias partes.

En lugar de "Escribe un programa para procesar texto", escribe: "Escribe una función en Python que acepta una cadena y devuelve la cantidad de palabras en ella. Se considera palabra una secuencia de caracteres separada por espacios. Los signos de puntuación no se cuentan".