Corrigir erros de fluxos de trabalho com IA

Descrição

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 a partir do visualizador de Registo do projeto, já apontado para o passo que falhou. Também se abre a partir de um problema no separador Weave do projeto.

Abrir o assistente de correção

A partir do separador Registo do projeto, junto à entrada de registo em bruto:

Abra o projeto e clique no separador Registo.
Na lista de registo, selecione a entrada do passo que falhou. A mensagem completa — incluindo qualquer traceback — abre-se no painel à direita, no separador Mensagem de registo.
Mude esse painel para o separador AI Assistant.

O chat do AI Assistant 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 e conversar com o assistente em AI Assistant, lado a lado. Para alguns erros comuns, a primeira resposta é uma explicação — consulte Erros comuns.

A partir do separador Weave

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.

Como funciona

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.
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.
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.
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.
Oferece uma nova execução — um segundo cartão pergunta se pretende executar o passo de novo agora para confirmar a correção. Se a aprovar, o assistente executa o passo e diz-lhe se teve êxito, terminou com um aviso ou voltou a falhar; uma nova falha é um erro que depois diagnostica. Se o passo não terminar em dois minutos, 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.

Anular uma correção

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 repõe 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 Feito conforme aprovado: anular a alteração do Weave às definições de um passo.

Erros comuns

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ê
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 Extrair SQL:

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 que pode corrigir

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.

O que não faz

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.

Sugestões

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.