Corrigindo erros de fluxo de trabalho com IA

Descrição

Quando uma etapa de fluxo de trabalho falha ou registra um aviso, o assistente de correção por IA lê esse erro, descobre o que o causou e, quando a causa é uma configuração incorreta da própria etapa, propõe uma configuração corrigida e a aplica assim que você aprova. Ele vai além de explicar o erro: pode fazer a alteração por você.

Ele faz parte do Weave AI do PlaidCloud e abre a partir do visualizador de Log do projeto, já apontado para a etapa que falhou. Também abre a partir de um problema na guia Weave do projeto.

Abrindo o assistente de correção

Na guia Log do projeto, ao lado da entrada bruta do log:

Abra o projeto e clique na guia Log.
Na lista de log, selecione a entrada da etapa que falhou. A mensagem completa dela, incluindo qualquer traceback, abre no painel à direita, na guia Mensagem de log.
Mude esse painel para a guia AI Assistant.

O chat do AI Assistant abre já apontado para o fluxo de trabalho e a etapa de onde veio a entrada de log selecionada, portanto começa a diagnosticar imediatamente: você não precisa dizer qual etapa falhou. Você pode ler o erro bruto em Mensagem de log 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 da guia Weave

Na guia Weave do projeto, clique em Corrigir no cartão de um problema que o Weave encontrou. O assistente abre em uma janela própria, já apontado para a etapa a que o problema se refere, e parte do problema como o Weave o relata agora. Consulte Corrija uma constatação com o assistente de IA para saber quais constatações oferecem Corrigir.

Como funciona

Diagnostica: lê a configuração da etapa que falhou e as tabelas e colunas que ela toca, e confere suas afirmações com os seus dados em vez de adivinhar apenas a partir do texto do erro.
Propõe: se encontra uma configuração incorreta de fato, mostra a alteração em um cartão: Why it failed em uma frase e, depois, uma caixa para cada configuração que muda, nomeada, quando possível, como aparece no formulário da etapa, com o valor atual em vermelho e o novo valor em verde. Só o que muda é listado: em uma lista de colunas, apenas as colunas que mudam. Nada é salvo neste ponto.
Você aprova: selecione Approve N changes no cartão, ou Agora não para deixar a etapa como está. Responder com as suas próprias palavras também funciona. Os botões ficam disponíveis quando o assistente termina a resposta, e a sua aprovação sempre vem em uma mensagem posterior à proposta.
Aplica: depois que você aprova, ele grava a alteração na etapa, pelo mesmo caminho que o editor de etapas usa. O que é salvo é a alteração mostrada no cartão, e uma aprovação a salva uma vez. Logo antes de salvar, ele guarda uma cópia das configurações da etapa como estão, para que você possa desfazer a correção; consulte Desfazer uma correção.
Oferece uma nova execução: um segundo cartão pergunta se você quer executar a etapa de novo agora para confirmar a correção. Aprove e o assistente executa a etapa e informa se ela foi concluída com sucesso, terminou com um aviso ou falhou de novo; uma nova falha é um erro que ele então diagnostica. Se a etapa não terminar em dois minutos, ele informa, e o resultado aparece no fluxo de trabalho e na guia Log.

O assistente não oferece uma nova execução para uma etapa que lança dados em um sistema ERP ou executa outro fluxo de trabalho (execute-a novamente a partir do fluxo de trabalho dela, onde você escolhe o modo de lançamento no ERP), nem quando o chat não está vinculado a um fluxo de trabalho, nem quando o seu perfil não pode executar fluxos de trabalho. Se o fluxo de trabalho já estiver em execução, nada é executado e o assistente oferece tentar novamente.

Cada proposta, a sua aprovação ou rejeição e a própria alteração são registradas no histórico de atividades do Weave do projeto, com exatamente o que a alteração substituiu e gravou. A sua aprovação é registrada antes de a alteração ser feita. Se ela não puder ser registrada, nada é salvo, o cartão informa isso e você pode aprovar de novo mais tarde.

Desfazer uma correção

O cartão de uma correção informa quando ela pode ser desfeita: O Weave guarda uma cópia das configurações atuais da etapa, então você pode desfazer isto por um tempo limitado, a menos que a etapa seja alterada antes. Um cartão sem essa linha não pode ser desfeito. Se o Weave não conseguir guardar a cópia, ele não salva nada e informa, e você pode pedir novamente.

Quando a correção é salva, o cartão mostra Desfazer. A entrada da correção no histórico de atividades do Weave do projeto tem o mesmo botão, então você pode desfazer uma correção depois que o chat dela for fechado. Qualquer pessoa cujo perfil possa alterar etapas no projeto pode desfazer uma correção, não só quem a aprovou.

Desfazer abre uma janela que mostra o que será restaurado: cada configuração que a correção alterou, como está Atual e como ficará Depois de desfazer. Em seguida, escolha:

Desfazer: restaura as configurações da etapa como estavam logo antes da correção.
Desfazer e executar: restaura-as e depois executa a etapa. É oferecido quando o seu perfil pode executar fluxos de trabalho, a etapa ainda está no fluxo de trabalho em que a correção foi feita (ou, na falta dele, em apenas um fluxo de trabalho), você pode abrir esse fluxo de trabalho e a etapa não lança dados em um sistema ERP nem executa outro fluxo de trabalho. A execução em si não pode ser desfeita.
Cancelar: deixa a etapa como está.

