Sybot Forge

O Sybot Forge é o assistente contextual de conceção disponível no Designer de Projeto. Ajuda a compreender objetos existentes e, após autorização, pode executar as operações disponíveis nos editores de Portais, Vistas de Utilizador, Modelos Semânticos, Workflows e BPMN sem sair do Workbench.

Forge é um módulo opcional. O painel aparece apenas quando o administrador o ativa e a função do utilizador cumpre os requisitos de acesso.

Onde encontrar

1. Abra o Designer.
2. Abra um Projeto no Project Workspace.
3. Selecione o ícone Forge na barra de separadores.

O painel abre à direita na interface existente do Designer. Arraste o limite para o redimensionar, reduza-o a uma barra estreita e volte a abri-lo sem fechar os editores. Cada conversa pertence ao Projeto aberto.

Conversas e memória

Cada conversa conserva o histórico, os planos, os resultados e as autorizações. O menu do cabeçalho permite mudar de sessão, criar uma nova ou arquivar a sessão atual.

A sessão pode ser retomada depois de atualizar a página. Se uma atividade estiver em curso ou aguardar autorização, o seu estado é restaurado no painel. Se o worker for interrompido, Forge retoma os passos persistidos sem duplicar uma alteração já concluída.

Durante a sessão de edição no navegador, o Forge mantém uma conversa distinta para o Workbench e para cada objeto aberto. A primeira visita a um Workflow, Portal ou outro objeto cria um chat dedicado; ao regressar ao mesmo separador, o chat usado anteriormente é restaurado. A seleção manual de outra conversa no menu associa-a explicitamente ao objeto atual.

Seleção do contexto

Forge usa sempre o Projeto aberto como limite. Quando um separador de editor está ativo, o respetivo objeto aparece como contexto ativo. Assim, pode pedir:

• «Explica o que faz este Workflow.»
• «Verifica se esta Vista de Utilizador usa objetos externos ao Projeto.»
• «Prepara uma página inicial para este Portal.»

As alterações não guardadas são assinaladas. Quando o plano altera o objeto do separador ativo, Autorizar plano pede ao editor que conclua a gravação e muda o mesmo separador para apenas leitura antes da execução. A conversa continua associada ao objeto. Se o editor não conseguir guardar, a autorização não começa; se o objeto estiver aberto noutra janela ou sessão, guarde-o ou feche-o aí e repita o pedido.

Objetos suportados

Objeto	Assistência disponível
Workflow	Executar as operações do Workflow Designer, incluindo estrutura, tarefas, configurações, condições, pacotes, execuções, resultados e recursos.
BPMN	Executar as operações do BPMN Designer, incluindo modelo XML, variáveis, pacotes, deployment e execução.
Vista de Utilizador	Executar as operações do editor, incluindo páginas, widgets, fontes, consultas, versões, partilhas, pacotes e exportações.
Modelo Semântico	Executar as operações do editor, incluindo entidades, relações, medidas, consultas, atualizações, versões, partilhas e pacotes.
Working Dataset	Criar um armazenamento operacional tipado no Projeto, adicionar e consultar registos, calcular agregações e exportar CSV ou XLSX.
Portal	Executar as operações do editor, incluindo repositório, páginas, widgets, dados, acessos, pacotes, builds, releases, deployments e integrações suportadas.

As operações dependem das permissões do Projeto e da configuração administrativa.

Por exemplo, o Forge pode criar um Portal que recolhe dados com um formulário tipado, os guarda, apresenta numa tabela, calcula métricas para um gráfico e disponibiliza uma exportação. O plano é apresentado antes da execução; o servidor gere chaves, revisões, bindings e validações. Widgets ligados a dados, Workflows, Vistas de Utilizador, BPMN ou sistemas BI exigem configuração e validação específicas e não são criados como componentes autónomos incompletos.

Quando um novo rascunho requer uma Função, o Forge utiliza o nome da Função apresentado no produto e aplica a Função autorizada predefinida se o pedido não especificar nenhuma. Não solicita identificadores numéricos; os objetos que não utilizam Funções, como os Portais, não exigem esta escolha.

Processos de ponta a ponta

Forge traduz o objetivo num blueprint de artefactos e comportamentos e verifica se cada parte é coberta por uma ação disponível. Um único plano pode criar vários objetos Sybot e passar saídas tipadas de um passo para os seguintes.

Quando um pedido necessita de dados operacionais persistentes mas não indica uma fonte, Forge propõe o Working Dataset governado do Projeto. O respetivo contrato de dados é reutilizado para gerar e verificar formulário, tabela, agregações, gráfico e exportação. Se uma parte do resultado não for suportada, a Cobertura da solução identifica-a e o plano não é executado como se estivesse completo.

