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. Requirements Portal's Engineering Assistant aprovecha tecnologías de IA para ofrecerle una herramienta de revisión rápida y automatizada para sus requisitos, que le permite hacer preguntas sobre los requisitos de su proyecto actual en lenguaje natural y de forma 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 uno 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 estas 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 – AI Settings (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 Settings en la lista del panel izquierdo) – 
.
Se accede al Engineering Assistant mediante el panel Engineering Assistant, disponible en el Requirement Module al hacer 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 mostrará 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 actualmente seleccionadas.
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 presione Enter. El Engineering Assistant analizará los requisitos y mostrará 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 anteriormente 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 las indicaciones enviadas anteriormente usando las teclas
Arrow UpyArrow Downcuando el cursor esté dentro del campo de texto. -
Puede expresar su grado de satisfacción con las respuestas del Engineering Assistant. Use los iconos
y 
debajo de una respuesta en el panel Engineering Assistant para proporcionar una reacción positiva o negativa.
Cuando envíe una solicitud al Engineering Assistant para crear un nuevo requisito, o cambiar o eliminar uno 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. También se muestra una burbuja verde junto a la entrada correspondiente en el árbol del proyecto de la izquierda.
-
Los requisitos modificados se resaltan en morado, con el icono
en la columna Identifier. Los cambios reales se resaltan en la tabla. También se muestra una burbuja morada junto a la entrada correspondiente en el árbol del proyecto de la izquierda.
-
Los requisitos sugeridos para eliminación se resaltan en rojo, con el icono
en la columna Identifier. También se muestra una burbuja roja junto a la entrada correspondiente en el árbol del proyecto de la izquierda.
-
El Engineering Assistant admite diálogo 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 anteriormente y responde en consecuencia. De este modo, puede mantener una “conversación” refinando o profundizando en la información sin volver a indicar el contexto.
-
El Engineering Assistant también puede agregar, mover, cambiar el nombre y eliminar carpetas, especificaciones y secciones dentro del árbol de requisitos. En este caso, los cambios se resaltarán en el árbol (
, 
, 
).
-
Al acceder por primera vez al panel Engineering Assistant (o después de iniciar una nueva conversación), se presentarán en el panel varios ejemplos de consultas (
). Si la especificación seleccionada actualmente no contiene requisitos, se le sugerirá crear primero los requisitos (
). Haga clic en el botón correspondiente para aplicar una consulta/acción.
-
Hay varias acciones predefinidas disponibles en el submenú Assistant del menú de acciones (
) de los requisitos seleccionados. Seleccione una acción en el submenú para abrir el panel Engineering Assistant con una indicación correspondiente (
).
-
Al visualizar una especificación sin requisitos, al hacer clic en el botón Generate se abre el panel Engineering Assistant con una indicación para guiarle durante el proceso de definición de requisitos (
).
-
El Engineering Assistant le permite realizar una búsqueda en una carpeta específica.
-
Cuando no se pueda acceder al servicio Engineering Assistant o se produzca algún error, se mostrará en el panel un mensaje indicando el fallo. Haga clic en el botón Retry para reintentar 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 hay historial de conversaciones).
Uso y administración de habilidades de IA
Una habilidad es un conjunto reutilizable de instrucciones que el Engineering Assistant puede ejecutar para realizar una tarea específica con mayor coherencia. Una habilidad empaqueta cómo debe realizarse una tarea de ingeniería concreta —la intención, los límites, las entradas necesarias y los pasos a seguir— para que el mismo resultado se produzca de manera consistente, independientemente de quién la ejecute o de cuándo se ejecute, y sin que cada usuario tenga que explicar las mismas instrucciones cada vez.
Una habilidad puede considerarse como:
-
Un flujo de trabajo de ingeniería repetible
-
Un estándar organizacional hecho ejecutable
-
Una forma de encapsular experiencia y hacerla reutilizable
Las habilidades son invocadas automáticamente por la IA, que las selecciona y aplica automáticamente según su intención. No necesita memorizar comandos ni seleccionar habilidades manualmente. Cuando envía un mensaje, el Engineering Assistant:
-
Analiza su intención y el contexto actual.
-
Revisa las habilidades disponibles en el Workspace.
-
Compara su solicitud con la Short Description de cada habilidad para determinar cuáles son relevantes.
-
Selecciona la habilidad que mejor coincide.
-
Sigue las Instructions de la habilidad 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 habilidad cuya descripción breve mejor coincide con esa solicitud, ejecuta las instrucciones definidas en esa habilidad y devuelve los requisitos mejorados.
Skill Use Examples
-
Break Down Complex Requirements – analizar los requisitos seleccionados y dividirlos en requisitos más pequeños e independientemente verificables, preservando la intención original.
Ejemplo de indicación:
Break down these requirements. -
Apply Requirement Writing Standards – revisar requisitos y reescribirlos de acuerdo con las directrices de su organización para redacción de requisitos. Las comprobaciones típicas incluyen ambigüedad, lenguaje no verificable, actores ausentes y criterios de aceptación poco claros.
Ejemplo de indicación:
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 indicación:
Translate these requirements to German. -
Classify Requirements – aplicar a los requisitos un esquema de clasificación organizacional, como Electrónica, Mecánica, Software, Seguridad funcional, Ciberseguridad u otras taxonomías específicas de la empresa.
Ejemplo de indicación:
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 usarse para demostrar la conformidad siempre de la misma manera.
Ejemplo de indicación:
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 indicación:
Summarize the selected requirements.
Cuando el Engineering Assistant procese su solicitud basándose en una habilidad, la habilidad 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 habilidad correspondiente resaltada.
El conjunto de habilidades 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 habilidades y cambiar o eliminar las existentes.
-
Las habilidades existentes se muestran en la región Workspace Skills del lado izquierdo de la ventana. Haga clic en una entrada para mostrar los detalles de la habilidad seleccionada.
-
Para agregar una nueva habilidad, haga clic en el botón
en la parte inferior izquierda de la ventana. Aparecerá en la lista una entrada para una nueva habilidad. Defina Name, Short Description y Instructions para la nueva habilidad y, a continuación, haga clic en el botón 
en la parte inferior derecha.
Consulte la sección contraíble Best Practices for Formulating a Skill a continuación para obtener detalles sobre cada campo.
-
Para editar una habilidad 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 habilidad 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 habilidades también pueden administrarse en la página Settings – AI Skills (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 habilidad ayuda a la IA a entender dos cosas:
-
Cuándo debe usarse la habilidad
-
Qué debe hacer la IA cuando se ejecuta la habilidad
Cuando define una habilidad,
Esto se expresa mediante tres campos, donde cada campo tiene un propósito diferente:
-
Name – le ayuda a reconocer la habilidad.
-
Short Description – ayuda a la IA a decidir cuándo la habilidad es relevante.
-
Instructions – definen el comportamiento que la IA debe seguir una vez seleccionada la habilidad.
Consulte las secciones a continuación 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é pretende hacer la habilidad. Un buen nombre suele describir la acción y el tipo de datos de ingeniería con los que trabaja la habilidad.
Un nombre de habilidad sólido debe ser:
-
Lo bastante específico para distinguir la habilidad de otras
-
Lo bastante breve para poder revisarlo fácilmente en la lista de habilidades
-
Enfocado en la tarea principal que realiza la habilidad
-
Redactado en un lenguaje que los usuarios entiendan de forma natural
Evite nombres demasiado amplios o genéricos. Si el nombre pudiera aplicarse a muchas tareas diferentes, probablemente no sea lo bastante específico.
Descripción breve
La Short Description ayuda a la IA a entender de qué trata la habilidad y cuándo debe activarse. Este campo es importante porque no necesita seleccionar manualmente una habilidad. El asistente analiza su indicación, la compara con las habilidades disponibles y decide si una habilidad es relevante.
Una buena descripción breve debe explicar:
-
Qué tarea realiza la habilidad
-
A qué tipo de datos de ingeniería se aplica
-
Cuándo debe usarse la habilidad
-
Qué resultado se espera que produzca la habilidad
La descripción breve debe ser concisa, pero no vaga. Debe incluir suficiente contexto para que la IA distinga esta habilidad de otras similares.
Una descripción breve débil solo indica a qué dominio pertenece la habilidad. 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 habilidad como algo que “ayuda con requisitos”, la descripción debe explicar si la habilidad 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 habilidad y su contexto de uso, con más fiabilidad podrá el asistente decidir cuándo aplicarla.
Instrucciones
Las Instructions definen lo que la IA debe hacer una vez que la habilidad ha sido seleccionada. Este es el campo más importante para controlar el comportamiento de la habilidad. Mientras que la descripción breve ayuda a la IA a decidir cuándo usar la habilidad, las instrucciones definen cómo debe ejecutarse.
Las buenas instrucciones deben redactarse como una guía clara, paso a paso. No solo deben describir el resultado final, sino también el razonamiento y las restricciones que la IA debe seguir mientras produce ese resultado.
Las instrucciones deben explicar:
-
What the AI should analyze first – el asistente normalmente 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, para 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 habilidades 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 habilidad debe indicar a la IA que exponga claramente el problema en lugar de adivinar.
-
What output format is expected – la habilidad 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 especificaciones, validación, decisiones de diseño o implementación posterior. Por lo tanto, la habilidad debe guiar a la IA para que sea útil sin mostrarse excesivamente segura.
Otras notas
-
El objetivo no es escribir una indicación larga. El objetivo es definir un procedimiento operativo claro para la IA.
-
Keep Skills Focused
Una habilidad debe realizar bien una tarea repetible.
Si una habilidad 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 sola habilidad no debe 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 parte intencionalmente de un flujo de trabajo único y estrechamente definido.
Si el propósito de la habilidad requiere múltiples acciones no relacionadas, divídala en habilidades separadas.
-
Define Boundaries Clearly
Las buenas habilidades son explícitas respecto a los límites.
Esto es especialmente importante cuando se trabaja con requisitos, especificaciones y datos de ingeniería. El asistente debe saber qué tiene permitido cambiar, qué solo debe sugerir y qué nunca debe asumir.
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 habilidad debe indicar a la IA cómo devolver el resultado.
Un formato de salida coherente hace que la habilidad sea más fácil de revisar, comparar y reutilizar.
Según la habilidad, 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 corresponderse con el propósito de la habilidad. Por ejemplo, las habilidades orientadas a revisión suelen funcionar bien como tablas con columnas de problema, explicación y recomendación. Las habilidades orientadas a reescritura suelen funcionar bien cuando muestran el texto original, la propuesta de salida y la justificación.
-
Localizado por IA