Naprawianie błędów przepływu pracy za pomocą AI

Opis

Gdy krok przepływu pracy kończy się błędem lub zapisuje ostrzeżenie, asystent napraw AI odczytuje ten błąd, ustala jego przyczynę i — jeśli przyczyną jest błędna konfiguracja samego kroku — proponuje poprawioną konfigurację oraz stosuje ją po Twojej akceptacji. Nie ogranicza się do wyjaśnienia błędu: może wprowadzić zmianę za Ciebie.

Jest częścią Weave AI w PlaidCloud i otwiera się z przeglądarki Dziennik projektu, od razu skierowany na krok, który zakończył się błędem. Otwiera się też z problemu na karcie Weave projektu.

Otwieranie asystenta napraw

Z karty Dziennik projektu, obok surowego wpisu dziennika:

Otwórz projekt i kliknij kartę Dziennik.
Na liście dziennika wybierz wpis dla kroku, który zakończył się błędem. Jego pełny komunikat — wraz z ewentualnym śladem stosu — otworzy się w panelu po prawej stronie, na karcie Komunikat dziennika.
Przełącz ten panel na kartę AI Assistant.

Czat AI Assistant otwiera się od razu skierowany na przepływ pracy i krok, z którego pochodzi wybrany wpis dziennika, więc natychmiast zaczyna diagnozę — nie musisz mu mówić, który krok zakończył się błędem. Surowy błąd możesz czytać na karcie Komunikat dziennika, a jednocześnie rozmawiać z asystentem na karcie AI Assistant. W przypadku kilku typowych błędów jego pierwszą odpowiedzią jest wyjaśnienie — zobacz Typowe błędy.

Z karty Weave

Na karcie Weave projektu kliknij Napraw na karcie problemu znalezionego przez Weave. Asystent otwiera się we własnym oknie, od razu skierowany na krok, którego dotyczy problem, i zaczyna od problemu w takiej postaci, w jakiej Weave zgłasza go teraz. Informacje o tym, które ustalenia oferują Napraw, znajdziesz w Naprawianie ustalenia za pomocą asystenta AI.

Jak to działa

Diagnozuje — odczytuje konfigurację kroku, który zawiódł, oraz tabele i kolumny, których dotyczy, i weryfikuje swoje twierdzenia na podstawie Twoich danych, zamiast zgadywać wyłącznie z treści błędu.
Proponuje — jeśli znajdzie rzeczywistą błędną konfigurację, pokazuje zmianę na karcie: Why it failed w jednym zdaniu, a następnie ramkę dla każdego ustawienia, które się zmienia, nazwanego tam, gdzie to możliwe, tak jak w formularzu kroku, z bieżącą wartością na czerwono i nową wartością na zielono. Wymienione jest tylko to, co się zmienia — w przypadku listy kolumn tylko kolumny, które się zmieniają. Na tym etapie nic nie jest zapisywane.
Akceptujesz — wybierz Approve N changes na karcie lub Nie teraz, aby zostawić krok bez zmian. Możesz też odpowiedzieć własnymi słowami. Przyciski stają się dostępne, gdy asystent skończy swoją odpowiedź, a Twoja akceptacja zawsze następuje w wiadomości po propozycji.
Stosuje — po Twojej akceptacji zapisuje zmianę w kroku, tą samą ścieżką, której używa edytor kroku. Zapisywana jest zmiana widoczna na karcie, a jedna akceptacja zapisuje ją jeden raz. Tuż przed zapisem zachowuje kopię bieżących ustawień kroku, aby można było cofnąć poprawkę — zobacz Cofanie poprawki.
Proponuje ponowne uruchomienie — druga karta pyta, czy uruchomić krok ponownie teraz, aby potwierdzić poprawkę. Zaakceptuj, a asystent uruchomi krok i poinformuje, czy zakończył się powodzeniem, ostrzeżeniem, czy znowu błędem; nowy błąd jest następnie przez niego diagnozowany. Jeśli krok nie zakończy się w ciągu dwóch minut, asystent o tym poinformuje, a wynik pojawi się w przepływie pracy i na karcie Dziennik.

Asystent nie proponuje ponownego uruchomienia kroku, który księguje w systemie ERP lub uruchamia inny przepływ pracy — uruchom go ponownie z jego przepływu pracy, gdzie wybierasz tryb księgowania ERP — ani gdy czat nie jest powiązany z przepływem pracy, ani gdy Twoja rola nie może uruchamiać przepływów pracy. Jeśli przepływ pracy jest już uruchomiony, nic się nie uruchamia, a asystent proponuje ponowną próbę.

