Saltar al contenido

Manual de instrucciones en diálogo: tres roles de IA escriben, respaldan y comprueban su manual

Todas las capturas de pantalla proceden de la aplicación en funcionamiento (interfaz en inglés), proyecto de demostración prensa empacadora BP-200

El manual de instrucciones según el anexo I, punto 1.7.4, de la Directiva de máquinas no es prosa que se le encarga «rápidamente» a un chatbot. Forma parte de las evidencias de conformidad; cada cifra que contiene tiene consecuencias. El manual de instrucciones en diálogo lo resuelve con tres roles: un curador mantiene la ficha informativa a partir de los datos de su proyecto, un autor escribe de forma visible en el documento y un revisor señala todo lo que no está acreditado. Este artículo muestra, con una sesión real, qué aspecto tiene, dónde está la gran ventaja y dónde están los límites.

Por qué un chatbot no debería escribir manuales de instrucciones

La tentación es obvia: pegar la descripción de la máquina en un modelo de lenguaje, «Escríbeme el capítulo 3, datos técnicos», y en segundos hay un texto fluido. El problema no es el estilo, sino la procedencia. Un modelo genérico no conoce su máquina. Conoce miles de manuales de instrucciones y añade lo que suele aparecer en ellos: 400 V, 50 Hz, un nivel de presión acústica inferior a 70 dB(A), mantenimiento cada 500 horas de servicio. Plausible, listo para imprimir y posiblemente incorrecto para su máquina.

El anexo I, punto 1.7.4.2, prescribe el contenido del manual de instrucciones, desde el uso previsto hasta los riesgos residuales y la información sobre la emisión de ruido. Este contenido debe coincidir con la evaluación del riesgo y con la declaración de conformidad; de lo contrario, el expediente técnico se contradice a sí mismo. En los textos de IA escritos libremente aparecen una y otra vez tres patrones de error:

  • Cifras inventadas. Valores que no aparecen en ningún lugar del proyecto pero suenan tan evidentes que pasan la revisión.
  • Capítulos de seguridad genéricos. Advertencias de manual en lugar de los riesgos residuales que su evaluación del riesgo identifica realmente.
  • Sin trazabilidad. Nadie puede decir después de dónde salió una frase, si sigue correspondiendo al estado actual de la evaluación del riesgo y quién la comprobó.

Tres roles en lugar de un solo chatbot

El manual de instrucciones en diálogo separa saber, escribir y comprobar. Los tres roles trabajan sobre la misma ficha informativa y ninguno puede imponerse a otro: el autor solo puede escribir lo que el curador ha acreditado, y el revisor lo señala si lo hace de todos modos. Los roles se ejecutan con modelos Claude de Anthropic: el autor con el más potente, el curador y el revisor de secciones con modelos rápidos.

RolTareaQué ve usted de ello
CuradorElabora la ficha informativa a partir del proyecto, la evaluación del riesgo, la lista de comprobación de normas, la declaración de conformidad, los valores de ensayo y las funciones de seguridad. Cada hecho lleva su referencia y su fecha. 14 reglas de lagunas detectan lo que todavía falta; las contradicciones entre sus datos y la base de datos se señalan.Pestaña «Ficha informativa» con contador, categorías, origen de cada hecho y lagunas pendientes.
AutorEscribe en el documento exclusivamente mediante herramientas: escribir sección, insertar tabla, colocar advertencia, redactar capítulo. Primero lee lo que hay. Si falta un dato, pregunta o coloca un marcador de posición con nombre. No adivina.Chips de herramienta por ronda, la sección toma forma en directo en el documento, preguntas con campos de respuesta.
Revisor21 reglas de comprobación fijas con su referencia en el anexo I, además de una comprobación por IA de cada sección nueva frente a la ficha informativa: cifras no acreditadas, normas inventadas, afirmaciones de conformidad, advertencias sin la estructura en tres partes.Pestaña «Revisor» con hallazgos rojos, amarillos e informativos, cada hallazgo también directamente debajo de la sección afectada.

Cómo transcurre una sesión

