Przejdź do głównej zawartości

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

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ę w panelu Weave, od razu skierowany na krok, który zakończył się błędem — z przeglądarki Dziennik projektu, z edytora przepływu pracy oraz z karty Weave projektu. Gdy zaplanowane uruchomienie zakończy się niepowodzeniem, Weave może mieć już przygotowaną poprawkę; zobacz Poprawka czekająca po nieudanym uruchomieniu.

Z karty Dziennik projektu:

  1. Otwórz projekt i kliknij kartę Dziennik.
  2. 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, w sekcji Komunikat dziennika.
  3. Kliknij Napraw pod komunikatem. Błąd lub ostrzeżenie z kroku oferuje Napraw; pozostałe wpisy oferują Zapytaj Weave. Menu ⋯ obok zawiera Wyjaśnij i pozostałe akcje Weave.

Panel 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ć w sekcji Komunikat dziennika, podczas gdy asystent odpowiada w panelu. W przypadku kilku typowych błędów jego pierwszą odpowiedzią jest wyjaśnienie — zobacz Typowe błędy.

Wybierz na kanwie krok oznaczony czerwoną kropką. W Inspektorze karta Błąd ostatniego uruchomienia ma obok nagłówka przycisk Napraw, gdy asystent naprawy jest włączony, a w przeciwnym razie Zapytaj Weave. Zobacz Gdy krok zakończy się niepowodzeniem.

Kliknij prawym przyciskiem myszy krok na kanwie lub na liście kroków albo wiersz błędu w dzienniku i wybierz Napraw w sekcji Weave menu. Akcja Napraw jest dostępna, gdy ostatnie uruchomienie kroku zakończyło się niepowodzeniem lub oferuje ją ustalenie, i nigdy dla wiersza ostrzeżenia. Panel Weave otwiera się na tym kroku. W widoku Monitor lub w przeglądarce Dziennik przycisk Napraw w wierszu działa tak samo.

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Uruchamia ponownie i potwierdza — w przeglądarce ta sama akceptacja obejmuje ponowne uruchomienie: Weave ponownie uruchamia naprawiony krok z wyłączonym księgowaniem ERP i informuje, czy zakończył się powodzeniem, ostrzeżeniem, czy znowu błędem, na przykład Fixed and re-run: Allocate by Driver succeeded in 4 min, 46,812 rows, within its usual range. Jeśli nie mógł tego potwierdzić, podaje przyczynę i nigdy nie twierdzi, że krok został naprawiony. W aplikacji mobilnej druga karta pyta, czy uruchomić krok ponownie. Jeśli krok nie zakończy się w ciągu dwóch minut, Weave o tym informuje, a wynik pojawia 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.

Gdy uruchomienie przepływu pracy rozpoczęte przez harmonogram lub czujnik zakończy się niepowodzeniem, Weave od razu analizuje błąd i — jeśli to możliwe — przygotowuje poprawkę, zanim ktokolwiek otworzy dziennik. W przypadku uruchomienia rozpoczętego ręcznie przygotowuje poprawkę, gdy przyczyną jest kolumna źródłowa, której nazwę zmieniono.

Poprawka czeka na karcie zatytułowanej od błędu, na przykład Month-End Close failed at Allocate by Driver. Karta podaje, dlaczego uruchomienie się nie powiodło, co się zmieni i co zostanie uruchomione ponownie: Then: re-run Month-End Close from Allocate by Driver, then Margin Report. ERP posting is off for these runs. Znajdziesz ją:

  • w wierszu nieudanego uruchomienia w Monitor → Ustalenia, który rozwija się, pokazując kartę;
  • przy wpisie dziennika i przy oznaczeniu kroku na kanwie;
  • w panelu, jako wiersz Czeka na Ciebie.

Właściciel karty otrzymuje w PlaidCloud powiadomienie Month-End Close failed. Weave has a fix for you to review., a także na telefonie, jeśli korzysta z aplikacji mobilnej. Kliknij Apply and re-run, aby zapisać poprawkę i uruchomić przepływ ponownie od kroku, który zakończył się błędem. Weave informuje następnie, czy uruchomienie się powiodło.

  • Zatwierdzić ją może w przeglądarce każdy, czyja rola pozwala edytować krok, który zakończył się błędem, oraz właściciel karty.
  • Weave przygotowuje jedną kartę dla każdej przyczyny i nie analizuje ponownie tego samego błędu w niezmienionym kroku, jeśli nie znalazł poprawki lub karta została odrzucona.
  • Krok, który księguje w systemie ERP lub zapisuje dane poza PlaidCloud, nie otrzymuje karty.

Gdy ten sam problem dotyczy kilku kroków, na przykład kolumny o zmienionej nazwie używanej w sześciu mapowaniach, Weave proponuje wszystkie zmiany na jednej karcie, z numerowaną sekcją dla każdej z nich, informacją o tym, co uruchomi ponownie, oraz o wszystkim, czego nie mógł uwzględnić, na przykład kroku, którego Twoja rola nie pozwala edytować. Jedno kliknięcie Zatwierdź 6 zmian stosuje wszystkie zmiany, a następnie Weave jeden raz ponownie uruchamia każdy naprawiony krok z wyłączonym księgowaniem ERP i informuje, czy problem zniknął. Jeśli krok zmienił się po zatwierdzeniu, Weave nie stosuje do niego zmiany, zatrzymuje się i podaje, ile zmian zastosowano. Jedno kliknięcie Cofnij przywraca wszystkie naprawione kroki. Jeśli Weave przygotował kartę pod Twoją nieobecność, czeka ona w tej rozmowie w panelu, jako wiersz Czeka na Ciebie, który otwierasz, aby zatwierdzić; zobacz Karty oczekujące na Ciebie.

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.

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
  • krok, który zatrzymał się przed zapisem czegokolwiek, ponieważ jego tabele źródłowe nie zgadzają się z jego ustawieniami: kolumna, której używa, lub klucz złączenia, którego tabela nie ma, klucz złączenia, którego krok nie wymienia, albo tabela źródłowa, która nie została zbudowana
  • 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.

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.

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.
  • 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.