Każda propozycja, Twoja akceptacja lub odrzucenie oraz sama zmiana są rejestrowane w historii aktywności Weave projektu, wraz z dokładną informacją, co zmiana zastąpiła i co zapisała. Twoja akceptacja jest rejestrowana przed wprowadzeniem zmiany. Jeśli nie można jej zarejestrować, nic nie jest zapisywane, karta informuje o tym, a Ty możesz zaakceptować zmianę ponownie później.

Cofanie poprawki

Karta poprawki informuje, kiedy można ją cofnąć: Weave keeps a copy of the step’s current settings, so you can undo this for a limited time, unless the step is changed again first. Karty bez tego wiersza nie można cofnąć. Jeśli Weave nie może zachować kopii, niczego nie zapisuje i informuje o tym, a Ty możesz poprosić go ponownie.

Po zapisaniu poprawki karta pokazuje Cofnij. Wpis poprawki w historii aktywności Weave projektu ma ten sam przycisk, więc poprawkę można cofnąć także po zamknięciu jej czatu. Poprawkę może cofnąć każdy, czyja rola pozwala zmieniać kroki w projekcie, a nie tylko osoba, która ją zaakceptowała.

Cofnij otwiera okno pokazujące, co przywróci cofnięcie: każde ustawienie zmienione przez poprawkę, w stanie Obecnie i w stanie Po cofnięciu. Następnie wybierz:

Cofnij — przywróć ustawienia kroku do stanu sprzed poprawki.
Cofnij i uruchom — przywróć je, a następnie uruchom krok. Opcja jest dostępna, gdy Twoja rola może uruchamiać przepływy pracy, krok nadal znajduje się w przepływie pracy, w którym wprowadzono poprawkę (lub, jeśli to nie zachodzi, tylko w jednym przepływie pracy) i możesz otworzyć ten przepływ pracy, a krok nie księguje w systemie ERP ani nie uruchamia innego przepływu pracy. Samego uruchomienia nie można cofnąć.
Anuluj — pozostaw krok bez zmian.

Cofnięcie zmienia wyłącznie ustawienia kroku. Dane, które uruchomienia kroku już zapisały, pozostają bez zmian: uruchom krok ponownie, aby je odbudować.

Weave nie cofnie poprawki i niczego nie zmieni, gdy:

Krok zmienił się od czasu poprawki. Cofnięcie przywróciłoby nieaktualne ustawienia, więc okno pokazuje krok w stanie Obecnie obok jego ustawień Przed zmianą Weave, a Ty możesz zmienić go samodzielnie.
Krok ma już ustawienia, jakie miał przed poprawką.
Kopia nie jest już przechowywana. Kopie są przechowywane przez ograniczony czas.
Twoja rola nie może zmieniać kroku lub projekt jest zablokowany.
Weave nie mógł zarejestrować cofnięcia. Spróbuj ponownie później.

Cofnięcie jest rejestrowane w historii aktywności jako osobna zmiana, na przykład Done as approved: undo Weave’s change to a step’s settings.

Typowe błędy

Gdy krok kończy się jednym z tych typowych błędów, pierwszą odpowiedzią jest wyjaśnienie, które PlaidCloud ma już dla tego rodzaju błędu, więc pojawia się natychmiast.

W dowolnym typie kroku:

wyrażenie używające kolumny, której nie ma w tabeli odczytywanej przez krok
mapowanie kolumn, którego kolumny źródłowej nie ma w tabeli odczytywanej przez krok
ustawienie potrzebne krokowi, które pozostawiono puste, takie jak używane połączenie lub odczytywana tabela
przepływ pracy uruchamiany przez krok, który zakończył się błędem — przyczyna najprawdopodobniej leży w jednym z kroków tego przepływu pracy, więc sprawdź jego dziennik
tabela wskazana przez krok, której nie można znaleźć
hurtownia Snowflake lub Databricks, która blokuje adres PlaidCloud, odrzuca jego logowanie, wyczerpała limit, nie można jej znaleźć ani użyć, lub brakuje w niej uprawnienia potrzebnego roli PlaidCloud

W kroku SQL Extract:

SQL, którego nie można odczytać w takiej postaci, jak napisano, na przykład z błędnie napisanym słowem kluczowym lub niezamkniętym nawiasem
funkcja, której baza danych nie rozpoznaje
tabela, która nie istnieje
funkcja otrzymująca wartość typu, z którym nie może pracować, na przykład sumowanie kolumny tekstowej (w Databend)
wartość, której nie można przekonwertować na typ wymagany przez SQL, na przykład tekst tam, gdzie oczekiwano liczby lub daty (w Databend)

W kroku Table Extract, z poprawkami wskazującymi własne karty i pola kroku, a nie SQL:

tabela źródłowa, która jeszcze nie istnieje lub już nie istnieje (w Databend)
wyrażenie używające funkcji, której baza danych nie rozpoznaje (w Databend)
funkcja otrzymująca wartość typu, z którym nie może pracować, na przykład sumowanie kolumny tekstowej w wyrażeniu lub za pomocą Podsumuj (w Databend)
krok bez kolumn wyjściowych, na przykład taki, z którego usunięto wszystkie kolumny

Wyjaśnienie mówi, co zwykle powoduje dany błąd, na które słowa w komunikacie o błędzie zwrócić uwagę i jak go naprawić. Jest ogólne: nie sprawdza Twojego kroku i niczego nie zmienia. Aby asystent przyjrzał się samemu krokowi, odpowiedz. Od tej chwili działa tak, jak opisano w Jak to działa, a wyjaśnienie jest częścią rozmowy.

Każdy inny błąd trafia bezpośrednio do własnej diagnozy asystenta. Dotyczy to także wymienionych powyżej błędów bazy danych, gdy pochodzą z kroku jakiegokolwiek innego typu.

Co może naprawić

Asystent naprawia konfigurację jednego kroku, z którego pochodzi błąd — na przykład błędnie wpisaną nazwę kolumny lub funkcji, nieprawidłowe wyrażenie, niewłaściwy typ danych lub rzutowanie, albo nieprawidłowo sformułowany SQL. Zmienia jak najmniej, aby naprawić błąd: jeden błąd, jedna ukierunkowana zmiana, a reszta konfiguracji pozostaje bez zmian.

Wyrażenie, które zawodzi — w kolumnie, filtrze lub klauzuli having — jest przekazywane temu samemu specjaliście od wyrażeń, który działa obok Edytora wyrażeń, razem z błędem i kolumnami tabeli źródłowej. Poprawione wyrażenie, które zwraca, jest sprawdzane przed zaproponowaniem, a propozycja nadal jest zmianą tego jednego pola kroku, akceptowaną tak samo jak każda inna.

Czego nie zrobi

Jego jedyną dźwignią jest konfiguracja tego kroku, a gdy problem leży gdzie indziej, mówi o tym otwarcie, zamiast naginać edycję tak, by wyglądała na rozwiązanie.

Edytuje konfigurację jednego kroku i nic więcej — nie utworzy, nie usunie ani nie zmieni kolejności kroków, nie utworzy tabel, nie edytuje innego kroku ani nie zmieni Twoich danych.
Wiele błędów nie jest problemami konfiguracji: brakujące lub nieprawidłowo sformatowane dane źródłowe, krok wcześniejszy, który zawiódł jako pierwszy, błąd przejściowy lub infrastrukturalny, problem z uprawnieniami, wadliwy kod Python w UDF lub w kroku z kodem użytkownika, brakujący plik na koncie dokumentów albo limit zasobów lub czasu. W takich przypadkach wyjaśnia, co znalazł, i wskazuje, gdzie leży prawdziwe rozwiązanie.
Ostrzeżenia są często nieszkodliwe i nie wymagają zmiany — powie to wprost, zamiast wymyślać edycję.
Gdy nie ma pewności, że zmiana zadziała, mówi o tym i wskazuje, czego jest niepewny, zamiast przedstawiać domysł jako pewnik.

Wskazówki

Diagnoza opiera się na bieżącej konfiguracji kroku i metadanych tabel, więc odzwierciedla projekt w obecnym stanie — a nie w stanie z pamięci podręcznej czy założonym.
Po zastosowaniu poprawki odpowiedz twierdząco, gdy asystent zaproponuje ponowne uruchomienie kroku, lub uruchom go samodzielnie, aby potwierdzić, że błąd został usunięty.
Jeśli asystent mówi, że przyczyna leży poza konfiguracją kroku (błędne dane, wcześniejszy błąd, problem z uprawnieniami), to jest odpowiedź — napraw to tam, gdzie faktycznie leży, zamiast prosić asystenta o edycję kroku mimo to.