La vista está concebida deliberadamente como una conversación: a la izquierda el historial con el campo de entrada abajo, a la derecha el documento con las pestañas Documento, Ficha informativa y Revisor. El panel puede contraerse, igual que la barra lateral de la aplicación. Las siguientes capturas proceden de una sesión real con el proyecto de demostración, una prensa empacadora hidráulica.

1. Dar una instrucción

Basta una frase, o una de las tarjetas de sugerencia. Arriba a la derecha del documento ya se ve lo que la ficha informativa sabe del proyecto; el contador del campo de entrada indica cuántos datos siguen pendientes.

Vista inicial del manual de instrucciones en diálogo: a la izquierda la pregunta «¿Qué debe incluirse en el manual de instrucciones?» con campo de entrada y cuatro tarjetas de sugerencia, a la derecha el documento con los capítulos 1 y 2 de la prensa empacadora BP-200
Vista inicial: a la izquierda la instrucción al autor con tarjetas de sugerencia, a la derecha el documento. El contador «10 datos pendientes» muestra lo que la ficha informativa todavía no conoce.

2. El autor lee y escribe de forma visible

Antes de cada cambio, el autor lee la sección existente. Después el texto nuevo va tomando forma en directo en el documento de la derecha, palabra por palabra, con el aviso «El autor está escribiendo». Cada ronda puede cancelarse con «Detener».

El autor trabajando: a la izquierda la instrucción «Reescribe la sección Uso previsto del capítulo 2», abajo a la izquierda el botón Detener, a la derecha el documento
Tras la instrucción, el autor trabaja de forma visible. La sección escrita aparece en el documento de la derecha mientras se escribe; cada ronda puede detenerse.

3. Herramientas, respuesta, comprobación

Tras la ronda, unos chips muestran qué herramientas ha usado el autor. Su respuesta en el chat se mantiene breve: qué ha hecho, qué queda pendiente, qué decisión debe tomar usted. El texto del capítulo nunca se repite en el chat; está en el documento. En segundo plano, el revisor repasa la sección nueva.

Ronda terminada: chips de herramienta «lee sección: Seguridad / 2.1» y «escribe sección: Seguridad / 2.1», debajo la breve respuesta del autor, a la derecha la nueva sección 2.1 en el documento
Cada ronda muestra lo que ha hecho el autor: primero leer, luego escribir. La respuesta en el chat se mantiene breve; el texto está en el documento.

Pruébelo usted mismo: una sesión en 90 segundos

La demo reproduce una sesión con textos de ejemplo fijos, sin solicitud a una IA y sin iniciar sesión. Responda a la pregunta y seleccione después una frase del documento para solicitar un cambio en un punto concreto. En la aplicación, el autor escribe a partir de los datos de su proyecto.

Prensa empacadora hidráulica BP-200 · Directiva 2006/42/CE relativa a las máquinas · sesión simulada, sin solicitud a la IA
2 Seguridad
2.1 Uso previsto
La máquina está destinada a compactar cartón y film. No deben procesarse otros materiales.
2.2 Mal uso razonablemente previsible

Acceso a la cámara de prensado durante la carrera, anulación de la puerta de carga enclavada …

Preguntas en lugar de suposiciones

La diferencia más importante con un chatbot se ve cuando falta algo. Para la tabla «Datos técnicos», la ficha informativa de la prensa empacadora conoce por la evaluación del riesgo la presión de servicio, la fuerza de prensado y el peso de la bala, pero no la masa total, ni las dimensiones, ni los valores de conexión eléctrica. El autor crea la tabla con los valores acreditados y plantea, para el resto, hasta tres preguntas concretas con campos de respuesta.

Preguntas del autor con tres campos de respuesta: masa total, dimensiones y valores de conexión eléctrica, debajo los botones «Enviar respuestas» y «Más tarde»
Si faltan datos, el autor pregunta en lugar de adivinar. Las preguntas vienen con campos de respuesta; cada respuesta se convierte en un hecho acreditado.

Sus respuestas no se quedan en el historial como texto suelto; se convierten en hechos marcados como «Su dato». En la ronda siguiente el autor las usa directamente, aquí para la tabla del capítulo 3.

Preguntas respondidas en el historial y respuesta del autor: los tres valores se han añadido al capítulo 3 en forma de tabla
Las respuestas llegan a la ficha informativa y de inmediato a la tabla «Datos técnicos» del capítulo 3. El autor pregunta si debe fusionar las dos tablas.

