Cuando tu app envía la respuesta de Claude directamente a un usuario, nadie la revisa primero. Lo que Claude escriba es lo que recibe el usuario. Por eso Claude necesita saber adónde va la respuesta, cómo debe verse y qué debe omitir.
Para hacer que un prompt sea claro y directo, dale a Claude esas tres cosas: contexto, el formato de salida que deseas y restricciones. Cada una responde una pregunta que un colega nuevo te haría antes de comenzar la tarea.
Un prompt que deja a Claude adivinando
Supongamos que la app de reservas de un dentista le envía a cada paciente un recordatorio por mensaje de texto el día antes de su cita. La app le envía a Claude una tarea de una línea y cuatro líneas de datos, y luego le envía al paciente por mensaje de texto lo que sea que reciba de vuelta. Aquí está el prompt para un paciente:
Escribe un recordatorio para esta cita.
Paciente: Dana Okafor
Fecha: jueves, 12 de marzo
Hora: 2:30 PM
Tratamiento: Endodoncia, segunda visita
Claude envió de vuelta esta respuesta. Se muestra como texto sin formato, para que puedas ver cada carácter que la app enviaría:
**Recordatorio de cita**
Hola Dana,
Este es un recordatorio amistoso de tu próxima cita dental:
**Fecha:** jueves, 12 de marzo
**Hora:** 2:30 PM
**Tratamiento:** Endodoncia (segunda visita)
**Antes de tu visita:**
- Por favor, llega unos 10 minutos antes.
- Come algo ligero antes, ya que tu boca podría estar adormecida durante algunas horas después.
- Continúa tomando cualquier medicamento según lo recetado, a menos que tu dentista te haya indicado lo contrario.
- Avísanos si has tenido dolor, hinchazón o problemas con tu empaste temporal desde tu última visita.
Si necesitas reprogramar o tienes alguna pregunta, llámanos al [número de teléfono] con al menos 24 horas de anticipación.
¡Esperamos verte!
[nombre del consultorio]
La app le enviaría todo eso a Dana por mensaje de texto, y gran parte de ello no debería estar en su teléfono:
- Los asteriscos y los guiones son sintaxis de Markdown para texto en negrita y una lista. Un teléfono los muestra como caracteres simples.
- Los consejos sobre comer y llegar temprano son consejos sobre la visita, y los consejos deberían venir del dentista.
- "Endodoncia (segunda visita)" puede aparecer en la pantalla bloqueada del teléfono de Dana, donde otras personas pueden verlo.
- "[número de teléfono]" y "[nombre del consultorio]" son espacios en blanco, y nadie los completa antes de que se envíe el mensaje.
Cada uno de estos errores se remonta a algo que el prompt omitió. Nunca dice que el recordatorio es un mensaje de texto, que nadie lo revisa antes, o que otras personas pueden verlo en una pantalla bloqueada. No dice qué debe cubrir el recordatorio, y no da el nombre del consultorio ni el número de teléfono. Así que Claude escribió un recordatorio general y dejó espacios en blanco donde no tenía datos.
Lo que recibes depende sobre todo de lo que ingresas. Antes de reformular la redacción de un prompt, dale a Claude los datos que le faltan.
Pregunta lo que preguntaría un colega
Para encontrar lo que falta, imagina que le entregas el prompt a un colega que nunca ha visto la app. Esa persona tiene que escribir el recordatorio solo a partir del prompt. Si se confundiría, Claude también lo hará.
Antes de escribir una sola palabra, el colega tendría preguntas para ti. Cada pregunta apunta a una de tres partes que puedes agregar al prompt:
| Parte | Qué le indica a Claude | Qué pregunta el colega |
|---|---|---|
| Contexto | Para qué sirve la respuesta, adónde va y quién la lee | "¿Esto es un mensaje de texto o un correo electrónico? ¿De quién es? ¿Alguien lo revisa antes de que se envíe?" |
| Formato de salida | Cómo se ve la respuesta, como su longitud y si puede usar Markdown | "¿Qué tan larga debería ser? ¿Puede tener texto en negrita o una lista?" |
| Restricciones | A qué debe limitarse o qué debe omitir la respuesta | "¿Debería nombrar el tratamiento? ¿Debería dar consejos?" |
Responde cada una de las preguntas del colega en el prompt, en la parte donde corresponda.
Agrega contexto, formato y restricciones
Plantea el contexto como hechos, y escribe el formato de salida y las restricciones como instrucciones. Agrega el motivo a cualquier instrucción cuyo propósito Claude no pueda adivinar.
El prompt terminado de la app de reservas a continuación responde las preguntas del colega en tres párrafos, uno para el contexto, otro para el formato de salida y otro para las restricciones.
Prueba el prompt con y sin cada parte. Cada respuesta es real, registrada de Claude para ese prompt exacto.
Pruébalo con un nuevo prompt
Ahora haz tú mismo que un prompt sea claro y directo. Supongamos que una app del clima envía la respuesta de Claude tal como está escrita, en una notificación push que la gente lee en la pantalla de bloqueo a las 7 AM. El prompt de la app le da a Claude solo una tarea de una línea y algunos datos:
Escribe una notificación para este pronóstico.
Ciudad: Portland
Mañana: nublado, 48°F
Tarde: lluvia intensa a partir de las 3 PM
Viento: ráfagas de hasta 35 mph
Piensa en lo que te preguntaría un colega que nunca ha visto esta app. Luego elige el contexto, el formato de salida y las restricciones que respondan esas preguntas. Después de cada elección, lee por qué es correcta o incorrecta.
El prompt de la app del clima dice solo "Escribe una notificación para este pronóstico." ¿Qué línea agregarías para darle contexto a Claude?
La notificación tiene que caber en la pantalla de bloqueo. ¿Qué línea agregarías como formato de salida?
El mismo prompt se ejecuta cada mañana, con un pronóstico nuevo cada día. ¿Qué línea agregarías como restricción?
Qué hacer después
Cada vez que una respuesta necesite corregirse antes de que tu app pueda usarla, busca la pregunta que tu prompt dejó sin responder. Para corregir el prompt en tu propio código, trabaja paso a paso:
- Imagina a un colega que nunca ha visto tu app, y piensa en lo que preguntaría antes de hacer la tarea.
- En el prompt, responde cada pregunta como contexto, formato de salida o restricciones. Plantea el contexto como hechos, y agrega el motivo a cualquier instrucción cuyo propósito Claude no pueda adivinar.
- Envía el nuevo prompt con varias entradas de tu app.
- Lee cada respuesta como texto sin formato, para que puedas ver cada carácter que tu app enviaría. Busca los errores que te propusiste corregir, como Markdown que tu app no puede mostrar, un espacio en blanco que nadie completa, o un detalle que tus usuarios no deberían ver.
Si un error sigue ahí, encuentra la pregunta que el prompt todavía deja abierta, y respóndela también.
Leer algunas respuestas no puede decirte qué tan bien funciona el prompt en todas las entradas de tu app. Para eso necesitas un eval, una prueba sobre tus propios casos que te da un número a partir del cual decidir. Desde aquí, toma el curso Introducción a los evals.