Pular para o conteúdo

Corrigir erros de fluxos de trabalho com IA

Quando um passo de um fluxo de trabalho falha ou regista um aviso, o assistente de correção com IA lê esse erro, apura a causa e — quando a causa é uma configuração incorreta do próprio passo — propõe uma configuração corrigida e aplica-a depois de a aprovar. Vai além de explicar o erro: pode fazer a alteração por si.

Faz parte do Weave AI do PlaidCloud e abre-se no painel lateral do Weave, já apontado para o passo que falhou, a partir do visualizador de Registo do projeto, do editor de fluxos de trabalho e do separador Weave do projeto. Quando uma execução agendada falha, o Weave pode ter a correção à sua espera; consulte Uma correção à espera após uma execução falhada.

A partir do separador Registo do projeto:

  1. Abra o projeto e clique no separador Registo.
  2. Na lista de registo, selecione a entrada do passo que falhou. A mensagem completa — incluindo qualquer stack trace — abre-se no painel à direita, em Mensagem de registo.
  3. Clique em Corrigir por baixo da mensagem. Um erro ou aviso de um passo oferece Corrigir; as outras entradas oferecem Perguntar ao Weave. ⋯ ao lado tem Explicar e as outras ações do Weave.

O painel lateral abre-se já apontado para o fluxo de trabalho e o passo de onde veio a entrada de registo selecionada, pelo que começa a diagnosticar de imediato — não tem de lhe indicar qual o passo que falhou. Pode ler o erro em bruto em Mensagem de registo enquanto o assistente responde no painel lateral. Para alguns erros comuns, a primeira resposta é uma explicação — consulte Erros comuns.

Selecione um passo com um ponto vermelho na área de desenho. No Inspetor, o cartão Erro da última execução tem Corrigir junto ao título quando o assistente de correção está ativado, e Perguntar ao Weave caso contrário. Consulte Quando um passo falha.

Clique com o botão direito do rato no passo na área de desenho ou na lista de passos, ou na linha de erro do registo, e escolha Corrigir na secção Weave do menu. Corrigir é oferecido quando a última execução do passo falhou ou quando uma constatação o propõe, e nunca numa linha de aviso. O painel lateral do Weave abre-se nesse passo. Em Monitor ou no visualizador de Registo, Corrigir numa linha faz o mesmo.

No separador Weave do projeto, clique em Corrigir no cartão de um problema encontrado pelo Weave. O assistente abre-se numa janela própria, já apontado para o passo a que o problema diz respeito, e parte do problema tal como o Weave o comunica agora. Consulte Corrigir uma constatação com o assistente de IA para saber quais as constatações que oferecem Corrigir.

  1. Diagnostica — lê a configuração do passo que falhou e as tabelas e colunas em que toca, e verifica as suas afirmações com os seus dados em vez de adivinhar apenas a partir do texto do erro.
  2. Propõe — se encontrar uma configuração incorreta genuína, mostra a alteração num cartão: Why it failed numa frase e, a seguir, uma caixa para cada definição que muda, com o nome que tem no formulário do passo sempre que possível, com o valor atual a vermelho e o novo valor a verde. Só é listado o que muda — numa lista de colunas, apenas as colunas que mudam. Nada é guardado neste momento.
  3. Aprova — selecione Approve N changes no cartão, ou Agora não para deixar o passo como está. Responder pelas suas próprias palavras também funciona. Os botões ficam disponíveis quando o assistente terminar a resposta, e a sua aprovação vem sempre numa mensagem posterior à proposta.
  4. Aplica — depois de a aprovar, escreve a alteração no passo, através do mesmo caminho que o editor de passos usa. O que é guardado é a alteração do cartão, e uma aprovação guarda-a uma só vez. Imediatamente antes de guardar, mantém uma cópia das definições do passo tal como estão, para que possa anular a correção — consulte Anular uma correção.
  5. Volta a executar e confirma — no navegador, a mesma aprovação abrange a nova execução: o Weave volta a executar o passo corrigido com o lançamento no ERP desativado e diz-lhe se teve êxito, terminou com um aviso ou voltou a falhar, por exemplo Corrigido e executado de novo: Allocate by Driver teve êxito em 4 min, 46 812 linhas, dentro do intervalo habitual. Se não conseguir confirmar, diz porquê e nunca afirma que o passo está corrigido. Na aplicação móvel, um segundo cartão pergunta se pretende executar o passo de novo. Se o passo não terminar em dois minutos, o Weave indica-o, e o resultado aparece no fluxo de trabalho e no separador Registo.

O assistente não oferece uma nova execução para um passo que lança num sistema ERP ou executa outro fluxo de trabalho — execute-o de novo a partir do respetivo fluxo de trabalho, onde escolhe o modo de lançamento no ERP — nem quando o chat não está associado a um fluxo de trabalho, nem quando a sua função não pode executar fluxos de trabalho. Se o fluxo de trabalho já estiver em execução, nada é executado e o assistente oferece-se para tentar novamente.