La ficha informativa puede consultarse en cualquier momento. Es la base sobre la que trabaja el autor y frente a la que comprueba el revisor: los hechos por categoría, cada uno con origen y fecha, más las lagunas pendientes. Si un dato de la conversación contradice la base de datos, el hecho se marca como contradicción y el autor pregunta en lugar de decidir.

Pestaña Ficha informativa: versión y número de hechos, lagunas pendientes, categorías como Datos técnicos con valores y origen; los datos procedentes del diálogo llevan la marca «Su dato»
La ficha informativa del curador: arriba las lagunas pendientes, debajo los hechos por categoría, cada uno con origen y fecha. Los datos de la conversación llevan la marca «Su dato»; las contradicciones con la base de datos se señalan.

Si prefiere cerrar las lagunas de una vez, el contador del campo de entrada abre el formulario «Responder datos pendientes». Lo que introduzca se incorpora como hecho acreditado sin pasar por un modelo. Lo que no sepa se queda vacío; en esos puntos el texto recibe un marcador de posición con nombre que el revisor señala hasta la aprobación.

Formulario «Responder datos pendientes» sobre el campo de entrada con preguntas sobre condiciones ambientales, puntos de elevación, cimentación y elementos de mando, contador «0 de 7 respondidas»
Todos los datos pendientes de un vistazo: lo que introduzca aquí pasa a la ficha informativa como hecho acreditado. Lo que no sepa se queda vacío.

El revisor: el anexo I como regla de comprobación

El revisor trabaja en dos niveles. 21 reglas de comprobación fijas se ejecutan con cada cambio, sin modelo, con su referencia en el anexo I. Además, una IA comprueba cada sección recién escrita frente a la ficha informativa: cifras sin evidencia, normas que no figuran en la lista de comprobación de normas, afirmaciones de conformidad que no proceden de la declaración. Ejemplos de las reglas fijas:

  • capítulo obligatorio según el anexo I, punto 1.7.4.2, vacío u oculto
  • marcadores de posición abiertos en el texto («[indicar la masa total facilitada por el fabricante]»)
  • advertencia sin las tres partes: tipo y origen del peligro, consecuencias y medidas correctoras
  • ninguna sección sobre la resolución de averías (anexo I, punto 1.7.4.2, letras r) y s))
  • figura sin pie, tabla sin título ni fila de encabezado, referencia cruzada sin destino
  • Markdown o títulos duplicados que estropearían la exportación
  • capítulos cuyos datos de proyecto han cambiado desde que se escribieron
  • peligros con un riesgo residual alto y no aceptado que no se tratan en el capítulo de seguridad

Cada hallazgo aparece en la pestaña Revisor y directamente debajo de la sección afectada. «Solucionar» lo convierte en una instrucción para el autor. «Ignorar» exige una justificación que se registra en el proyecto, de modo que después siga siendo trazable por qué una observación no se aplicó deliberadamente.

Pestaña Revisor con tres hallazgos: dos reglas de comprobación rojas L01 por los capítulos obligatorios vacíos Montaje y Mantenimiento, una regla de comprobación amarilla L14 por la sección que falta sobre la resolución de averías
El revisor indica para cada hallazgo la referencia en el anexo I. Los hallazgos rojos afectan a contenido obligatorio, los amarillos a la forma. Cada hallazgo puede hacerse corregir o ignorarse con una justificación.

Marcar, pedir el cambio, seguir

La mayoría de los cambios en un manual de instrucciones son pequeños: una frase demasiado larga, una lista en lugar de un párrafo, una nota que falta. Para ello se marca el pasaje en el documento. En la posición del ratón aparece «Cambiar en el diálogo», el pasaje pasa al campo de entrada como cita y usted escribe qué debe ser distinto. El autor lee la sección, cambia solo el pasaje marcado y deja el resto palabra por palabra.

