Przejdź do głównej zawartości
PlaidCloud

Naprawianie przepływu pracy z asystentem AI

~20 minut · nieudany krok, diagnoza AI, zastosowana poprawka

Uruchamiasz przepływ pracy, krok robi się czerwony, a sam tekst błędu nie mówi, co zmienić. Ten samouczek przeprowadza przez dokładnie ten moment: otwierasz wbudowanego w PlaidCloud asystenta AI, pozwalasz mu zdiagnozować nieudany krok na podstawie Twoich aktualnych danych, zatwierdzasz proponowaną poprawkę i uruchamiasz ponownie, aby ją potwierdzić. Następnie używasz tego samego asystenta, aby napisać krok Wyodrębnij SQL na podstawie opisu w zwykłym języku.

To wbudowany w produkt asystent AI, który pomaga tworzyć i naprawiać przepływy pracy. Nie jest tym samym, co podłączenie zewnętrznego agenta AI do kodowania (Claude Code, Cursor, MCP) do Twojej dzierżawy — ta uzupełniająca ścieżka opisana jest w Połącz agenta AI do kodowania.

Co zrobisz

Dział zatytułowany „Co zrobisz”
Etap Z czego skorzystasz
Zobaczysz błąd kroku i przeczytasz komunikat Karta Dziennik projektu
Zdiagnozujesz i naprawisz nieudany krok Asystent naprawy, na karcie AI Assistant wpisu dziennika
Potwierdzisz poprawkę Odpowiedz „tak”, gdy asystent zaproponuje ponowne uruchomienie kroku
Dodasz nowe zapytanie bez pisania SQL Generate SQL with AI w kroku Wyodrębnij SQL

Wymagania wstępne

Dział zatytułowany „Wymagania wstępne”
  • Obszar roboczy PlaidCloud (rozpocznij bezpłatny okres próbny, jeśli go nie masz) oraz projekt, który możesz edytować.
  • Przepływ pracy z co najmniej jednym krokiem — najlepiej takim, który kończy się błędem lub który możesz doprowadzić do błędu (literówka w nazwie kolumny w transformacji wystarczy, aby odtworzyć scenariusz).

Asystent naprawia z Twoimi uprawnieniami. Może zmienić tylko krok, który mógłbyś edytować samodzielnie, a każda jego zmiana jest odwracalna przez ponowne uruchomienie lub bezpośrednią edycję kroku. Zobacz Naprawianie błędów przepływu pracy z AI.

Krok 1: Uruchom przepływ pracy i znajdź błąd

Dział zatytułowany „Krok 1: Uruchom przepływ pracy i znajdź błąd”

Gdy krok kończy się niepowodzeniem, wskaźnik błędu pojawia się zarówno przy przepływie pracy, jak i przy nieudanym kroku, a niepowodzenie jest zapisywane w dzienniku przepływu pracy.

  1. Otwórz projekt i uruchom przepływ pracy (lub pojedynczy testowany krok).
  2. Przełącz się na kartę Dziennik projektu. Dziennik wyświetla zdarzenia w miarę uruchamiania kroków — w tym ostrzeżenia i błędy.
  3. Na liście dziennika wybierz wpis dla kroku, który się nie powiódł. Jego pełny komunikat — wraz z ewentualnym śladem stosu — otwiera się w panelu po prawej, na karcie Komunikat dziennika.

Nie masz pod ręką uszkodzonego przepływu pracy? Zrób go w 30 sekund. W dowolnym kroku transformacji zmień wyrażenie jednej kolumny tak, aby odwoływało się do kolumny, która nie istnieje — na przykład zmień net_amount na net_amnt — i zapisz. Uruchom krok, a zakończy się błędem z komunikatem w dzienniku, że kolumna net_amnt nie istnieje. To prawdziwa błędna konfiguracja, którą asystent naprawy został stworzony, by wychwytywać, więc to czysty sposób na przejście tego samouczka od początku do końca.

Więcej o tym, jak błędy się ujawniają i jakie są opcje ich obsługi, znajdziesz w Zarządzanie błędami kroków i Wyświetlanie dziennika przepływu pracy.