Cada proposta, a sua aprovação ou rejeição e a própria alteração ficam registadas no histórico de atividade do Weave do projeto, com exatamente o que a alteração substituiu e escreveu. A sua aprovação é registada antes de a alteração ser feita. Se não puder ser registada, nada é guardado e o cartão indica-o, e pode aprová-la de novo mais tarde.

Uma correção à espera após uma execução falhada

Seção intitulada “Uma correção à espera após uma execução falhada”

Quando uma execução de um fluxo de trabalho iniciada por um agendamento ou por um sensor falha, o Weave analisa a falha de imediato e, quando possível, prepara a correção antes de alguém abrir o registo. Para uma execução que iniciou manualmente, prepara uma correção quando a causa é uma coluna de origem que mudou de nome.

A correção aguarda num cartão com o título da falha, como Month-End Close failed at Allocate by Driver. Indica porque é que a execução falhou, o que muda e o que volta a executar: Depois: executar de novo Month-End Close a partir de Allocate by Driver e, a seguir, Margin Report. O lançamento no ERP está desativado nestas execuções. Encontra-o:

  • na linha da execução falhada em Monitor → Descobertas, que se abre para mostrar o cartão;
  • na entrada de registo e na marca do passo na área de desenho;
  • no painel lateral, como uma linha Waiting for you.

O responsável do cartão é avisado no PlaidCloud, Month-End Close falhou. O Weave tem uma correção para rever., e no telemóvel, se usar a aplicação móvel. Clique em Apply and re-run para guardar a correção e executar de novo a partir do passo que falhou. Em seguida, o Weave diz se a execução teve êxito.

  • Qualquer pessoa cuja função possa editar o passo que falhou, e o responsável do cartão, podem aprová-la, na Web.
  • O Weave prepara um cartão para cada causa e não volta a analisar a mesma falha num passo inalterado depois de não ter encontrado correção ou de o cartão ter sido recusado.
  • Um passo que lança num ERP ou escreve fora do PlaidCloud não recebe cartão.

Quando o mesmo problema afeta vários passos, como uma coluna com novo nome usada em seis mapeamentos, o Weave propõe todas as alterações num único cartão, com uma secção numerada para cada uma, o que vai executar de novo e tudo o que não conseguiu incluir, como um passo que a sua função não pode editar. Um único Aprovar 6 changes aplica-as todas; depois, o Weave volta a executar uma vez cada passo corrigido, com o lançamento no ERP desativado, e diz se o problema desapareceu. Se um passo tiver sido alterado depois de o aprovar, o Weave não o aplica e para, indicando quantos foram aplicados. Um único Anular repõe todos os passos corrigidos. Se o Weave preparou o cartão enquanto estava ausente, este aguarda nessa conversa no painel lateral, numa linha Waiting for you que abre para aprovar; consulte Cartões à sua espera.

O cartão de uma correção indica quando a correção pode ser anulada: O Weave guarda uma cópia das definições atuais do passo, pelo que pode anular isto durante um período limitado, a não ser que o passo seja alterado novamente antes. Um cartão sem essa linha não pode ser anulado. Se o Weave não consegue manter a cópia, não guarda nada e di-lo, e pode voltar a pedir.

Depois de a correção ser guardada, o cartão mostra Anular. A entrada da correção no histórico de atividade do Weave do projeto tem o mesmo botão, pelo que pode anular uma correção depois de o respetivo chat estar fechado. Qualquer pessoa cuja função possa alterar passos no projeto pode anular uma correção, não apenas quem a aprovou.

Anular abre uma janela que mostra o que a anulação repõe: cada definição que a correção alterou, tal como está Atual e como ficará Depois de anular. Depois escolha:

  • Anular — repõe as definições do passo como estavam imediatamente antes da correção.
  • Anular e executar — repõe-nas e depois executa o passo. É oferecido quando a sua função pode executar fluxos de trabalho, o passo ainda está no fluxo de trabalho em que a correção foi feita (ou, na falta deste, em apenas um fluxo de trabalho) e pode abrir esse fluxo de trabalho, e o passo não lança num sistema ERP nem executa outro fluxo de trabalho. A própria execução não pode ser anulada.
  • Cancelar — deixa o passo como está.

A anulação altera apenas as definições do passo. Os dados que as execuções do passo já escreveram mantêm-se como estão: execute o passo de novo para os reconstruir.

O Weave não anula uma correção, e não altera nada, quando:

  • O passo foi alterado desde a correção. A anulação reporia definições desatualizadas, pelo que a janela mostra o passo tal como está Atual ao lado das suas definições Antes da alteração do Weave, e pode alterá-lo por si.
  • O passo já tem as definições que tinha antes da correção.
  • A cópia já não é mantida. As cópias são mantidas durante um período limitado.
  • A sua função não pode alterar o passo, ou o projeto está bloqueado.
  • O Weave não conseguiu registar a anulação. Tente novamente mais tarde.