Frase marcada en la sección 2.1 del documento; en la posición del ratón aparece el botón «Cambiar en el diálogo»
Marcar texto en el documento, hacer clic en «Cambiar en el diálogo»: el pasaje pasa al campo de entrada como cita.
Campo de entrada con la tarjeta de cita «Pasaje marcado · 2 Seguridad / Uso previsto» y la instrucción «Reformula este pasaje como lista con viñetas, una frase por punto»
La instrucción se refiere exactamente al pasaje marcado. El autor lee la sección, cambia solo ese pasaje y deja el resto palabra por palabra.

Para todo lo que ningún modelo de lenguaje debería hacer, cada capítulo tiene el botón «Editar»: su propio texto, imágenes con pie de figura, tablas (también pegadas desde una hoja de cálculo), los datos de cabecera de la portada con imagen de título y la elección de si las figuras y tablas se numeran de forma consecutiva o por capítulo. La estructura en sí, es decir, sus propios capítulos y su orden, se gestiona en el editor avanzado.

Qué se obtiene al final

La exportación en PDF o Word contiene los doce capítulos según el anexo I, punto 1.7.4, con índice, índice de figuras e índice de tablas. Todas las tablas están numeradas, también las que el documento genera a partir del proyecto: el resumen de riesgos residuales de la evaluación del riesgo, las normas armonizadas aplicadas y el registro de la evaluación del riesgo. Las referencias cruzadas como «véase la tabla 3» se resuelven al exportar; las advertencias aparecen con palabra de señalización, origen del peligro, consecuencias y medidas correctoras.

Menú de exportación abierto con «Imprimir como PDF», «Como archivo Word» y «Editor avanzado (estructura)»
Exportación en cualquier momento como PDF o Word, con índice, índice de figuras e índice de tablas. El editor avanzado sigue disponible para la estructura y el relleno masivo.

Cómo es una exportación completa de la misma máquina lo muestra el ejemplo de manual de instrucciones de 123 páginas en PDF, sin iniciar sesión. El PDF de ejemplo está en inglés; la plataforma genera el manual en alemán o en inglés.

La ventaja real

Muchas herramientas pueden escribir más rápido. La diferencia está en lo que hay que comprobar después. Con un texto de IA escrito libremente, se comprueba cada frase para saber de dónde procede. Con el manual de instrucciones en diálogo se comprueban una ficha informativa y una lista de hallazgos.

Cada afirmación tiene una referencia

El autor solo puede usar lo que está en la ficha informativa o lo que usted le indica. La ficha informativa nombra la fuente de cada hecho, por ejemplo «evaluación del riesgo, límites de la máquina» o «Su dato». Usted comprueba fuentes, no prosa.

Las lagunas se convierten en preguntas, no en texto

Un modelo de lenguaje genérico rellena una potencia de conexión que falta con un valor plausible. El autor, en cambio, hace la pregunta, y su respuesta queda después acreditada en la ficha informativa y en el capítulo.

El documento sigue vinculado a la evaluación del riesgo

Los riesgos residuales y las normas aplicadas llegan como tablas numeradas directamente desde el proyecto. Si cambia la evaluación del riesgo, el revisor señala los capítulos afectados como desactualizados, y basta una instrucción para ponerlos al día.

Usted ve cada paso y mantiene el control del documento

Nada entra en el manual sin su instrucción. Cada llamada a una herramienta es visible, cada ronda puede detenerse y cada capítulo sigue siendo editable a mano, con sus propias figuras y tablas.

Lo que el diálogo no hace

Un documento que parece completo despierta enseguida la expectativa de «ya está todo». Por eso el límite forma parte de él:

  • La revisión técnica y la aprobación. Cada texto es un borrador elaborado con los datos de su proyecto, del que usted, como fabricante, es responsable.
  • Los valores de diseño que no están en el proyecto. En lugar de cifras inventadas, el autor coloca marcadores de posición con nombre o pregunta.
  • Las figuras de la máquina. Las imágenes las sube usted; los pies de figura y la numeración los gestiona el documento.
  • Las traducciones a otras lenguas oficiales y la indicación como traducción.
  • Las afirmaciones de conformidad que no se tomen literalmente de la declaración de conformidad del proyecto.

Disponibilidad y precio

