Executar e depurar um cenário

Lançar

O botão de reprodução do editor. Está desativado enquanto houver erros de validação.

Se o cenário declarar parâmetros sem valor, o Restorm pede-os no momento em que a execução os alcança.

Seguir a execução

O registo de execução vai-se preenchendo em tempo real. Cada entrada tem um nível (debug, info, warn, error), uma marca temporal ao milissegundo, uma mensagem e, eventualmente, dados estruturados.

Dois níveis de detalhe:

• por predefinição, só são mostradas as suas próprias entradas — as produzidas pela ação Log;
• a visualização completa acrescenta as entradas do motor: início e fim de cada caixa, valores em trânsito nas ligações, erros.

O botão de cópia do registo produz exatamente o mesmo texto que a saída da linha de comandos: o que cola num ticket é idêntico ao que a CI vai produzir.

Histórico das execuções

As execuções são arquivadas ao lado do projeto, no mesmo ficheiro que o histórico das respostas. Por predefinição: as 50 últimas execuções, 2 000 entradas de registo por execução, com um tempo de vida de 30 minutos.

Parar

O botão de parar interrompe a execução. As esperas em curso (Aguardar, Aguardar até, Temporizador) são interrompidas de forma limpa, as ligações abertas são fechadas e as ações de código em curso são abandonadas.

Executar uma única caixa

As caixas do tipo pedido podem ser executadas isoladamente, sem lançar todo o cenário: é a maneira rápida de verificar que uma chamada parte bem antes de fazer as restantes ligações.

Depurar

O registo como primeiro reflexo

Acrescente ações Log nos pontos estratégicos: é o console.log do grafo e é o que vai encontrar na CI.

As notificações

A ação Toast mostra uma mensagem na interface. Útil durante a construção — sem efeito em modo headless, onde a execução continua normalmente.

O inspetor passo a passo

A edição Pro dá acesso à depuração passo a passo: pontos de interrupção nas caixas, avanço controlado, inspeção dos valores em trânsito. Ver Planos e capacidades.

Os erros

Toda a caixa (exceto Saída, Agora e Retry) tem uma porta error. Uma caixa que falha sem que a sua porta error esteja ligada faz falhar a execução.

Dois padrões úteis:

• Retry — envolve uma fronteira de erro: as falhas a jusante são apanhadas e relançadas segundo a estratégia configurada (fixa, linear, exponencial), com uma saída exhausted quando as tentativas se esgotam.
• Throw — falha deliberadamente, com uma mensagem. É o que é preciso para fazer falhar um job de CI numa condição de negócio.

Comandar por MCP

Um agente de IA pode lançar e vigiar um cenário (edição Pro): run_scenario (com params, interactive, blocking), get_scenario_run_status (que devolve o registo, os pedidos de introdução pendentes e a árvore das subexecuções), list_scenario_runs, stop_scenario_run e answer_scenario_input. Ver Ferramentas MCP.