Desfazer altera apenas as configurações da etapa. Os dados que as execuções da etapa já gravaram permanecem como estão: execute a etapa de novo para reconstruí-los.

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

A etapa mudou desde a correção. Desfazer restauraria configurações desatualizadas, então a janela mostra a etapa como está Atual ao lado de suas configurações Antes da alteração do Weave, e você mesmo pode alterá-la.
A etapa já tem as configurações que tinha antes da correção.
A cópia não é mais mantida. As cópias são mantidas por um tempo limitado.
O seu perfil não pode alterar a etapa, ou o projeto está bloqueado.
O Weave não conseguiu registrar o desfazer. Tente novamente mais tarde.

Um desfazer é registrado no histórico de atividades como uma alteração própria, como Feito conforme aprovado: desfazer a alteração do Weave nas configurações de uma etapa.

Erros comuns

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

Em qualquer tipo de etapa:

uma expressão que usa uma coluna que não está na tabela que a etapa lê
um mapeamento de colunas cuja coluna de origem não está na tabela que a etapa lê
uma configuração de que a etapa precisa e que ficou vazia, como a conexão que ela usa ou a tabela que ela lê
um fluxo de trabalho executado pela etapa que falhou: a causa provavelmente está em uma das etapas desse fluxo de trabalho, então verifique o log dele
uma tabela citada pela etapa que não pode ser encontrada
um warehouse do Snowflake ou do Databricks que bloqueia o endereço do PlaidCloud, rejeita o login, esgotou a cota, não pode ser encontrado ou usado, ou não tem um privilégio de que o perfil do PlaidCloud precisa

Em uma etapa SQL Extract:

SQL que não pode ser lido como foi escrito, como uma palavra-chave com erro de grafia ou um colchete que não foi fechado
uma função que o banco de dados não reconhece
uma tabela que não existe
uma função que recebeu um tipo de valor com o qual não consegue trabalhar, como somar uma coluna de texto (no Databend)
um valor que não pode ser convertido para o tipo que o SQL pediu, como texto onde se esperava um número ou uma data (no Databend)

Em uma etapa Table Extract, com correções que apontam para as guias e os campos da própria etapa, e não para o SQL:

uma tabela de origem que ainda não existe, ou que deixou de existir (no Databend)
uma expressão que usa uma função que o banco de dados não reconhece (no Databend)
uma função que recebeu um tipo de valor com o qual não consegue trabalhar, como somar uma coluna de texto em uma expressão ou com Resumir (no Databend)
uma etapa sem colunas de saída, como uma em que todas as colunas foram removidas

A explicação diz o que costuma causar o erro, quais palavras da mensagem de erro observar e como corrigi-lo. Ela é geral: não verifica a sua etapa nem altera nada. Para que o assistente examine a própria etapa, responda. A partir daí ele funciona como descrito em Como funciona, com a explicação como parte da conversa.

Qualquer outro erro vai direto para o diagnóstico do próprio assistente. Isso inclui os erros de banco de dados listados acima quando vêm de qualquer outro tipo de etapa.

O que ele pode corrigir

O assistente repara a configuração da única etapa de onde o erro veio, por exemplo o nome de coluna ou de função digitado errado, uma expressão inválida, um tipo de dados ou uma conversão incorretos, ou um SQL malformado. Ele altera o mínimo que corrige o erro: uma falha, uma alteração direcionada, com o restante da configuração deixado como estava.

Uma expressão que falha, em uma coluna, em um filtro ou em uma cláusula having, é entregue ao mesmo especialista em expressões que fica ao lado do Editor de expressões, com o erro e as colunas da tabela de origem. A expressão corrigida que ele devolve é verificada antes de ser proposta, e a proposta continua sendo uma alteração desse único campo da etapa, aprovada do mesmo modo que qualquer outra.

O que ele não faz

A única alavanca dele é a configuração dessa etapa, e ele é franco quando o problema está em outro lugar, em vez de forçar uma edição para parecer uma solução.

Ele edita a configuração de uma etapa e nada mais: não cria, exclui nem reordena etapas, não cria tabelas, não edita outra etapa nem altera os seus dados.
Muitas falhas não são problemas de configuração: dados de origem ausentes ou malformados, uma etapa anterior que falhou primeiro, um erro transitório ou de infraestrutura, um problema de permissões, Python quebrado em uma UDF ou em uma etapa de código do usuário, um arquivo ausente em uma conta de documentos, ou um limite de recursos ou de tempo. Nesses casos, ele explica o que encontrou e indica onde está a correção de verdade.
Os avisos costumam ser inofensivos e não exigem alteração: ele dirá isso com clareza em vez de inventar uma edição.
Quando não tem certeza de que uma alteração vai funcionar, ele diz isso e aponta aquilo de que não tem certeza, em vez de apresentar um palpite como certeza.

Dicas

O diagnóstico se baseia na configuração ativa da sua etapa e nos metadados das tabelas, portanto reflete o projeto como ele está agora, não uma forma em cache ou presumida.
Depois que uma correção é aplicada, diga sim quando o assistente oferecer executar a etapa de novo, ou execute-a você mesmo, para confirmar que o erro foi resolvido.
Se o assistente disser que a causa está fora da configuração da etapa (dados incorretos, uma falha anterior, um problema de permissões), essa é a resposta: corrija onde ela realmente está, em vez de pedir ao assistente que edite a etapa mesmo assim.