O mesmo plano pode ligar ao Portal uma Vista de Utilizador já publicada, um dos seus widgets, um Workflow executável ou um BPMN implantado. Forge seleciona apenas objetos autorizados do mesmo Projeto e fixa no binding a versão disponível; publicação e implantação continuam a ser operações separadas.

Conhecimento do Projeto

Forge pode combinar:

• o inventário e as definições dos objetos pertencentes ao Projeto;
• o objeto aberto no separador ativo;
• a conversa atual;
• a documentação pública do Sybot;
• as collections LightHouse associadas ao Projeto, quando disponíveis.

As respostas distinguem a informação encontrada nos objetos e na documentação das propostas geradas. O Forge só pede esclarecimentos quando uma escolha funcional é realmente necessária e formula uma pergunta compreensível. Se a escolha já estiver presente no pedido ou na conversa, é reutilizada sem voltar a ser perguntada. Os identificadores, as revisões e as omissões do plano são resolvidos internamente ou fazem com que o turno seja novamente planeado; não são solicitados ao utilizador.

As respostas do assistente suportam Markdown: títulos, listas, tabelas, ligações e blocos de código são formatados diretamente no painel. O conteúdo é higienizado antes da apresentação. A notação matemática comum é apresentada com símbolos Unicode; por exemplo, uma seta de fluxo é renderizada como →, sem mostrar delimitadores LaTeX.

Forge responde no idioma do pedido atual. Num seguimento curto ou ambíguo, mantém o idioma da conversa e, quando não o consegue determinar, utiliza o idioma da interface. Pode solicitar explicitamente outro idioma de resposta.

Planos e autorizações

Um pedido pode exigir vários passos. As análises só de leitura são executadas diretamente. Antes de criar ou alterar algo, Forge apresenta um plano com o objeto, a ação e o motivo.

Enquanto o Forge trabalha, Progresso operacional mostra as fases observáveis: receção do pedido, recolha do contexto, análise do objetivo e das dependências, compilação do plano, aprovação ou execução e validação do resultado. Não é uma transcrição do raciocínio interno do modelo, mas o estado real do turno.

Se o Forge receber uma solução incompleta ou incompatível com as operações disponíveis, tenta corrigi-la antes da aprovação. Um detalhe técnico em falta não é transformado numa pergunta ao utilizador. Se o plano continuar sem poder ser verificado, o Forge indica o passo interrompido, a causa, o impacto e a ação necessária; nenhum objeto é criado ou alterado.

O seletor Aprovação aplica-se à conversa atual. A predefinição é Pedir aprovação. Quando o administrador disponibiliza a Aprovação automática, pode ativá-la explicitamente para os turnos seguintes: o Forge executa sem confirmação apenas as ações declaradas elegíveis. Os planos com ações não elegíveis ou alterações ao objeto aberto continuam a exigir aprovação manual.

• Autorizar plano executa exatamente os passos apresentados.
• Rejeitar termina sem aplicar alterações.
• Cancelar solicita a interrupção de um turno em curso.

O modo selecionado não amplia as permissões do utilizador. ACL, pertença ao Projeto, revisões, registos de auditoria e contratos dos editores continuam aplicados. Operações de alto impacto, como eliminação, publicação, deployment ou alterações de acesso, permanecem separadas e exigem a aprovação prevista no plano.

Após uma alteração bem-sucedida, o separador de apenas leitura é atualizado com o resultado. Para continuar a editar manualmente, reabra o objeto em modo de edição no Designer.

Procedimento recomendado

1. Abra o Projeto e, se for útil, o objeto de destino.
2. Descreva o objetivo e as restrições.
3. Verifique o contexto indicado no painel.
4. Reveja o plano e as ações de alteração.
5. Autorize apenas se corresponder à sua intenção.
6. Abra os objetos criados ou alterados a partir da mensagem final e valide-os no respetivo editor.

Resolução de problemas

• O painel não aparece: abra um Projeto e confirme com o administrador a ativação do módulo e da sua função.
• Forge não consegue preparar o separador: corrija ou guarde as alterações indicadas pelo editor e selecione novamente Autorizar plano.
• O objeto está aberto noutra sessão: guarde ou feche o respetivo separador na outra janela ou sessão e repita o pedido.
• Alteração recusada: verifique a função no Projeto e as permissões do objeto.
• O turno não termina: consulte o passo interrompido, a causa e a ação necessária apresentados no painel; contacte o administrador apenas se o diagnóstico identificar um problema da plataforma.
• Resposta insuficiente: indique o objeto, o resultado esperado e as restrições e abra o respetivo separador.