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.
Otwieranie asystenta napraw
Dział zatytułowany „Otwieranie asystenta napraw”Z karty Dziennik projektu:
- 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, w sekcji Komunikat dziennika.
- 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.
Z edytora przepływu pracy
Dział zatytułowany „Z edytora przepływu pracy”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.
Z menu kontekstowego
Dział zatytułowany „Z menu kontekstowego”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.
Z karty Weave
Dział zatytułowany „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
Dział zatytułowany „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.
- 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.
Poprawka czekająca po nieudanym uruchomieniu
Dział zatytułowany „Poprawka czekająca po nieudanym uruchomieniu”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.
Naprawianie kilku kroków naraz
Dział zatytułowany „Naprawianie kilku kroków naraz”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.
Cofanie poprawki
Dział zatytułowany „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
Dział zatytułowany „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
- 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.
Co może naprawić
Dział zatytułowany „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
Dział zatytułowany „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
Dział zatytułowany „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.