El manual de instrucciones en diálogo es un módulo adicional de los planes Professional y Business y se desbloquea una vez por proyecto por 12,99 €, sin cuota recurrente. El cupo de uso razonable es de 100 rondas de diálogo al mes en el plan Professional y de 200 en el plan Business, compartidas en el equipo. Una ronda es una instrucción con todas las llamadas a herramientas que le corresponden. La edición manual y la exportación son ilimitadas. Los proyectos que ya habían desbloqueado el manual de instrucciones usan el diálogo sin coste adicional. El historial de la conversación se guarda con el proyecto; los detalles están en la política de privacidad.

FAQ

Preguntas frecuentes sobre el manual de instrucciones en diálogo

¿El autor de IA inventa valores cuando falta algo?
No, y ese es el núcleo del modo. Las únicas fuentes admisibles para las afirmaciones específicas de la máquina son la ficha informativa y su mensaje actual. Si falta un dato, el autor plantea una pregunta con un campo de respuesta o coloca un marcador de posición con nombre. Además, el revisor señala cada cifra y cada norma que no esté acreditada en la ficha informativa.
¿Cómo sé de dónde procede una afirmación del texto?
En la pestaña «Ficha informativa», cada hecho muestra su origen con la fecha, por ejemplo «evaluación del riesgo, peligro n.º 3» o «declaración de conformidad». Los datos de la conversación se marcan como «Su dato» o «del diálogo». Las contradicciones entre un dato de la conversación y la base de datos se señalan, y el autor pregunta en lugar de decidir.
¿Puedo escribir texto yo mismo e insertar imágenes?
Sí. Cada capítulo del documento tiene un botón «Editar» que abre el editor de capítulos directamente en el panel: texto, imágenes con pie de figura, tablas (también pegadas desde Excel) y etiquetas. Los números de figuras y tablas se asignan automáticamente, de forma consecutiva o por capítulo. Para la estructura en sí sigue disponible el editor avanzado.
¿Qué ocurre si la evaluación del riesgo cambia más adelante?
El curador actualiza los hechos desde la base de datos en cada ronda. Los capítulos escritos con un estado anterior reciben la nota del revisor «Los datos del proyecto han cambiado desde que se escribió esto». Una instrucción como «Actualiza el capítulo 2 con la evaluación del riesgo actual» pone el texto al día; la tabla de riesgos residuales procede, de todos modos, del estado actual al exportar.
¿Cuántas rondas necesito para un manual de instrucciones?
Un borrador de capítulo es una ronda, una sección reformulada también lo es, y una pregunta respondida igualmente. Para doce capítulos con preguntas, tablas y corrección de hallazgos, normalmente bastan unas pocas decenas de rondas. El cupo mensual de 100 rondas del plan Professional (200 en el plan Business, compartidas en el equipo) está pensado para uno o dos manuales de instrucciones al mes. La edición manual y la exportación no cuentan como rondas.
¿Sirve también para el Reglamento de máquinas a partir de 2027?
Sí. El marco normativo procede del proyecto: hoy el anexo I, punto 1.7.4, de la Directiva 2006/42/CE relativa a las máquinas; a partir del 20 de enero de 2027, el anexo III del Reglamento (UE) 2023/1230. El autor conoce ambas referencias y la estructura de capítulos está pensada para las dos.
¿Cuánto cuesta el manual de instrucciones en diálogo?
12,99 € una sola vez por proyecto en los planes Professional y Business, sin cuota recurrente. Los proyectos que ya habían desbloqueado el manual de instrucciones usan el diálogo sin coste adicional. El historial de la conversación se guarda con el proyecto; los detalles están en la política de privacidad.
¿El diálogo sustituye a un redactor técnico?
No. Le quita de encima el primer borrador y lo mantiene vinculado a los datos del proyecto. El estilo, la exhaustividad respecto al producto concreto, la adecuación al público destinatario según la norma EN IEC/IEEE 82079-1 y la aprobación siguen siendo tarea del fabricante y de su equipo de redacción.

Fuentes

Una nota sobre nosotros: el manual de instrucciones en diálogo forma parte de CE-Copilot y requiere un proyecto con una evaluación del riesgo, porque la ficha informativa se construye a partir de ella. Cómo es una exportación terminada lo muestra el ejemplo gratuito de manual de instrucciones, y el camino hasta ahí, la prueba gratuita.

Más artículos