Krok 2: Otwórz asystenta naprawy

Dział zatytułowany „Krok 2: Otwórz asystenta naprawy”

Asystent naprawy znajduje się tuż obok surowego błędu i jest już skierowany na krok, który się nie powiódł.

  1. Gdy wpis dziennika z błędem jest zaznaczony, znajdź panel po prawej pokazujący Komunikat dziennika.
  2. 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 zaznaczony wpis dziennika, więc nie musisz mówić, który krok zawiódł. Możesz czytać surowy błąd w Komunikat dziennika i rozmawiać z asystentem w AI Assistant obok siebie.

Przy większości błędów od razu zaczyna diagnozę. Przy kilku typowych, takich jak wyrażenie wskazujące nieistniejącą kolumnę, pierwszą odpowiedzią jest krótkie wyjaśnienie, które PlaidCloud już ma dla tego rodzaju błędu: co zwykle go powoduje, na które słowa w komunikacie zwrócić uwagę i jak go naprawić. To wyjaśnienie nie analizuje Twojego kroku. Odpowiedz — na przykład „Sprawdź ten krok i go napraw” — a asystent przejmie dalszą część. Zobacz Typowe błędy.

Krok 3: Pozwól mu zdiagnozować błąd i zaproponować poprawkę

Dział zatytułowany „Krok 3: Pozwól mu zdiagnozować błąd i zaproponować poprawkę”

Asystent działa w stałej kolejności i nic nie jest zapisywane, dopóki tego nie potwierdzisz:

  1. Diagnozuje — czyta konfigurację nieudanego kroku oraz tabele i kolumny, których dotyczy, sprawdzając swoje twierdzenia na Twoich danych zamiast zgadywać wyłącznie z tekstu błędu.
  2. Proponuje — jeśli znajdzie rzeczywistą błędną konfigurację, pokazuje poprawioną konfigurację kroku i wyjaśnia zrozumiale, co zmienił i dlaczego. Na tym etapie nic nie jest zapisywane.
  3. Zatwierdzasz — czeka na Twoją wyraźną zgodę. Niejednoznaczna odpowiedź nie jest traktowana jako zatwierdzenie.
  4. Stosuje — po Twoim zatwierdzeniu zapisuje poprawioną konfigurację w kroku, tą samą ścieżką, której używa edytor kroków.
  5. Proponuje ponowne uruchomienie — pyta, czy uruchomić krok teraz. Powiedz „tak”, a uruchomi krok i poinformuje Cię, czy poprawka zadziałała.

Przeczytaj proponowaną zmianę, zanim ją zatwierdzisz. 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, zły typ danych lub rzutowanie, albo źle sformułowany SQL — i zmienia możliwie najmniej, aby usunąć błąd.

Uczciwie mówi, czego nie potrafi naprawić. Jego jedyną dźwignią jest konfiguracja tego jednego kroku. Nie tworzy, nie usuwa ani nie zmienia kolejności kroków, nie edytuje innego kroku i nie zmienia Twoich danych. Wiele niepowodzeń w ogóle nie jest problemem konfiguracji — brakujące lub źle sformułowane dane źródłowe, krok nadrzędny, który zawiódł wcześniej, błąd przejściowy lub infrastrukturalny, problem z uprawnieniami albo błędna logika wewnątrz transformacji lub UDF. W takich przypadkach wyjaśnia, co znalazł, i wskazuje, gdzie leży prawdziwa poprawka, zamiast naginać edycję tak, by wyglądała jak rozwiązanie.

Krok 4: Zatwierdź i uruchom ponownie

Dział zatytułowany „Krok 4: Zatwierdź i uruchom ponownie”
  1. Gdy proponowana konfiguracja wygląda dobrze, wyraźnie potwierdź zmianę. Asystent zastosuje ją w kroku.
  2. Gdy asystent zapyta, czy uruchomić krok ponownie, powiedz „tak”. Uruchomi krok i poinformuje, czy się powiódł, czy znów zawiódł. Możesz też sam uruchomić ponownie krok lub przepływ pracy.