Uma anulação é registada no histórico de atividade como uma alteração própria, como Efetuado conforme aprovado: anular a alteração do Weave às definições de um passo.

Quando um passo falha com um destes erros comuns, a primeira resposta é uma explicação que o PlaidCloud já tem para esse tipo de erro, pelo que aparece de imediato.

Em qualquer tipo de passo:

  • uma expressão que usa uma coluna que não existe na tabela que o passo lê
  • um mapeamento de colunas cuja coluna de origem não existe na tabela que o passo lê
  • um passo que parou antes de escrever o que quer que seja porque as respetivas tabelas de origem não correspondem às suas definições: uma coluna que utiliza ou uma chave de junção que uma tabela não tem, uma chave de junção que o passo não lista ou uma tabela de origem que não foi criada
  • uma definição de que o passo precisa e que foi deixada vazia, como a ligação que usa ou a tabela que lê
  • um fluxo de trabalho executado pelo passo que falhou — a causa está muito provavelmente num dos passos desse fluxo de trabalho, por isso verifique o registo desse fluxo de trabalho
  • uma tabela indicada pelo passo que não é encontrada
  • um armazém Snowflake ou Databricks que bloqueia o endereço do PlaidCloud, rejeita o seu início de sessão, esgotou a quota, não é encontrado ou não pode ser usado, ou não tem um privilégio de que a função do PlaidCloud precisa

Num passo SQL Extract:

  • SQL que não pode ser lido como foi escrito, como uma palavra-chave com erro ortográfico ou um parêntese que não está fechado
  • uma função que a base de dados não reconhece
  • uma tabela que não existe
  • uma função a que é dado um tipo de valor com que não consegue trabalhar, como somar uma coluna de texto (no Databend)
  • um valor que não pode ser convertido para o tipo pedido pelo SQL, como texto onde era esperado um número ou uma data (no Databend)

Num passo Table Extract, com correções que apontam para os separadores e campos do próprio passo e não para SQL:

  • uma tabela de origem que ainda não existe, ou que já não existe (no Databend)
  • uma expressão que usa uma função que a base de dados não reconhece (no Databend)
  • uma função a que é dado um tipo de valor com que não consegue trabalhar, como somar uma coluna de texto numa expressão ou com Resumir (no Databend)
  • um passo sem colunas de saída, como um cujas colunas foram todas removidas

A explicação diz o que costuma causar o erro, que palavras da mensagem de erro convém ver e como o corrigir. É geral: não verifica o seu passo nem altera nada. Para que o assistente analise o próprio passo, responda. A partir daí, funciona como descrito em Como funciona, com a explicação como parte da conversa.

Qualquer outro erro vai diretamente para o diagnóstico do próprio assistente. Isso inclui os erros de base de dados indicados acima quando provêm de qualquer outro tipo de passo.

O assistente repara a configuração do único passo de onde veio o erro — por exemplo, um nome de coluna ou de função mal escrito, uma expressão inválida, um tipo de dados ou conversão errados, ou SQL malformado. Altera o mínimo que corrige o erro: uma falha, uma alteração dirigida, ficando o resto da configuração como estava.

Uma expressão que falha — numa coluna, num filtro ou numa cláusula having — é entregue ao mesmo especialista em expressões que está ao lado do Editor de expressões, com o erro e as colunas da tabela de origem. A expressão corrigida que devolve é verificada antes de ser proposta, e a proposta continua a ser uma alteração a esse único campo do passo, aprovada da mesma forma que qualquer outra.

A sua única alavanca é a configuração desse passo, e é franco quando o problema está noutro lado, em vez de forçar uma edição para parecer uma solução.

  • Edita a configuração de um passo e nada mais — não cria, elimina nem reordena passos, não cria tabelas, não edita um passo diferente nem altera os seus dados.
  • Muitas falhas não são problemas de configuração: dados de origem em falta ou malformados, um passo anterior que falhou primeiro, um erro transitório ou de infraestrutura, um problema de permissões, Python com erros num UDF ou num passo de código do utilizador, um ficheiro em falta numa conta de documentos, ou um limite de recursos ou de tempo. Nestes casos, explica o que encontrou e indica onde está a verdadeira correção.
  • Os avisos são muitas vezes benignos e não precisam de alteração — dirá isso com clareza em vez de inventar uma edição.
  • Quando não tem a certeza de que uma alteração vai funcionar, di-lo e indica o que o deixa em dúvida, em vez de apresentar um palpite como uma certeza.
  • O diagnóstico baseia-se na configuração do passo e nos metadados das tabelas em tempo real, pelo que reflete o projeto tal como está agora — não uma forma em cache ou presumida.
  • Depois de uma correção ser aplicada, diga que sim quando o assistente se oferecer para executar o passo de novo, ou execute-o por si, para confirmar que o erro foi resolvido.
  • Se o assistente disser que a causa está fora da configuração do passo (dados incorretos, uma falha anterior, um problema de permissões), essa é a resposta — corrija-a onde realmente se encontra em vez de pedir ao assistente que edite o passo na mesma.