Engenharia de Requisitos Agêntica
Os agentes de IA oferecem vantagens substanciais para tarefas de engenharia, como a captura de requisitos, ao aumentar significativamente a eficiência e automatizar fluxos de trabalho complexos e repetitivos. O Requirements PortalEngineering Assistant aproveita tecnologias de IA para fornecer a você uma ferramenta rápida e automatizada de revisão dos seus requisitos, permitindo fazer perguntas sobre os requisitos no seu projeto atual em linguagem natural e livre e obter respostas rápidas sem precisar filtrar ou pesquisar manualmente pelos requisitos, por exemplo:
-
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.
O Engineering Assistant também é capaz de modificar, criar ou excluir requisitos. Quando você envia uma solicitação para criar um novo requisito, ou alterar ou excluir um requisito existente, o Engineering Assistant fornece um resumo das alterações a serem aplicadas, e você pode revisá-las e então aplicar ou descartar as alterações. Exemplos dessas solicitações:
-
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.
O Engineering Assistant vem habilitado por padrão. Se necessário, ele pode ser desabilitado por um administrador do Workspace usando a opção External Provider na página Settings – ValiAssistant (acessada clicando no ícone 
no canto superior direito, selecionando Settings no menu exibido e, em seguida, selecionando ValiAssistant na lista do painel à esquerda) – 
.
O Engineering Assistant é acessado pelo painel Engineering Assistant disponível no Requirement Module, clicando no ícone 
no canto superior direito.
Você pode ver o contexto atual do chat clicando no botão 
na parte inferior do painel Engineering Assistant. O pop-up Chat Context será aberto, apresentando as seguintes informações:
-
Project – mostra o nome do projeto atual e o nome da pasta, especificação ou seção atualmente selecionada.
-
Filters – mostra o número de filtros atualmente aplicados à tabela e a lista de colunas às quais os filtros estão aplicados.
-
Rows selected – mostra o número de linhas de requisitos atualmente selecionadas.
Clique no botão para abrir o pop-up Chat Context. Neste exemplo, a região Project mostra o nome do projeto atual (Drone_Example_Project) e o nome da especificação atualmente selecionada (Drone_Requirements).
Para usar o Engineering Assistant, digite sua consulta no campo Ask anything na parte inferior do painel Engineering Assistant e clique no ícone 
ou pressione Enter. O Engineering Assistant analisará os requisitos e apresentará uma resposta relevante no painel. Dependendo da consulta, o Engineering Assistant retornará uma resposta numérica, uma lista de IDs de requisitos ou um breve resumo. O(s) requisito(s) relacionado(s) à consulta será(ão) destacado(s) na tabela de requisitos, e o número de requisitos relacionados será exibido na árvore do projeto ao lado das especificações, seções e pastas correspondentes.
-
Você pode copiar sua solicitação enviada anteriormente ou uma resposta do Engineering Assistant. Clique no botão
abaixo de uma solicitação ou resposta para copiar seu conteúdo para a área de transferência.
-
Você pode percorrer os prompts enviados anteriormente usando as teclas
Arrow UpeArrow Downquando o cursor estiver dentro do campo de texto. -
Você pode expressar sua satisfação com as respostas do Engineering Assistant. Use os ícones
e 
abaixo de uma resposta no painel Engineering Assistant para fornecer uma reação positiva ou negativa a ela.
Quando você envia uma solicitação ao Engineering Assistant para criar um novo requisito, ou alterar ou excluir um requisito existente, as alterações sugeridas serão mostradas em um bloco dedicado no painel Engineering Assistant, onde você poderá revisá-las (expandindo a região recolhível Changes summary) e então aplicar ou descartar as alterações. Além disso, as alterações sugeridas ficarão visíveis na tabela de requisitos da seguinte forma:
-
Novos requisitos são destacados em verde, com o ícone na coluna Identifier
.
-
Requisitos alterados são destacados em roxo, com o ícone
na coluna Identifier. As alterações reais também são destacadas na tabela.
-
Requisitos sugeridos para remoção são destacados em vermelho, com o ícone
na coluna Identifier.
-
O Engineering Assistant oferece suporte a diálogo de múltiplas interações dentro de uma sessão, ou seja, ele lembra o contexto da conversa atual para consultas de acompanhamento relevantes. Por exemplo, se o Engineering Assistant listou vários requisitos em resposta a uma consulta e você então perguntar How many of those are high priority?, o assistente entende que those se refere aos requisitos listados anteriormente e responde de acordo. Dessa forma, você pode manter uma “conversa”, refinando ou aprofundando as informações sem precisar restabelecer o contexto.
-
No primeiro acesso ao painel Engineering Assistant (ou após iniciar uma nova conversa), vários exemplos de consulta serão apresentados no painel (
). Se a especificação atualmente selecionada não contiver requisitos, será sugerido que você crie requisitos primeiro (
). Clique no botão correspondente para aplicar uma consulta/ação.
-
Há várias ações predefinidas disponíveis no submenu Assistant do menu de ações (
) do(s) requisito(s) selecionado(s). Selecione uma ação no submenu para abrir o painel Engineering Assistant com um prompt correspondente (
).
-
Ao visualizar uma especificação sem requisitos, clicar no botão Generate abre o painel Engineering Assistant com um prompt para orientar você no processo de definição de requisitos (
).
-
O Engineering Assistant permite realizar uma pesquisa em uma pasta específica.
-
Quando o serviço do Engineering Assistant não puder ser alcançado ou produzir algum erro, será exibido no painel um erro indicando a falha. Clique no botão Retry para tentar novamente a última solicitação que falhou.
-
Para limpar a conversa atual e iniciar uma nova, clique no ícone
na parte inferior do painel Engineering Assistant. Observe que apenas uma conversa por vez está disponível (ou seja, não há histórico de conversas).
Uso e gerenciamento de habilidades de IA
Uma habilidade é um conjunto reutilizável de instruções que o Engineering Assistant pode executar para realizar uma tarefa específica com mais consistência. Uma habilidade encapsula como uma tarefa específica de engenharia deve ser realizada – a intenção, os limites, as entradas necessárias, as etapas a seguir – para que o mesmo resultado seja produzido de forma consistente, independentemente de quem a execute ou de quando, sem que cada usuário precise explicar as mesmas instruções todas as vezes.
Uma habilidade pode ser tratada como:
-
Um fluxo de trabalho de engenharia repetível
-
Um padrão organizacional tornado executável
-
Uma forma de empacotar conhecimento especializado e torná-lo reutilizável
As habilidades são invocadas automaticamente pela IA, que as seleciona e aplica com base na sua intenção. Você não precisa memorizar comandos nem selecionar habilidades manualmente. Quando você envia uma mensagem, o Engineering Assistant:
-
Analisa sua intenção e o contexto atual.
-
Examina as habilidades disponíveis no Workspace.
-
Compara sua solicitação com a Short Description de cada habilidade para determinar quais habilidades são relevantes.
-
Seleciona a habilidade com melhor correspondência.
-
Segue as Instructions da habilidade para executar a tarefa.
-
Retorna o resultado para sua revisão.
Por exemplo, quando você envia Rewrite these requirements using our company writing standard, o Engineering Assistant detecta a intenção (padronização de requisitos), identifica a habilidade cuja descrição curta melhor corresponde a essa solicitação, executa as instruções definidas nessa habilidade e retorna os requisitos aprimorados.
Skill Use Examples
-
Break Down Complex Requirements – analisar os requisitos selecionados e dividi-los em requisitos menores, independentemente testáveis, preservando a intenção original.
Exemplo de prompt:
Break down these requirements. -
Apply Requirement Writing Standards – revisar requisitos e reescrevê-los de acordo com as diretrizes da sua organização para redação de requisitos. As verificações típicas incluem ambiguidade, linguagem não verificável, atores ausentes e critérios de aceitação pouco claros.
Exemplo de prompt:
Rewrite these requirements according to our requirement quality standard. -
Translate Requirements – traduzir requisitos de um idioma para outro, preservando o significado técnico, a terminologia, os IDs e as referências de rastreabilidade.
Exemplo de prompt:
Translate these requirements to German. -
Classify Requirements – aplicar aos requisitos um esquema de classificação organizacional, como Electronics, Mechanical, Software, Safety, Security ou outras taxonomias específicas da empresa.
Exemplo de prompt:
Classify these requirements according to our applicability model. -
Generate Verification Criteria – analisar requisitos e propor métodos de verificação, critérios de aceitação ou condições de teste que possam ser usados para demonstrar conformidade sempre da mesma forma.
Exemplo de prompt:
Generate verification criteria for these requirements. -
Summarize a Specification/Section/Group of Requirements – gerar um resumo conciso e estruturado de uma especificação, seção de requisitos ou conjunto de requisitos.
Exemplo de prompt:
Summarize the selected requirements.
Quando o Engineering Assistant processa sua solicitação com base em uma habilidade, a habilidade usada será mostrada na região recolhível Check what I looked for no painel Engineering Assistant. Clique no link para abrir a janela AI Skills com a habilidade correspondente destacada.
Um conjunto de habilidades disponíveis é gerenciado usando a janela AI Skills, acessada clicando no botão 
no canto superior direito do painel Engineering Assistant. Nessa janela, você pode adicionar novas habilidades, bem como alterar e excluir habilidades existentes.
-
As habilidades existentes são listadas na região Workspace Skills no lado esquerdo da janela. Clique em uma entrada para mostrar os detalhes da habilidade selecionada.
-
Para adicionar uma nova habilidade, clique no botão
na parte inferior esquerda da janela. Uma entrada para uma nova habilidade aparecerá na lista. Defina Name, Short Description e Instructions para a nova habilidade e então clique no botão 
na parte inferior direita.
Consulte a seção recolhível Best Practices for Formulating a Skill abaixo para obter detalhes sobre cada campo.
-
Para editar uma habilidade existente, selecione-a na lista, altere seus campos conforme necessário e então clique no botão
na parte inferior direita.
-
Para excluir uma habilidade existente, selecione-a na lista, clique no botão
na parte inferior direita e então confirme a exclusão.
As habilidades também podem ser gerenciadas na página Settings – AI Skills (acessada clicando no ícone 
no canto superior direito, selecionando Settings no menu exibido e, em seguida, selecionando AI Skills na lista do painel à esquerda)
Best Practices for Formulating a Skill
Uma boa habilidade ajuda a IA a entender duas coisas:
-
Quando a habilidade deve ser usada
-
O que a IA deve fazer quando a habilidade for executada
Ao definir uma habilidade,
Isso é expresso por meio de três campos, cada um com uma finalidade diferente:
-
Name – ajuda você a reconhecer a habilidade.
-
Short Description – ajuda a IA a decidir quando a habilidade é relevante.
-
Instructions – definem o comportamento que a IA deve seguir depois que a habilidade for selecionada.
Consulte as seções abaixo para obter detalhes sobre cada campo.
Nome
O Name deve ser curto, claro e orientado para a ação. Ele deve ajudar você a entender rapidamente o que a habilidade se destina a fazer. Um bom nome geralmente descreve a ação e o tipo de dado de engenharia com o qual a habilidade trabalha.
Um nome de habilidade forte deve ser:
-
Específico o suficiente para distinguir a habilidade das outras
-
Curto o suficiente para ser facilmente identificado na lista de habilidades
-
Focado na tarefa principal que a habilidade executa
-
Escrito em uma linguagem que os usuários entendam naturalmente
Evite nomes muito amplos ou genéricos. Se o nome puder se aplicar a muitas tarefas diferentes, provavelmente ele não é específico o suficiente.
Descrição curta
A Short Description ajuda a IA a entender do que se trata a habilidade e quando ela deve ser acionada. Esse campo é importante porque você não precisa selecionar manualmente uma habilidade. O assistente analisa seu prompt, compara-o com as habilidades disponíveis e decide se uma habilidade é relevante.
Uma boa descrição curta deve explicar:
-
Que tarefa a habilidade executa
-
A que tipo de dado de engenharia ela se aplica
-
Quando a habilidade deve ser usada
-
Que resultado se espera que a habilidade produza
A descrição curta deve ser concisa, mas não vaga. Ela deve incluir contexto suficiente para que a IA diferencie essa habilidade de habilidades semelhantes.
Uma descrição curta fraca apenas diz a qual domínio a habilidade pertence. Uma descrição curta forte explica a tarefa específica, o contexto esperado e a situação de acionamento. Por exemplo, em vez de descrever uma habilidade como algo que “ajuda com requisitos”, a descrição deve explicar se a habilidade revisa a qualidade dos requisitos, decompõe requisitos complexos, traduz texto de requisitos, detecta conflitos, gera critérios de verificação ou executa outra ação específica.
Quanto melhor a descrição curta explicar a finalidade da habilidade e seu contexto de uso, com mais confiabilidade o assistente poderá decidir quando aplicá-la.
Instruções
As Instructions definem o que a IA deve fazer depois que a habilidade for selecionada. Este é o campo mais importante para controlar o comportamento da habilidade. Enquanto a descrição curta ajuda a IA a decidir quando usar a habilidade, as instruções definem como a habilidade deve ser executada.
Boas instruções devem ser redigidas como orientações claras, passo a passo. Elas não devem apenas descrever a saída final, mas também o raciocínio e as restrições que a IA deve seguir ao produzir essa saída.
As instruções devem explicar:
-
What the AI should analyze first – o assistente normalmente deve entender a intenção de engenharia, o contexto, a estrutura ou os relacionamentos antes de alterar ou gerar qualquer coisa.
-
What steps the AI should perform – o comportamento deve ser dividido em etapas explícitas, para que a saída seja repetível e previsível.
-
What the AI should preserve – isso pode incluir a intenção original, IDs de requisitos, termos técnicos, unidades, valores, restrições, referências, aplicabilidade, hierarquia ou contexto de rastreabilidade.
-
What the AI must not do – boas habilidades impedem explicitamente que a IA invente detalhes de engenharia ausentes, altere a intenção, introduza novas suposições ou aplique alterações sem revisão do usuário.
-
How the AI should handle uncertainty – se as informações estiverem ausentes, ambíguas ou insuficientes, a habilidade deve instruir a IA a declarar claramente o problema em vez de adivinhar.
-
What output format is expected – a habilidade deve definir se o resultado deve ser uma tabela, lista com marcadores, texto reescrito, resumo, checklist ou relatório estruturado.
Boas instruções são especialmente importantes para trabalho de engenharia porque o assistente pode estar trabalhando com dados que afetam especificações, validação, decisões de projeto ou implementação posterior. Portanto, a habilidade deve orientar a IA a ser útil sem ser excessivamente confiante.
Outras observações
-
O objetivo não é escrever um prompt longo. O objetivo é definir um procedimento operacional claro para a IA.
-
Keep Skills Focused
Uma habilidade deve executar bem uma tarefa repetível.
Se uma habilidade tentar fazer coisas demais, ficará mais difícil para o assistente saber quando usá-la e mais difícil para os usuários confiarem na saída. Por exemplo, uma única habilidade não deve combinar decomposição de requisitos, tradução, revisão de qualidade, análise de rastreabilidade e geração de verificação, a menos que essas ações façam intencionalmente parte de um único fluxo de trabalho rigidamente definido.
Se a finalidade da habilidade exigir várias ações não relacionadas, divida-a em habilidades separadas.
-
Define Boundaries Clearly
Boas habilidades são explícitas quanto aos limites.
Isso é especialmente importante ao trabalhar com requisitos, especificações e dados de engenharia. O assistente deve saber o que ele tem permissão para alterar, o que deve apenas sugerir e o que nunca deve presumir.
Limites úteis incluem:
-
Não altere a intenção original de engenharia
-
Não invente valores, restrições ou decisões de projeto
-
Não remova IDs ou referências
-
Não presuma métodos de verificação ausentes
-
Não aplique alterações automaticamente sem revisão do usuário
-
Não trate informações pouco claras como fatos
Limites claros reduzem o risco de gerar saídas de engenharia plausíveis, porém incorretas.
-
-
Define the Output Format
Uma habilidade deve dizer à IA como retornar o resultado.
Um formato de saída consistente torna a habilidade mais fácil de revisar, comparar e reutilizar.
Dependendo da habilidade, a saída pode ser:
-
Uma tabela
-
Uma lista com marcadores
-
Um requisito reescrito
-
Um relatório estruturado
-
Um checklist
-
Um resumo
-
Uma lista de alterações propostas
-
Um conjunto de perguntas ou questões em aberto
O formato de saída deve corresponder à finalidade da habilidade. Por exemplo, habilidades orientadas à revisão geralmente funcionam bem como tabelas com colunas de problema, explicação e recomendação. Habilidades orientadas à reescrita geralmente funcionam bem quando mostram o texto original, a saída proposta e a justificativa.
-
Localizado por IA