Jeśli asystent powiedział, że przyczyna leży poza konfiguracją kroku — błędne dane, awaria kroku nadrzędnego, problem z uprawnieniami — to jest odpowiedź. Napraw to tam, gdzie faktycznie leży, zamiast prosić asystenta o edycję kroku mimo to.

Ostrzeżenia często są niegroźne. Jeśli wpis dziennika to ostrzeżenie, a nie twarde niepowodzenie, asystent często powie, że żadna zmiana nie jest potrzebna, zamiast wymyślać edycję. To prawidłowy wynik, a nie ślepy zaułek.

Krok 5: Wygeneruj krok Wyodrębnij SQL za pomocą AI

Dział zatytułowany „Krok 5: Wygeneruj krok Wyodrębnij SQL za pomocą AI”

Teraz użyj tego samego asystenta do dodania nowej pracy, a nie tylko naprawy. Krok Wyodrębnij SQL uruchamia zapytanie SELECT tylko do odczytu i zapisuje wynik do nowej tabeli — a edytor kroku może napisać to zapytanie za Ciebie.

  1. W widoku Kroki przepływu pracy kliknij Utwórz krok i wybierz Tabele → Wyodrębnij SQL lub AI → SQL Extract (AI Assisted). Oba otwierają ten sam edytor, który zawiera panel Generate SQL with AI u góry strony Parametry ekstrakcji SQL.
  2. (Opcjonalnie) Wybierz tabele źródłowe. Na liście Tabele źródłowe zaznacz jedną lub kilka tabel, z których zapytanie ma czytać. Zostaw ją pustą, aby asystent sam zbadał projekt i wybrał odpowiednie tabele.
  3. Opisz, czego chcesz. W polu Opisz napisz oczekiwany rezultat zwykłym językiem — na przykład „sklasyfikuj każde konto księgi w puli działań na podstawie zakresu numeru konta”.
  4. Kliknij Wygeneruj SQL. Asystent pisze pojedyncze zapytanie SELECT tylko do odczytu, weryfikuje je, uruchamiając je, i wypełnia edytor Zapytanie SQL SELECT oraz stronę mapowania Wybór danych tabeli wykrytymi kolumnami. Jeśli lista źródeł była pusta, wybrane przez niego tabele zostaną zaznaczone na liście, abyś widział, z czego skorzystał.

Nie ma nic do skonfigurowania. To korzysta z tego samego wbudowanego modelu, którego używa asystent AI — nie musisz konfigurować dla niego agenta AI ani połączenia z LLM dla obszaru roboczego.

Krok 6: Przejrzyj i zapisz krok

Dział zatytułowany „Krok 6: Przejrzyj i zapisz krok”

Wygenerowany SQL to punkt wyjścia, a nie czarna skrzynka.

  1. Edytuj go swobodnie. Edytor SQL jest w pełni edytowalny — dopracuj zapytanie, dodaj złączenie lub zmień listę kolumn przed zapisem.
  2. Wybierz tabelę docelową. Wybierz lub nazwij Tabela docelowa, do której krok zapisuje wynik.
  3. Zapisz krok. Zostaje zapisany jako zwykły krok Wyodrębnij SQL i uruchamia się w ramach przepływu pracy jak każdy inny.

Asystent pisze wyłącznie instrukcje SELECT tylko do odczytu — nigdy INSERT, UPDATE, DELETE ani innego SQL zmieniającego dane. Generowanie tylko tworzy szkic i podgląd; krok powstaje po zapisaniu i uruchamia się wraz z przepływem pracy. Jeśli wygenerowane zapytanie się nie uruchamia, edytor pokazuje SQL razem z błędem, abyś mógł go poprawić — albo zmienić opis i wygenerować ponownie. Pełne szczegóły w Generowanie kroków Wyodrębnij SQL z AI.

To cała pomoc. Zdiagnozowałeś nieudany krok na żywych danych, zatwierdziłeś i zastosowałeś poprawkę AI, potwierdziłeś ją ponownym uruchomieniem i wygenerowałeś działający krok Wyodrębnij SQL z jednego zdania w zwykłym języku — ten sam asystent naprawia to, co zepsute, i buduje to, co nowe.

Co dalej

Dział zatytułowany „Co dalej”