¿Cómo pedirle a la IA que genere código útil?
La inteligencia artificial se ha convertido en una herramienta de apoyo para los desarrolladores web. Con ella podemos generar estructuras HTML, aplicar estilos CSS, crear funciones JavaScript, localizar errores en el código o buscar alternativas para resolver un problema de programación.
Sin embargo, no siempre obtenemos el resultado que esperamos. En muchas ocasiones, el problema no está en la herramienta que estamos utilizando, sino en cómo le hemos explicado lo que necesitamos.
Por ejemplo, no es lo mismo pedirle a ChatGPT que cree un formulario HTML que indicarle qué campos debe contener, cómo queremos que se validen, si tiene que ser responsive o qué requisitos de accesibilidad debe cumplir.
Aquí es donde entra en juego el prompting, que consiste en diseñar las instrucciones que proporcionamos a un modelo de inteligencia artificial para obtener una respuesta adecuada a nuestras necesidades.
En este artículo os voy a mostrar algunas de las técnicas de prompting que podemos utilizar en desarrollo web, con ejemplos prácticos aplicados a HTML, CSS y JavaScript.
¿Qué es un prompt y para qué sirve en desarrollo web?
Un prompt es la instrucción, pregunta o conjunto de indicaciones que proporcionamos a una inteligencia artificial para que realice una tarea.
Puede ser una petición sencilla, como generar un botón HTML, o una instrucción más detallada que incluya el contexto del proyecto, las tecnologías utilizadas, las funcionalidades necesarias y el formato en el que queremos recibir el resultado.
Por ejemplo, podemos escribir:
Prompt básico:
Crea un formulario de contacto en HTML.
La inteligencia artificial probablemente generará un formulario con varios campos. Pero ¿tendrá validación? ¿Será accesible? ¿Incluirá estilos CSS? ¿Se adaptará correctamente a dispositivos móviles?
No lo sabemos, porque no se lo hemos indicado.
En cambio, podemos utilizar una instrucción más completa:
Prompt mejorado:
Crea un formulario de contacto utilizando HTML5, CSS3 y JavaScript sin bibliotecas externas. El formulario debe incluir: - Nombre completo. - Correo electrónico. - Asunto. - Mensaje. - Casilla para aceptar la política de privacidad. - Botón para enviar. Requisitos: - Diseño responsive. - Etiquetas label asociadas a cada campo. - Validación de los campos obligatorios. - Comprobación del formato del correo electrónico. - Mensajes de error comprensibles. - No enviar información a ningún servidor. Entrega el código HTML, CSS y JavaScript por separado. Explica brevemente cómo funciona la validación.
En este segundo caso, hemos definido las características que queremos que tenga el formulario y también hemos establecido algunas limitaciones.
Cuanto más clara sea la información que proporcionamos, menos decisiones tendrá que tomar la IA por su cuenta.
Esto no significa que debamos escribir siempre prompts muy largos. La cantidad de información dependerá de la dificultad de la tarea.
1. Técnica Zero-shot: pedir una tarea sin proporcionar ejemplos
La técnica Zero-shot consiste en solicitar a la inteligencia artificial que realice una tarea sin mostrarle previamente ningún ejemplo del resultado esperado.
Es una de las formas más sencillas de utilizar herramientas como ChatGPT.
En desarrollo web podemos utilizarla para generar componentes básicos, explicar fragmentos de código, crear funciones sencillas o resolver dudas sobre HTML, CSS y JavaScript.
Ejemplo práctico: crear una tarjeta HTML con CSS
Imaginemos que estamos desarrollando una página web y necesitamos una tarjeta para mostrar información sobre un curso.
Podemos utilizar el siguiente prompt:
Crea una tarjeta de presentación para un curso de desarrollo web utilizando HTML5 y CSS3. La tarjeta debe incluir: - Título del curso. - Breve descripción. - Duración. - Nivel. - Botón con el texto "Ver curso". Utiliza HTML semántico. Aplica un diseño sencillo y responsive. No utilices Bootstrap ni otras bibliotecas CSS. Entrega el HTML y el CSS por separado.
La IA generará una propuesta de código basándose únicamente en nuestras instrucciones.
¿Cuándo conviene utilizar Zero-shot?
- Cuando necesitamos crear un componente sencillo.
- Cuando queremos obtener una primera propuesta de código.
- Cuando no tenemos un ejemplo previo que deba seguir.
- Cuando necesitamos una explicación o solución rápida.
La principal ventaja de esta técnica es su sencillez. Sin embargo, si necesitamos que el código respete una estructura concreta o siga el estilo de nuestro proyecto, puede ser más conveniente utilizar otra técnica.
2. Técnica Few-shot: enseñar a la IA mediante ejemplos
A diferencia de Zero-shot, la técnica Few-shot consiste en proporcionar varios ejemplos para que la inteligencia artificial identifique el patrón que queremos utilizar.
Es especialmente útil cuando estamos desarrollando una web y necesitamos mantener la misma estructura en diferentes componentes.
Por ejemplo, imaginemos que tenemos varias tarjetas HTML con una estructura determinada y queremos generar otras nuevas sin modificar las clases CSS existentes.
Ejemplo práctico: generar tarjetas siguiendo una estructura HTML
En este caso, podemos proporcionar dos ejemplos y pedirle que genere una tercera tarjeta.
Estoy desarrollando una página web con varias tarjetas
de cursos.
Quiero que generes una nueva tarjeta siguiendo
exactamente la estructura HTML de los ejemplos.
Ejemplo 1:
<article class="curso-card">
<h3 class="curso-card__titulo">HTML5</h3>
<p class="curso-card__descripcion">
Aprende a estructurar páginas web.
</p>
<span class="curso-card__nivel">Básico</span>
</article>
Ejemplo 2:
<article class="curso-card">
<h3 class="curso-card__titulo">CSS3</h3>
<p class="curso-card__descripcion">
Aprende a diseñar interfaces web.
</p>
<span class="curso-card__nivel">Intermedio</span>
</article>
Ahora genera una tercera tarjeta para un curso
de JavaScript de nivel intermedio.
Condiciones:
- Mantén las mismas etiquetas HTML.
- No modifiques los nombres de las clases.
- Respeta el orden de los elementos.
- No añadas estilos CSS.
- Devuelve únicamente el código HTML.
Al proporcionar los ejemplos, estamos mostrando a la IA cómo debe organizar la información.
Esto resulta especialmente útil cuando trabajamos con componentes reutilizables, ya que podemos conseguir que las nuevas estructuras mantengan cierta coherencia con las existentes.
¿Cuándo conviene utilizar Few-shot?
- Cuando necesitamos generar varios componentes similares.
- Cuando queremos mantener una nomenclatura CSS.
- Cuando seguimos una estructura HTML definida.
- Cuando necesitamos que varias funciones JavaScript utilicen el mismo formato.
- Cuando queremos transformar información siguiendo un patrón.
Hay que tener en cuenta que los ejemplos también pueden contener errores. Si proporcionamos una estructura incorrecta, la IA podría reproducir esos mismos problemas en los nuevos componentes.
3. Técnica CETO: contexto, encargo, tono y output
La técnica CETO permite organizar las instrucciones de un prompt en cuatro apartados:
- Contexto: información sobre el proyecto o la situación.
- Encargo: tarea que queremos que realice la IA.
- Tono: estilo que debe utilizar en sus explicaciones o textos.
- Output: formato en el que queremos recibir el resultado.
En desarrollo web es una técnica muy útil cuando necesitamos algo más que un fragmento de código.
Por ejemplo, podemos utilizarla para crear una página completa, generar documentación técnica o preparar componentes acompañados de explicaciones.
Ejemplo práctico: crear una página de preguntas frecuentes
Imaginemos que estamos desarrollando una web para una academia de programación y queremos incorporar un apartado de preguntas frecuentes.
Prompt utilizando CETO:
CONTEXTO: Estoy desarrollando una página web para una academia que ofrece cursos de programación online. La web utiliza HTML5, CSS3 y JavaScript. No estamos utilizando frameworks. ENCARGO: Crea una sección de preguntas frecuentes (FAQ) con cinco preguntas relacionadas con los cursos. Cada pregunta debe poder desplegar y ocultar su respuesta. TONO: Utiliza un lenguaje claro, cercano y profesional en los textos de las preguntas y respuestas. Evita tecnicismos innecesarios. OUTPUT: Entrega: 1. Código HTML semántico. 2. Código CSS responsive. 3. Código JavaScript, solo si es necesario. 4. Breve explicación del funcionamiento. REQUISITOS: - Debe poder utilizarse con teclado. - Debe mostrar claramente qué pregunta está abierta. - No debe utilizar bibliotecas externas.
En este ejemplo, el contexto permite que la IA conozca el tipo de web y las tecnologías disponibles.
El encargo define la funcionalidad que necesitamos, mientras que el tono se aplica principalmente al contenido textual.
Por último, el apartado de output indica cómo queremos recibir el resultado.
La principal ventaja de CETO es que nos obliga a organizar la información antes de realizar la petición.
Además, facilita la reutilización del prompt. Si necesitamos una sección similar para otra web, podemos modificar el contexto y el encargo sin tener que escribir todas las instrucciones desde cero.
4. Técnica RTF: rol, tarea y formato
La técnica RTF organiza el prompt en tres elementos:
- Rol (Role): qué función queremos que desempeñe la IA.
- Tarea (Task): qué debe hacer.
- Formato (Format): cómo debe presentar el resultado.
Se utiliza cuando queremos orientar la respuesta hacia una especialidad concreta.
Por ejemplo, podemos pedirle que actúe como desarrollador frontend, especialista en accesibilidad web o revisor de código JavaScript.
Esto no significa que la IA se convierta realmente en un especialista, pero ayuda a establecer el enfoque que queremos dar a la respuesta.
Ejemplo práctico: revisar un formulario HTML
Imaginemos que hemos creado un formulario y queremos comprobar si presenta problemas de accesibilidad.
Prompt utilizando RTF:
ROL: Actúa como revisor de código frontend especializado en HTML semántico y accesibilidad web. TAREA: Analiza el siguiente formulario HTML e identifica posibles problemas de accesibilidad. <form> <input type="text" placeholder="Nombre"> <input type="email" placeholder="Email"> <button>Enviar</button> </form> Comprueba: - Si los campos tienen etiquetas accesibles. - Si los tipos de entrada son adecuados. - Si existe una identificación clara de los campos. - Si pueden mejorarse los atributos HTML. FORMATO: Presenta el resultado en tres apartados: 1. Problemas detectados. 2. Explicación de cada problema. 3. Código HTML corregido. No añadas CSS ni JavaScript.
En este ejemplo, la IA debería detectar que los campos no tienen etiquetas <label> asociadas.
Aunque los atributos placeholder muestran texto dentro de los campos, no deben utilizarse como sustitutos de etiquetas visibles y correctamente asociadas.
Una posible corrección sería:
<form>
<label for="nombre">Nombre</label>
<input
type="text"
id="nombre"
name="nombre"
autocomplete="name"
required
>
<label for="email">Correo electrónico</label>
<input
type="email"
id="email"
name="email"
autocomplete="email"
required
>
<button type="submit">Enviar</button>
</form>
Este ejemplo permite comprobar cómo una instrucción organizada puede ayudarnos a revisar un fragmento de código.
No obstante, la revisión realizada por una IA no sustituye las pruebas de accesibilidad, que también deben incluir comprobaciones manuales y, cuando corresponda, pruebas con tecnologías de apoyo.
5. Técnica CO-STAR: instrucciones más completas para tareas complejas
La técnica CO-STAR es otra forma de estructurar los prompts. En este caso, utiliza seis elementos:
- Context (Contexto): información sobre la situación.
- Objective (Objetivo): resultado que queremos conseguir.
- Style (Estilo): forma de desarrollar o presentar la respuesta.
- Tone (Tono): manera de comunicar las explicaciones.
- Audience (Audiencia): personas a las que va dirigido el resultado.
- Response (Respuesta): formato de salida.
Puede parecer similar a CETO, pero CO-STAR permite definir con mayor detalle el público destinatario y el estilo esperado.
Esto resulta interesante cuando desarrollamos una web para usuarios con características o necesidades concretas.
Ejemplo práctico: crear una página de inicio para una academia
Vamos a imaginar que necesitamos diseñar la página de inicio de una academia que ofrece cursos de programación a personas que están empezando.
Prompt utilizando CO-STAR:
CONTEXTO: Estoy desarrollando la página de inicio de una academia online especializada en programación web. OBJETIVO: Crear una propuesta de página de inicio utilizando HTML5 y CSS3. Debe incluir: - Cabecera con navegación. - Sección principal de presentación. - Tres tarjetas de cursos. - Apartado de ventajas de la formación. - Llamada a la acción. - Pie de página. ESTILO: Diseño limpio, organizado y responsive. Utiliza HTML semántico y CSS sin frameworks. TONO: Los textos deben ser cercanos, claros y didácticos. Evita expresiones comerciales exageradas. AUDIENCIA: Personas adultas que quieren aprender desarrollo web desde cero y no tienen conocimientos previos. RESPUESTA: 1. Código HTML completo. 2. Código CSS separado. 3. Explicación de la estructura utilizada. 4. Recomendaciones para mejorar la accesibilidad. No utilices imágenes externas ni bibliotecas JavaScript.
En este caso, hemos indicado que el público no tiene conocimientos previos de programación.
Esta información puede influir en los textos que genere la IA, en la organización de los contenidos y en las explicaciones que incluya.
¿Cuándo utilizar CO-STAR?
Principalmente cuando la tarea requiere tener en cuenta varios factores al mismo tiempo, como el diseño, el contenido, el público y el formato de entrega.
Para generar una función JavaScript sencilla, probablemente no necesitemos utilizar una estructura tan completa.
6. Entrevista guiada: dejar que la IA nos haga preguntas antes de programar
Hasta ahora hemos visto técnicas en las que proporcionamos directamente las instrucciones.
Sin embargo, en ocasiones no tenemos todos los requisitos definidos.
Por ejemplo, un cliente puede pedirnos una página web con un formulario de reservas, pero no indicar qué información necesita recoger, cómo deben mostrarse las reservas o si tiene que existir una conexión con una base de datos.
Si solicitamos directamente el código, la IA podría asumir requisitos que no hemos confirmado.
La técnica de entrevista guiada consiste en pedirle que nos haga preguntas antes de comenzar a desarrollar la solución.
Ejemplo práctico: definir un formulario de reservas
Prompt utilizando entrevista guiada:
Quiero desarrollar un formulario de reservas para una página web utilizando HTML, CSS y JavaScript. Antes de generar cualquier código, necesito que me hagas una entrevista para definir los requisitos del formulario. Hazme las preguntas de una en una. Debes averiguar: - Qué tipo de reservas se van a realizar. - Qué datos necesitamos solicitar. - Si existen fechas u horarios disponibles. - Qué validaciones son necesarias. - Si las reservas deben guardarse. - Si necesitamos conexión con un servidor. - Qué ocurre después de enviar el formulario. - Qué requisitos de accesibilidad debemos cumplir. No generes código hasta que hayamos terminado de definir los requisitos. Cuando finalice la entrevista: 1. Resume las funcionalidades acordadas. 2. Señala los requisitos que siguen sin definir. 3. Propón una estructura técnica. 4. Espera mi confirmación antes de programar.
La IA comenzará a realizar preguntas para concretar las características del formulario.
Por ejemplo, podría preguntarnos si se trata de reservas para un restaurante, una consulta profesional o una actividad formativa.
Después, podría solicitar información sobre las fechas disponibles, los campos obligatorios y el almacenamiento de los datos.
¿Qué conseguimos con esta técnica?
Principalmente, evitar empezar a programar sin haber definido correctamente el funcionamiento de la aplicación.
Además, nos permite detectar requisitos que inicialmente no habíamos tenido en cuenta.
Es especialmente útil para proyectos nuevos, formularios complejos, aplicaciones con varias funcionalidades o tareas en las que intervienen diferentes usuarios.
7. Descomposición: dividir una tarea compleja en otras más pequeñas
La técnica de descomposición consiste en dividir un problema grande en varias tareas más sencillas.
En desarrollo web puede resultar especialmente útil cuando queremos crear una página completa o una funcionalidad que necesita HTML, CSS y JavaScript.
Por ejemplo, si pedimos a la IA que desarrolle una tienda online completa en una única respuesta, probablemente obtengamos una solución demasiado general, incompleta o difícil de revisar.
En cambio, podemos dividir el trabajo en diferentes fases.
Ejemplo práctico: crear un catálogo de productos con filtros
Imaginemos que necesitamos desarrollar un catálogo de productos que permita buscar por nombre y filtrar por categoría.
En lugar de solicitar todo el código de una vez, podemos utilizar el siguiente prompt:
Quiero desarrollar un catálogo de productos utilizando HTML5, CSS3 y JavaScript. El catálogo debe permitir: - Mostrar productos en tarjetas. - Buscar productos por nombre. - Filtrar productos por categoría. - Mostrar un mensaje cuando no haya resultados. - Adaptarse a dispositivos móviles. Vamos a dividir el desarrollo en cinco fases: FASE 1: Definir la estructura HTML semántica. FASE 2: Crear los estilos CSS responsive. FASE 3: Definir los datos de ejemplo y renderizar los productos con JavaScript. FASE 4: Implementar la búsqueda y los filtros. FASE 5: Revisar el funcionamiento, la accesibilidad y los posibles errores. Trabaja únicamente en la fase 1. No avances a la siguiente fase hasta que te lo indique. En cada fase: - Explica qué vamos a desarrollar. - Entrega el código correspondiente. - Indica cómo comprobar su funcionamiento. - Señala las dependencias con las fases anteriores.
De esta manera, podemos revisar cada parte antes de continuar.
En la primera fase comprobaríamos que la estructura HTML es correcta. Después trabajaríamos en los estilos CSS y, posteriormente, incorporaríamos la funcionalidad JavaScript.
La ventaja de la descomposición es que facilita localizar errores y controlar los cambios que vamos realizando.
También permite mantener una estructura de trabajo más ordenada, especialmente cuando utilizamos la IA como apoyo durante el desarrollo de un proyecto.
Eso sí, debemos comprobar que las diferentes fases sean compatibles entre sí. Dividir una tarea no garantiza que el resultado final funcione correctamente.
¿Qué técnica de prompting conviene utilizar?
No existe una única técnica que sea la mejor para todas las situaciones.
La elección dependerá de lo que necesitemos desarrollar, de la información disponible y del nivel de detalle que queramos obtener.
| Técnica | Aplicación en desarrollo web |
|---|---|
| Zero-shot | Generar componentes sencillos sin proporcionar ejemplos. |
| Few-shot | Crear componentes siguiendo estructuras o patrones existentes. |
| CETO | Organizar los requisitos de una tarea de desarrollo. |
| RTF | Solicitar una tarea desde un enfoque técnico determinado. |
| CO-STAR | Definir tareas que incluyen diseño, contenido y público destinatario. |
| Entrevista guiada | Recopilar requisitos antes de comenzar a programar. |
| Descomposición | Dividir desarrollos complejos en fases más fáciles de revisar. |
Además, estas técnicas no son excluyentes.
Por ejemplo, podemos utilizar CETO para definir el contexto de un proyecto, incorporar ejemplos mediante Few-shot y solicitar que el desarrollo se realice por fases utilizando descomposición.
Lo importante no es utilizar el mayor número de técnicas posible, sino seleccionar las que realmente nos ayuden a resolver el problema.
Recomendaciones antes de utilizar código generado con IA
Aunque las herramientas de inteligencia artificial pueden ayudarnos a ahorrar tiempo, hay que tener en cuenta que el código generado no siempre es correcto ni está preparado para utilizarse directamente en producción.
Antes de incorporarlo a un proyecto web, conviene realizar algunas comprobaciones:
- Revisar el HTML: comprobar que las etiquetas están correctamente utilizadas y que la estructura es semántica.
- Comprobar el CSS: verificar que el diseño funciona en diferentes tamaños de pantalla y que no provoca conflictos con estilos existentes.
- Probar el JavaScript: comprobar que las funciones realizan las acciones esperadas y que gestionan correctamente los errores.
- Revisar la accesibilidad: verificar la navegación mediante teclado, las etiquetas de los formularios y otros requisitos aplicables.
- Comprobar la seguridad: evitar incorporar código que exponga información sensible o introduzca vulnerabilidades.
- Revisar las dependencias: confirmar que las bibliotecas, funciones y APIs propuestas existen y son adecuadas para el proyecto.
También es importante no introducir contraseñas, claves privadas ni datos personales innecesarios en los prompts.
Estas comprobaciones son necesarias incluso cuando hemos utilizado una técnica de prompting bien estructurada.
Conclusión
Las técnicas de prompting nos permiten comunicarnos de forma más precisa con las herramientas de inteligencia artificial.
En desarrollo web podemos utilizarlas para generar componentes HTML, crear estilos CSS, desarrollar funciones JavaScript, revisar código o definir los requisitos de un proyecto.
Como hemos visto, algunas técnicas son sencillas, como Zero-shot, mientras que otras permiten organizar instrucciones más completas, como CETO o CO-STAR.
También podemos proporcionar ejemplos mediante Few-shot, solicitar una entrevista para definir los requisitos o dividir el desarrollo en fases utilizando descomposición.
En cualquier caso, utilizar una buena técnica de prompting no significa que podamos dejar de revisar el código. La IA puede ayudarnos durante el desarrollo, pero debemos comprender, comprobar y probar las soluciones antes de incorporarlas a nuestra web.
En la segunda parte veremos otras técnicas que podemos utilizar para revisar, mejorar y depurar código generado con inteligencia artificial, como la autorrevisión, la revisión adversarial, el pre-mortem y el análisis de escenarios.
¿Has utilizado alguna de estas técnicas PARA GUIARTE a desarrollar una página web o normalmente escribes las instrucciones directamente, sin seguir una estructura?
Enlaces consultados
1. OpenAI — Prompt engineering. Explica cómo estructurar instrucciones, proporcionar contexto, utilizar ejemplos Few-shot y orientar las respuestas.
2. Microsoft Learn — Prompt engineering techniques. Incluye explicaciones sobre Zero-shot, Few-shot y la importancia de definir correctamente las instrucciones.
3. GovTech Singapore — CO-STAR Framework. Especialmente interesante porque explica los seis elementos del modelo CO-STAR.
4. OpenAI Cookbook — Estrategias de prompting. Contiene recomendaciones para escribir instrucciones claras, utilizar ejemplos y dividir tareas en pasos.