Engenharia 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 Engineering Assistant do Requirements Portal utiliza tecnologias de IA para fornecer a você uma ferramenta de revisão rápida e automatizada para seus requisitos, permitindo fazer perguntas sobre os requisitos do 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 depois aplicá-las ou descartá-las. 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 esquerdo) – 
.
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. A janela pop-up Chat Context será aberta, 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 são aplicados.
-
Rows selected – mostra o número de linhas de requisitos atualmente selecionadas.
Clique no botão para abrir a janela 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á mostrado na árvore do projeto ao lado das especificações, seções e pastas correspondentes.
Quando você envia ao Engineering Assistant uma solicitação para criar um novo requisito, ou alterar ou excluir um requisito existente, as alterações sugeridas serão mostradas em um bloco dedicado dentro do painel Engineering Assistant, onde você poderá revisá-las (expandindo a região recolhível Changes summary) e então aplicá-las ou descartá-las. 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 efetivas 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 listar 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 reafirmar 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.
-
O Engineering Assistant permite executar uma pesquisa em uma pasta específica.
-
Quando o serviço do Engineering Assistant não puder ser acessado ou produzir algum erro, uma mensagem de erro indicando a falha será exibida no painel. Clique no botão Retry para tentar novamente a última solicitação com falha.
-
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 AI Skills
A funcionalidade do Engineering Assistant foi atualizada com a capacidade de usar Skills. Uma skill é um conjunto reutilizável de instruções que o Engineering Assistant pode executar para realizar uma tarefa específica com mais consistência. Uma skill 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 skill 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 skills são invocadas automaticamente pela IA, que as seleciona e aplica automaticamente com base na sua intenção. Você não precisa memorizar comandos nem selecionar skills manualmente. Quando você envia uma mensagem, o Engineering Assistant:
-
Analisa sua intenção e o contexto atual.
-
Examina as skills disponíveis no Workspace.
-
Compara sua solicitação com a Short Description de cada skill para determinar quais skills são relevantes.
-
Seleciona a skill com a melhor correspondência.
-
Segue as Instructions da skill 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 skill cuja descrição curta melhor corresponde a essa solicitação, executa as instruções definidas nessa skill e retorna os requisitos aprimorados.
Skill Use Examples
-
Break Down Complex Requirements – analisar os requisitos selecionados e dividi-los em requisitos menores, testáveis de forma independente, 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 de redação de requisitos da sua organização. 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 Eletrônica, Mecânica, 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.
Um conjunto de competências disponíveis é gerenciado usando a janela AI Skills, acessada ao clicar no botão 
no canto superior direito do painel Engineering Assistant. Nessa janela, você pode adicionar novas competências, bem como alterar e excluir as existentes.
-
As competências existentes são listadas na área Workspace Skills no lado esquerdo da janela. Clique em uma entrada para exibir os detalhes da competência selecionada.
-
Para adicionar uma nova competência, clique no botão
no canto inferior esquerdo da janela. Uma entrada para uma nova competência aparecerá na lista. Defina Name, Short Description e Instructions para a nova competência e, em seguida, clique no botão 
no canto inferior direito.
Consulte a seção recolhível Práticas recomendadas para formular uma competência abaixo para obter detalhes sobre cada campo.
-
Para editar uma competência existente, selecione-a na lista, altere seus campos conforme necessário e, em seguida, clique no botão
no canto inferior direito.
-
Para excluir uma competência existente, selecione-a na lista, clique no botão
no canto inferior direito e, em seguida, confirme a exclusão.
As competências 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 esquerdo)
Best Practices for Formulating a Skill
Uma boa competência ajuda a IA a entender duas coisas:
-
Quando a competência deve ser usada
-
O que a IA deve fazer quando a competência é executada
Ao definir uma competência,
Isso é expresso por meio de três campos, em que cada campo tem uma finalidade diferente:
-
Name – ajuda você a reconhecer a competência.
-
Short Description – ajuda a IA a decidir quando a competência é relevante.
-
Instructions – define o comportamento que a IA deve seguir depois que a competência for selecionada.
Consulte as seções abaixo para obter detalhes sobre cada campo.
Nome
O Name deve ser curto, claro e orientado à ação. Ele deve ajudar você a entender rapidamente o que a competência se destina a fazer. Um bom nome normalmente descreve a ação e o tipo de dados de engenharia com os quais a competência trabalha.
Um nome forte para uma competência deve ser:
-
Específico o suficiente para distinguir a competência das demais
-
Curto o suficiente para ser facilmente identificado na lista de competências
-
Focado na principal tarefa que a competência executa
-
Escrito em uma linguagem que os usuários entendam naturalmente
Evite nomes amplos ou genéricos demais. 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 competência e quando ela deve ser acionada. Esse campo é importante porque você não precisa selecionar manualmente uma competência. O assistente analisa seu prompt, compara-o com as competências disponíveis e decide se uma competência é relevante.
Uma boa descrição curta deve explicar:
-
Que tarefa a competência executa
-
A que tipo de dados de engenharia ela se aplica
-
Quando a competência deve ser usada
-
Qual resultado se espera que a competência produza
A descrição curta deve ser concisa, mas não vaga. Ela deve incluir contexto suficiente para que a IA consiga distinguir essa competência de competências semelhantes.
Uma descrição curta fraca apenas informa a qual domínio a competência 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 competência como algo que "ajuda com requisitos", a descrição deve explicar se a competência 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 competência e o 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 competência for selecionada. Este é o campo mais importante para controlar o comportamento da competência. Enquanto a descrição curta ajuda a IA a decidir quando usar a competência, as instruções definem como a competência deve ser executada.
Boas instruções devem ser escritas como orientações claras, passo a passo. Elas não devem apenas descrever o resultado final, mas também o raciocínio e as restrições que a IA deve seguir ao produzir esse resultado.
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 o resultado 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 competências impedem explicitamente que a IA invente detalhes de engenharia ausentes, altere a intenção, introduza novas suposições ou aplique mudanças sem revisão do usuário.
-
How the AI should handle uncertainty – se as informações estiverem ausentes, ambíguas ou insuficientes, a competência deve instruir a IA a indicar claramente o problema em vez de adivinhar.
-
What output format is expected – a competência 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 o trabalho de engenharia porque o assistente pode estar lidando com dados que afetam especificações, validação, decisões de projeto ou implementação posterior. Portanto, a competência 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 competência deve executar bem uma tarefa repetível.
Se uma competência tentar fazer coisas demais, fica mais difícil para o assistente saber quando usá-la e mais difícil para os usuários confiarem no resultado. Por exemplo, uma competência 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 fluxo de trabalho único e rigidamente definido.
Se a finalidade da competência exigir várias ações não relacionadas, divida-a em competências separadas.
-
Define Boundaries Clearly
Boas competências deixam claros os 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 ele 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 mudanças automaticamente sem revisão do usuário
-
Não trate informações pouco claras como fato
Limites claros reduzem o risco de resultados de engenharia plausíveis, porém incorretos.
-
-
Define the Output Format
Uma competência deve dizer à IA como retornar o resultado.
Um formato de saída consistente torna a competência mais fácil de revisar, comparar e reutilizar.
Dependendo da competência, 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 mudanças propostas
-
Um conjunto de perguntas ou questões em aberto
O formato de saída deve corresponder à finalidade da competência. Por exemplo, competências orientadas à revisão geralmente funcionam bem como tabelas com colunas de problema, explicação e recomendação. Competências orientadas à reescrita geralmente funcionam bem quando mostram o texto original, a saída proposta e a justificativa.
-
Localizado por IA