Capítulo 5 — Comunicación en ingeniería
Mapa de la lección
Lección 05 publicada. Mapa, ejemplo, EX013.
flowchart TD
N0["Resultados de aprendizaje"]
N1["5.1 Los documentos del ingeniero"]
N2["5.2 Comunicar la incertidumbre"]
N3["5.3 Documentar componentes de IA"]
N4["5.4 Públicos"]
N5["5.5 Estructura y trazabilidad"]
N6["Síntesis del capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6
N6 --> EX["Ejemplo resuelto"]
EX --> Q["Ejercicio EX013"]
Dibujo lógico
flowchart LR
N0["Resultados de aprendizaje"]
N1["5.1 Los documentos del ingeniero"]
N2["5.2 Comunicar la incertidumbre"]
N3["5.3 Documentar componentes de IA"]
N4["5.4 Públicos"]
N5["5.5 Estructura y trazabilidad"]
N6["Síntesis del capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> Q["EX013"]
[Resultados de aprendizaje]
|
v
[5.1 Los documentos del ingeniero]
|
v
[5.2 Comunicar la incertidumbre]
|
v
[5.3 Documentar componentes de IA]
|
v
[5.4 Públicos]
|
v
[5.5 Estructura y trazabilidad]
|
v
[Síntesis del capítulo]
|
v
[Ejemplo resuelto] --> [Ejercicio EX013]
Resultados de aprendizaje
Usted será capaz de (1) redactar documentos técnicos claros (requisitos, notas de diseño, informes de pruebas, resúmenes de incidentes); (2) comunicar la incertidumbre y el riesgo con honestidad; (3) adaptar los mensajes a ingenieros, directivos y reguladores; y (4) documentar componentes de IA con fichas de modelo y fichas técnicas de conjuntos de datos.
5.1 Los documentos del ingeniero
Los requisitos dicen lo que un sistema debe hacer y lo que no debe hacer. Las notas de diseño explican las decisiones y sus alternativas. Los informes de pruebas indican qué se probó, cómo, los resultados y los límites. Los resúmenes de incidentes indican qué ocurrió, el impacto, la causa y las acciones. Cada uno tiene un lector que debe tomar una decisión; escriba para esa decisión. Escribir para una decisión cambia lo que va primero. Un directivo que decide si desplegar TrackEye necesita el riesgo y las opciones en la primera página; un probador que repite la evaluación necesita el método completo. Sam abre cada documento con una frase que nombra a su lector y la decisión que respalda, lo que también le muestra qué puede omitir.
5.2 Comunicar la incertidumbre
Nunca escriba «el modelo es seguro». Escriba «en las condiciones probadas (enumeradas), la tasa de falsos negativos fue del 2,1 % (intervalo del 95 %: 1,6–2,7 %); entre las condiciones no probadas están la nieve intensa y las marcas deliberadas». Los números con intervalos y condiciones explícitas permiten a los lectores juzgar por sí mismos. Separe los hechos (medidos), las valoraciones (su juicio) y las recomendaciones. El intervalo indica al lector cuánto podría variar la cifra si la prueba se repitiera con datos nuevos. Enumerar las condiciones no probadas es igual de importante, porque, si no, los lectores suponen que el resultado las cubre. Mantener hechos, valoraciones y recomendaciones en párrafos separados permite que un lector que discrepa de una valoración siga confiando en las mediciones en que se apoya.
5.3 Documentar componentes de IA
Las fichas de modelo (model cards; Mitchell et al., arXiv:1810.03993) describen el uso previsto de un modelo, los usos fuera de alcance, los datos de evaluación, las métricas desglosadas por factores pertinentes y las consideraciones éticas. Las fichas técnicas de conjuntos de datos (datasheets for datasets; Gebru et al., arXiv:1803.09010) describen la motivación, la composición, la recogida, el preprocesamiento, los usos, la distribución y el mantenimiento. Ambas hacen visibles los supuestos ocultos para los ingenieros posteriores y los auditores. En el caso de TrackEye, la ficha técnica registra que la mayoría de las imágenes de entrenamiento procedían de recorridos diurnos sobre vía de ancho estándar, lo que explica las debilidades posteriores al amanecer y en tipos de carril poco habituales. Un equipo posterior que planee reutilizar el modelo puede ver esa limitación antes de desplegarlo, en lugar de descubrirla en servicio.
5.4 Públicos
Los ingenieros necesitan interfaces y modos de fallo precisos. Los directivos necesitan el riesgo, el coste y las opciones. Los reguladores y auditores necesitan evidencia trazable vinculada a los requisitos. El mismo hecho puede aparecer en tres formas. El problema de los falsos negativos al amanecer muestra las tres formas. Para los ingenieros: los falsos negativos suben al 9 % entre las 05:00 y las 07:00 a 60–80 km/h, con el conjunto de prueba identificado. Para los directivos: las inspecciones al amanecer pasan por alto más defectos, hay una corrección en marcha y existe una comprobación manual provisional. Para los auditores: el hallazgo, el requisito al que afecta, el registro de la prueba y la acción correctiva, cada uno con un identificador.
5.5 Estructura y trazabilidad
Numere los requisitos (REQ-SEC-012) y remita a ellos desde las notas de diseño y los informes de pruebas, de modo que cualquiera pueda seguir un requisito hasta su evidencia. Use tablas para las condiciones y los resultados, figuras para las tendencias y párrafos breves para el razonamiento. Ponga primero la conclusión y después el método para los lectores que deciden; invierta el orden para los revisores que deben comprobar el método. Versione cada documento y mantenga un registro de cambios: una evaluación que era cierta para el modelo v1.3 puede ser falsa para la v1.4. Cada entrada del registro de cambios anota qué cambió, por qué y qué resultados deja sin validez.
5.6 Ejemplo resuelto (caso sintético de NRS)
El primer informe de pruebas de TrackEye de Sam decía «funciona bien en la mayoría de las condiciones». El supervisor se lo devolvió. La versión revisada tenía un resumen de un párrafo para los directivos («los falsos negativos al amanecer son 4,5 veces los diurnos; corrección en curso; provisionalmente, segunda comprobación visual al amanecer»), una tabla por condición con intervalos para los ingenieros y una sección de ficha de modelo que indicaba los usos fuera de alcance (no validado para carriles de tranvía ni con nieve).
La cifra de 4,5 veces es la tasa de falsos negativos al amanecer, del 9 %, dividida entre la diurna, del 2 %. La frase original no era falsa, pero no daba a los lectores nada sobre lo que actuar. La revisión permite que cada lector encuentre lo que necesita sin leer el resto.
5.7 Errores y límites
- Afirmaciones absolutas («seguro», «a salvo») sin condiciones.
- Mezclar medición y opinión.
- Fichas de modelo escritas una vez y nunca actualizadas.
Las afirmaciones absolutas tientan porque suenan seguras, pero un solo contraejemplo las desmonta y, con ellas, la confianza del lector. Mezclar medición y opinión impide cuestionar una sin cuestionar la otra. Una ficha de modelo que describe la versión 1.3 adjunta a la versión 1.5 es peor que no tener ninguna, porque los lectores confían en ella; Sam vincula cada ficha a una versión del modelo y la actualiza en el mismo cambio que publica el modelo.
Ejercicios — capítulo 5
- EX013 — Reescritura. Reescriba «Wrench está a salvo de la inyección de prompts» como una afirmación honesta. Rúbrica: 3 = condiciones, métrica con intervalo, áreas no probadas; 2 = dos; 1 = una; 0 = sin cambios.
- EX014 — Ficha de modelo. Enumere cinco secciones de una ficha de modelo para TrackEye. Rúbrica: 3 = cinco pertinentes; 2 = cuatro; 1 = dos; 0 = nada.
- EX015 — Públicos. Redacte el mismo hallazgo del amanecer para un directivo y para un auditor. Rúbrica: 3 = directivo: riesgo/acción; auditor: evidencia y vínculo con el requisito; 2 = uno bien; 1 = vago; 0 = nada.
Síntesis del capítulo
Una comunicación clara y honesta (condiciones, intervalos, hechos separados de las recomendaciones, y modelos y conjuntos de datos documentados) es la forma en que la evidencia de ingeniería llega a quienes deciden.
Siga estudiando — capítulo 05 de 50
← Capítulo 04 (borrador) · Índice de capítulos del curso · Capítulo 06 (borrador) →