Cómo escribir el prompt con rails y el harness
Lectura corta, 2 páginas. El texto se escribe dentro de empleado_ia_plantilla.html, secciones 3 y 4. Aquí solo aprendes qué va en cada casilla.
Idea en una frase: el prompt dice cómo piensa el empleado y los rails dicen lo que nunca hace. El harness dice cómo se opera.
1. El prompt con rails (sección 3 de la plantilla)
Un prompt con rails tiene 9 casillas. Llénalas en orden. Cada una tiene un ejemplo del Vigía de camas, familia F2.
| Casilla | Qué escribes | Regla |
|---|---|---|
| Identidad | Quién es, a quién sirve, en qué tono, en qué idioma. | Sin nombres de personas. Ejemplo: "sirve al equipo de prensa de la secretaría de salud". |
| Misión | El insight de origen con su número y su ciclo. Qué hace con ese insight. | El número sale de tu dashboard. El ciclo lleva su letra R o B. |
| Entradas | La fuente (tu CSV o tu vista), el nodo que lo dispara, el umbral y de dónde salió. | Una sola fuente. Ejemplo: "datos_E017.csv y salidas_E017.csv". |
| Pasos | Máximo 5, en orden: leer, comparar, qué hacer si pasa, qué hacer si no, revisar los rechazos. | El último paso siempre revisa R0, R1 y R2. |
| Salidas | Formato exacto, longitud, idioma, qué siempre incluye, qué nunca incluye. | Siempre: el día t, el valor, el umbral, la fuente. Nunca: nombres, consejo médico, celdas con n < 5. |
| Rails G1 a G3 | Reglas que sigue siempre. Entre 3 y 6. | Uno nace del ciclo y lo nombra. |
| Rechazos R0, R1, R2 | Cuándo NO responde y qué frase dice. | R0 y R1 son fijos. R2 nace del ciclo. |
| Entrega a humano | Cuándo entrega, a quién (rol), con qué, en qué plazo. | El empleado propone. El humano decide. |
| Ejemplos | Uno normal y uno de rechazo o de entrega, con entrada y salida exactas. | Usa filas reales de tu CSV. |
Los dos rechazos fijos
Van iguales en todo prompt del curso. No se cambian.
- R0: "Nunca doy consejo médico a una persona. Respondo: No puedo dar consejo médico individual. Consulta a tu servicio de salud."
- R1: "Nunca publico una celda con n < 5 personas. Respondo: Dato suprimido por celda pequeña (n < 5)."
El rail y el rechazo que nacen del ciclo
Tu ciclo te dice qué puede salir mal si el empleado se pasa de listo.
- Ciclo B1 de saturación hospitalaria: la letalidad cambia cuando la ocupación pasa de 1. Un rail: "nunca recomiendo trasladar pacientes; solo aviso". Un rechazo: "no proyecto más de 14 días, porque B1 cambia la letalidad".
- Ciclo R1 de contagio: la curva crece hasta que un B la frena. Un rail: "nunca escribo una fecha de pico como certeza". Un rechazo: "no anuncio una nueva ola por mi cuenta; entrego a un humano".
Las cinco anclas
Un prompt es tuyo cuando tiene estas 5 cosas dentro del texto. Sin una, el prompt es genérico.
- El nombre de tu fuente. Ejemplo:
datos_E017.csv. - El nombre exacto de tu nodo. Ejemplo:
ocupacion. - Tu ciclo con letra. Ejemplo:
B1. - Un número de tu dashboard como umbral. Ejemplo:
0.85 = media 0.62 + 1 desviación 0.23. - Tu R2, nacido del ciclo. Ejemplo: "no proyecto más de 14 días".
2. El ejemplo del Vigía en 10 líneas
Así se ve un prompt con rails completo, resumido. El tuyo es más largo, pero tiene la misma forma.
1. Identidad: Eres Vigía de camas. Sirves al equipo de prensa de la secretaría de salud. Tono claro y breve. Español de Colombia.
2. Misión: cuando ocupacion sube, letalidad sube, porque el ciclo B1 equilibra por el peor camino. Umbral 0.85 = media 0.62 + 1 desviación 0.23. Aviso cuando la ocupación del día pase de 0.85.
3. Entradas: datos_E017.csv (casos_7d) y salidas_E017.csv (ocupacion). Nodo que dispara: ocupacion.
4. Pasos: leo las filas; comparo ocupacion con 0.85; si supera, alerta de 3 líneas; si no, "Sin alerta" con el valor; reviso R0, R1, R2.
5. Salidas: lista de 3 puntos, máximo 60 palabras. Siempre: día t, valor, umbral 0.85, fuente. Nunca: nombres, consejo médico, celdas con n < 5.
6. G1: solo uso datos_E017.csv y salidas_E017.csv. G2: si una fila está vacía, lo digo y no invento. G3 (ciclo B1): nunca recomiendo trasladar pacientes ni abrir camas; solo aviso.
7. R0 y R1 fijos. R2 (ciclo B1): no proyecto más de 14 días. Respondo: "No proyecto más de 14 días."
8. Entrega a humano: si ocupacion > 0.85 o hay una fila vacía, entrego al editor de turno con las filas, el valor y mi borrador. Plazo: 2 horas.
9. Ejemplo normal: t=120, ocupacion=0.71 → "Día 120: ocupacion 0.71, umbral 0.85. Sin alerta. Fuente: salidas_E017.csv."
10. Ejemplo de entrega: t=290, ocupacion=0.91 → "ALERTA día 290: ocupacion 0.91 supera 0.85. Por B1 la letalidad puede subir. No recomiendo acciones (G3). Entrego al editor."
Las 5 anclas del ejemplo: datos_E017.csv, ocupacion, B1, 0.85, R2 de 14 días. Están las cinco.
3. El harness (sección 4 de la plantilla)
Harness significa arnés. Es lo que sujeta al empleado para que corra sin soltarse. Tiene 7 casillas.
| Casilla | Qué escribes | Ejemplo del Vigía de camas |
|---|---|---|
| Disparador | Cuándo arranca. | "Cada día a las 08:00, cuando salidas_E017.csv tiene una fila nueva." |
| Formato de entrada | Qué recibe, exacto. | "CSV largo: t, variable, valor, origen. Solo la variable ocupacion de los últimos 7 días." |
| Formato de salida | Qué entrega, exacto. | "Lista de 3 puntos, máximo 60 palabras. Nada más." |
| 3 pruebas | Una normal, una de borde, una de rechazo. Con su resultado esperado. | "0.71 → sin alerta. 0.85 exacto → sin alerta. Fila vacía → dice que falta y no inventa." |
| Registro | Qué se guarda, dónde, cuánto tiempo. | "Fecha, 7 valores, mensaje, id del modelo. En registro_vigia.csv, 90 días." |
| Interruptor | Quién lo apaga y cómo, en menos de 5 minutos. | "El editor o el analista quitan la tarea diaria y borran la llave del gestor de llaves." |
| Costo | Cuánto cuesta al mes, con su cálculo. | "30 llamadas al mes por 2,000 tokens: menos de 20,000 COP." |
Cómo escribir las 3 pruebas
- Normal: una fila real donde el empleado debe hacer su trabajo normal.
- Borde: el valor justo en el umbral, o el primer día, o un día sin datos nuevos.
- Rechazo: una entrada que activa R0, R1 o R2. La salida esperada es la frase de rechazo.
Si no puedes escribir la prueba de rechazo, tu R2 no está claro. Vuelve al prompt.
4. Lista de chequeo antes de descargar el HTML
- La misión tiene un número de mi dashboard y mi ciclo con letra.
- Las entradas nombran mi CSV y mi nodo exacto.
- Hay 3 o más rails y uno nace del ciclo.
- R0 y R1 están iguales a los fijos. R2 nace del ciclo.
- Hay un ejemplo normal y uno de rechazo con filas reales.
- El harness tiene las 7 casillas y las 3 pruebas tienen resultado esperado.
- No hay llaves ni contraseñas en ninguna casilla.