Ingeniería de requisitos agéntica
Los agentes de IA ofrecen ventajas sustanciales para tareas de ingeniería como la captura de requisitos, ya que mejoran significativamente la eficiencia y automatizan flujos de trabajo complejos y repetitivos. El Engineering Assistant de Requirements Portal aprovecha tecnologías de IA para proporcionarle una herramienta de revisión rápida y automatizada de sus requisitos que le permite hacer preguntas sobre los requisitos de su proyecto actual en lenguaje natural y libre, y obtener respuestas rápidas sin filtrar ni buscar manualmente entre los requisitos, por ejemplo:
-
How many requirements are not verified?
-
Are there any engineering gaps in these requirements?
-
Show me all requirements about the power supply.
-
Which requirements need to be taken into account for PCB design?
-
Do any requirements conflict with each other?
-
Give me an overview of all battery-related requirements.
El Engineering Assistant también puede modificar, crear o eliminar requisitos. Cuando envíe una solicitud para crear un requisito nuevo, o cambiar o eliminar un requisito existente, el Engineering Assistant le proporcionará un resumen de los cambios que se aplicarán, y usted podrá revisarlos y luego aplicar o descartar los cambios. Ejemplos de dichas solicitudes:
-
Generate requirements for a lightweight drone power supply that takes a 6S LiPo input, provides regulated 5 V / 5 A and 12 V / 3 A outputs, and weighs under 150 g. It should handle vibration and -10°C to +50°C operation, with protection for short circuit, reverse polarity, overtemperature, and low battery.
-
Change the required maximum operating temperature for all parts to 60°C.
-
Can you identify all requirements that affect the sizing of the power system and ensure they are verifiable?
-
In the new design, I've replaced the camera with an IR sensor. Remove all requirements that were related to the camera.
El Engineering Assistant está habilitado de forma predeterminada. Si es necesario, un administrador del Workspace puede deshabilitarlo mediante la opción External Provider en la página Settings – ValiAssistant (a la que se accede haciendo clic en el icono 
en la parte superior derecha, seleccionando Settings en el menú que aparece y, a continuación, seleccionando ValiAssistant en la lista del panel izquierdo) – 
.
Se accede al Engineering Assistant mediante el panel Engineering Assistant disponible en el Requirement Module, haciendo clic en el icono 
en la parte superior derecha.
Puede ver el contexto actual del chat haciendo clic en el botón 
en la parte inferior del panel Engineering Assistant. Se abrirá la ventana emergente Chat Context, que presenta la siguiente información:
-
Project – muestra el nombre del proyecto actual y el nombre de la carpeta, especificación o sección actualmente seleccionada.
-
Filters – muestra el número de filtros aplicados actualmente a la tabla y la lista de columnas a las que se aplican los filtros.
-
Rows selected – muestra el número de filas de requisitos seleccionadas actualmente.
Haga clic en el botón para abrir la ventana emergente Chat Context. En este ejemplo, la región Project muestra el nombre del proyecto actual (Drone_Example_Project) y el nombre de la especificación actualmente seleccionada (Drone_Requirements).
Para usar el Engineering Assistant, escriba su consulta en el campo Ask anything situado en la parte inferior del panel Engineering Assistant y haga clic en el icono 
o pulse Enter. El Engineering Assistant analizará los requisitos y presentará una respuesta pertinente en el panel. Según la consulta, el Engineering Assistant devolverá una respuesta numérica, una lista de ID de requisitos, o un breve resumen. El/los requisito(s) relacionado(s) con la consulta se resaltarán en la tabla de requisitos, y el número de requisitos relacionados se mostrará en el árbol del proyecto junto a las especificaciones, secciones y carpetas correspondientes.
-
Puede copiar una solicitud enviada previamente o una respuesta del Engineering Assistant. Haga clic en el botón
debajo de una solicitud o respuesta para copiar su contenido al portapapeles.
-
Puede desplazarse por los prompts enviados anteriormente utilizando las teclas
Arrow UpyArrow Downcuando el cursor esté dentro del campo de texto.
Cuando envíe una solicitud al Engineering Assistant para crear un requisito nuevo, o cambiar o eliminar un requisito existente, los cambios sugeridos se mostrarán en un mosaico dedicado dentro del panel Engineering Assistant, donde podrá revisarlos (expandiendo la región contraíble Changes summary) y luego aplicar o descartar los cambios. Además, los cambios sugeridos serán visibles en la tabla de requisitos de la siguiente manera:
-
Los requisitos nuevos se resaltan en verde, con el icono en el icono
de la columna Identifier.
-
Los requisitos modificados se resaltan en morado, con el icono
en la columna Identifier. Los cambios reales también se resaltan en la tabla.
-
Los requisitos sugeridos para su eliminación se resaltan en rojo, con el icono
en la columna Identifier.
-
El Engineering Assistant admite diálogos de varios turnos dentro de una sesión; es decir, recuerda el contexto de la conversación actual para consultas de seguimiento relevantes. Por ejemplo, si el Engineering Assistant ha enumerado varios requisitos en respuesta a una consulta y luego usted pregunta How many of those are high priority?, el asistente entiende que those se refiere a los requisitos enumerados previamente y responde en consecuencia. De ese modo, puede mantener una “conversación” refinando o profundizando en la información sin tener que restablecer el contexto.
-
Al acceder por primera vez al panel Engineering Assistant (o después de iniciar una nueva conversación), se presentarán varios ejemplos de consultas en el panel (
). Si la especificación seleccionada actualmente no contiene requisitos, se le sugerirá que primero cree requisitos (
). Haga clic en el botón correspondiente para aplicar una consulta/acción.
-
El Engineering Assistant le permite realizar una búsqueda en una carpeta específica.
-
Cuando no se pueda acceder al servicio del Engineering Assistant o este produzca algún error, se mostrará en el panel un mensaje de error que indica el fallo. Haga clic en el botón Retry para volver a intentar la última solicitud fallida.
-
Para borrar la conversación actual e iniciar una nueva, haga clic en el icono
en la parte inferior del panel Engineering Assistant. Tenga en cuenta que solo hay disponible una conversación a la vez (es decir, no existe historial de conversaciones).
Uso y administración de AI Skills
Una skill es un conjunto reutilizable de instrucciones que el Engineering Assistant puede ejecutar para realizar una tarea específica de forma más consistente. Una skill encapsula cómo debe realizarse una tarea concreta de ingeniería —la intención, los límites, las entradas que necesita y los pasos a seguir— para que el mismo resultado se produzca de manera consistente, independientemente de quién la ejecute o cuándo, y sin que cada usuario tenga que explicar las mismas instrucciones cada vez.
Una skill puede tratarse como:
-
Un flujo de trabajo de ingeniería repetible
-
Un estándar organizativo hecho ejecutable
-
Una forma de empaquetar la experiencia y hacerla reutilizable
Las skills son invocadas automáticamente por la IA, que las selecciona y aplica automáticamente en función de su intención. No necesita memorizar comandos ni seleccionar skills manualmente. Cuando envía un mensaje, el Engineering Assistant:
-
Analiza su intención y el contexto actual.
-
Revisa las skills disponibles en el Workspace.
-
Compara su solicitud con la Short Description de cada skill para determinar qué skills son relevantes.
-
Selecciona la skill que mejor coincide.
-
Sigue las Instructions de la skill para realizar la tarea.
-
Devuelve el resultado para que usted lo revise.
Por ejemplo, cuando envía Rewrite these requirements using our company writing standard, el Engineering Assistant detecta la intención (estandarización de requisitos), identifica la skill cuya descripción breve mejor coincide con esa solicitud, ejecuta las instrucciones definidas en dicha skill y devuelve los requisitos mejorados.
Skill Use Examples
-
Break Down Complex Requirements – analizar los requisitos seleccionados y dividirlos en requisitos más pequeños y comprobables de forma independiente, preservando la intención original.
Ejemplo de prompt:
Break down these requirements. -
Apply Requirement Writing Standards – revisar requisitos y reescribirlos de acuerdo con las directrices de su organización para redactar requisitos. Las comprobaciones típicas incluyen ambigüedad, lenguaje no verificable, actores ausentes y criterios de aceptación poco claros.
Ejemplo de prompt:
Rewrite these requirements according to our requirement quality standard. -
Translate Requirements – traducir requisitos de un idioma a otro preservando el significado técnico, la terminología, los ID y las referencias de trazabilidad.
Ejemplo de prompt:
Translate these requirements to German. -
Classify Requirements – aplicar a los requisitos un esquema de clasificación organizativo, como Electrónica, Mecánica, Software, Seguridad funcional, Ciberseguridad u otras taxonomías específicas de la empresa.
Ejemplo de prompt:
Classify these requirements according to our applicability model. -
Generate Verification Criteria – analizar requisitos y proponer métodos de verificación, criterios de aceptación o condiciones de prueba que puedan utilizarse para demostrar el cumplimiento siempre de la misma manera.
Ejemplo de prompt:
Generate verification criteria for these requirements. -
Summarize a Specification/Section/Group of Requirements – generar un resumen conciso y estructurado de una especificación, una sección de requisitos o un conjunto de requisitos.
Ejemplo de prompt:
Summarize the selected requirements.
Cuando el Engineering Assistant procesa su solicitud basándose en una skill, la skill utilizada se mostrará en la región contraíble Check what I looked for del panel Engineering Assistant. Haga clic en el enlace para abrir la ventana AI Skills, con la skill correspondiente resaltada.
El conjunto de skills disponibles se administra mediante la ventana AI Skills, a la que se accede haciendo clic en el botón 
en la parte superior derecha del panel Engineering Assistant. Desde esta ventana, puede agregar nuevas skills y cambiar o eliminar skills existentes.
-
Las skills existentes se enumeran en la región Workspace Skills situada en el lado izquierdo de la ventana. Haga clic en una entrada para mostrar los detalles de la skill seleccionada.
-
Para agregar una nueva skill, haga clic en el botón
en la parte inferior izquierda de la ventana. Aparecerá una entrada para una nueva skill en la lista. Defina Name, Short Description y Instructions para una nueva skill y, a continuación, haga clic en el botón 
en la parte inferior derecha.
Consulte la sección contraíble Prácticas recomendadas para formular una skill a continuación para obtener detalles sobre cada campo.
-
Para editar una skill existente, selecciónela en la lista, cambie sus campos según sea necesario y, a continuación, haga clic en el botón
en la parte inferior derecha.
-
Para eliminar una skill existente, selecciónela en la lista, haga clic en el botón
en la parte inferior derecha y, a continuación, confirme la eliminación.
Las skills también pueden administrarse en la página Settings – AI Skills (a la que se accede haciendo clic en el icono 
en la parte superior derecha, seleccionando Settings en el menú que aparece y, a continuación, seleccionando AI Skills en la lista del panel izquierdo)
Best Practices for Formulating a Skill
Una buena skill ayuda a la IA a comprender dos cosas:
-
Cuándo debe usarse la skill
-
Qué debe hacer la IA cuando se ejecute la skill
Al definir una skill,
Esto se expresa mediante tres campos, donde cada campo tiene un propósito diferente:
-
Name – le ayuda a reconocer la skill.
-
Short Description – ayuda a la IA a decidir cuándo la skill es relevante.
-
Instructions – define el comportamiento que la IA debe seguir una vez seleccionada la skill.
Consulte las secciones siguientes para obtener detalles sobre cada campo.
Nombre
El Name debe ser breve, claro y orientado a la acción. Debe ayudarle a comprender rápidamente qué se pretende hacer con la skill. Un buen nombre suele describir la acción y el tipo de datos de ingeniería con los que trabaja la skill.
Un buen nombre de skill debe ser:
-
Lo suficientemente específico como para distinguir la skill de otras
-
Lo suficientemente breve como para poder escanearlo fácilmente en la lista de skills
-
Centrado en la tarea principal que realiza la skill
-
Redactado en un lenguaje que los usuarios comprendan de forma natural
Evite nombres demasiado amplios o genéricos. Si el nombre pudiera aplicarse a muchas tareas diferentes, probablemente no sea lo suficientemente específico.
Descripción breve
La Short Description ayuda a la IA a comprender de qué trata la skill y cuándo debe activarse. Este campo es importante porque no necesita seleccionar manualmente una skill. El asistente analiza su prompt, lo compara con las skills disponibles y decide si una skill es relevante.
Una buena descripción breve debe explicar:
-
Qué tarea realiza la skill
-
A qué tipo de datos de ingeniería se aplica
-
Cuándo debe usarse la skill
-
Qué resultado se espera que produzca la skill
La descripción breve debe ser concisa, pero no vaga. Debe incluir suficiente contexto para que la IA pueda distinguir esta skill de otras similares.
Una descripción breve deficiente solo indica a qué dominio pertenece la skill. Una descripción breve sólida explica la tarea específica, el contexto esperado y la situación que la activa. Por ejemplo, en lugar de describir una skill como algo que “ayuda con los requisitos”, la descripción debe explicar si la skill revisa la calidad de los requisitos, descompone requisitos complejos, traduce texto de requisitos, detecta conflictos, genera criterios de verificación o realiza otra acción específica.
Cuanto mejor explique la descripción breve el propósito de la skill y el contexto de uso, con mayor fiabilidad podrá el asistente decidir cuándo aplicarla.
Instrucciones
Las Instructions definen qué debe hacer la IA una vez seleccionada la skill. Este es el campo más importante para controlar el comportamiento de la skill. Mientras que la descripción breve ayuda a la IA a decidir cuándo usar la skill, las instrucciones definen cómo debe ejecutarse la skill.
Las buenas instrucciones deben redactarse como orientación clara, paso a paso. No deben limitarse a describir el resultado final, sino también el razonamiento y las restricciones que la IA debe seguir al producir ese resultado.
Las instrucciones deben explicar:
-
What the AI should analyze first – por lo general, el asistente debe comprender la intención de ingeniería, el contexto, la estructura o las relaciones antes de cambiar o generar cualquier cosa.
-
What steps the AI should perform – el comportamiento debe desglosarse en pasos explícitos, de modo que la salida sea repetible y predecible.
-
What the AI should preserve – esto puede incluir la intención original, los ID de requisitos, términos técnicos, unidades, valores, restricciones, referencias, aplicabilidad, jerarquía o contexto de trazabilidad.
-
What the AI must not do – las buenas skills impiden explícitamente que la IA invente detalles de ingeniería faltantes, cambie la intención, introduzca nuevas suposiciones o aplique cambios sin revisión del usuario.
-
How the AI should handle uncertainty – si falta información, es ambigua o insuficiente, la skill debe indicar a la IA que exponga claramente el problema en lugar de hacer suposiciones.
-
What output format is expected – la skill debe definir si el resultado debe ser una tabla, una lista con viñetas, texto reescrito, un resumen, una lista de comprobación o un informe estructurado.
Las buenas instrucciones son especialmente importantes para el trabajo de ingeniería porque el asistente puede estar trabajando con datos que afectan a especificaciones, validación, decisiones de diseño o implementación posterior. Por lo tanto, la skill debe guiar a la IA para que sea útil sin mostrarse excesivamente confiada.
Otras notas
-
El objetivo no es redactar un prompt largo. El objetivo es definir un procedimiento operativo claro para la IA.
-
Keep Skills Focused
Una skill debe realizar bien una tarea repetible.
Si una skill intenta hacer demasiadas cosas, al asistente le resulta más difícil saber cuándo usarla y a los usuarios les resulta más difícil confiar en la salida. Por ejemplo, una skill no debería combinar descomposición de requisitos, traducción, revisión de calidad, análisis de trazabilidad y generación de verificación, a menos que esas acciones formen intencionadamente parte de un flujo de trabajo único y estrechamente definido.
Si el propósito de la skill requiere varias acciones no relacionadas, divídalo en skills separadas.
-
Define Boundaries Clearly
Las buenas skills son explícitas respecto a sus límites.
Esto es especialmente importante al trabajar con requisitos, especificaciones y datos de ingeniería. El asistente debe saber qué tiene permitido cambiar, qué solo debe sugerir y qué no debe asumir nunca.
Los límites útiles incluyen:
-
No cambiar la intención original de ingeniería
-
No inventar valores, restricciones ni decisiones de diseño
-
No eliminar ID ni referencias
-
No asumir métodos de verificación faltantes
-
No aplicar cambios automáticamente sin revisión del usuario
-
No tratar información poco clara como si fuera un hecho
Los límites claros reducen el riesgo de generar resultados de ingeniería plausibles pero incorrectos.
-
-
Define the Output Format
Una skill debe indicarle a la IA cómo devolver el resultado.
Un formato de salida coherente hace que la skill sea más fácil de revisar, comparar y reutilizar.
Según la skill, la salida puede ser:
-
Una tabla
-
Una lista con viñetas
-
Un requisito reescrito
-
Un informe estructurado
-
Una lista de comprobación
-
Un resumen
-
Una lista de cambios propuestos
-
Un conjunto de preguntas o cuestiones abiertas
El formato de salida debe ajustarse al propósito de la skill. Por ejemplo, las skills orientadas a revisión suelen funcionar bien como tablas con columnas de problema, explicación y recomendación. Las skills orientadas a reescritura suelen funcionar bien cuando muestran el texto original, la salida propuesta y la justificación.
-
Localizado por IA