Rozwiązywanie problemów
Nieudane uruchomienie
Jak znaleźć nieudane uruchomienie w Historii, odczytać jego błąd i naprawić typowe przyczyny.
Uruchomienie kończy się niepowodzeniem, gdy krok nie może zostać dokończony: narzędzie zwraca błąd, aplikacja nie jest podłączona, w obszarze roboczym brakuje kredytów albo plan nie pozwala na dany krok. Każde uruchomienie jest zapisywane, więc możesz później odczytać, co się stało.
Objawy#
- Agent zatrzymuje się w połowie albo zwraca pustą lub ogólną odpowiedź.
- Workflow kończy się wcześniej lub wiersz partii pokazuje Niepowodzenie.
- Zaplanowane uruchomienie nie zrobiło nic.
- Po kliknięciu publikowania widzisz baner z błędem, np. “Validation failed. Please fix the errors highlighted on the components.”
Znajdź uruchomienie w Historii#
- Kliknij Historia na pasku bocznym.
- Włącz filtr Komunikaty o błędach, aby wyświetlić tylko sesje zawierające błąd. Możesz też filtrować według Agenta lub workflow oraz według chatbota.
- Otwórz sesję. Użyj opcji Zwykły lub Szczegółowy, aby zmienić ilość widocznych szczegółów.
- Czytaj kolejne zdarzenia. Są oznaczone jako Wiadomość użytkownika, Odpowiedź chatbota, Komunikat systemowy, Hook czatu, Wywołanie narzędzia i Zapytanie agenta. Poszukaj w zdarzeniach Wywołanie narzędzia tego, które zgłasza błąd.
Panel metryk nad tabelą (Pokaż metryki) przedstawia na wykresie Łączną liczbę błędów w czasie. Twój plan ogranicza, jak daleko wstecz sięga historia. Zobacz plany i limity. W przypadku uruchomień partii tabela ma kolumny Status i Błąd, a opcje Uruchom ponownie nieudane lub Ponów wiersz uruchamiają ponownie nieudane wiersze.
Typowe błędy i rozwiązania#
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| “Insufficient credits to perform this action. Please recharge your credits.” | Saldo jest puste | Brak kredytów |
| “Workspace credit limit reached” | Limit wydatków obszaru roboczego | Zwiększ go w Ustawienia → Kredyty |
| “NAME is not configured. Please set up the integration first.” | Krok wymaga aplikacji, która nie jest podłączona | Podłącz ją w Integracje |
| “…is connected but is missing the permissions it requires. Please reconnect the integration and grant the additional permissions.” | Połączeniu brakuje uprawnienia | Podłącz integrację ponownie i zaakceptuj wszystkie uprawnienia |
| “…requires re-authorization. The refresh token is expired or revoked. Please reconnect the integration.” | Logowanie wygasło lub zostało unieważnione | Podłącz konto ponownie |
| “Component NAME can only be used with … plan” | Krok nie jest objęty Twoim planem | Zastąp krok lub zmień plan |
| “Allowed limit of … reached. Please upgrade your plan.” | Osiągnięto limit planu podczas tworzenia czegoś | Usuń jeden element lub zmień plan |
| “Validation failed. Please fix the errors highlighted on the components.” | W kroku brakuje wymaganych ustawień | Popraw oznaczone kroki, a następnie opublikuj ponownie |
Zaplanowane uruchomienia#
Jeśli w obszarze roboczym skończyły się kredyty, system wyłącza harmonogram zamiast ponawiać próby w nieskończoność. Otwórz go i włącz ponownie, gdy będziesz mieć kredyty. Zobacz harmonogramy.
Napraw to#
- Znajdź nieudaną sesję i skopiuj dokładny błąd.
- Dopasuj go do tabeli, zastosuj rozwiązanie i uruchom ponownie z tym samym wejściem.
- Jeśli błąd pochodzi z usługi zewnętrznej i nie potrafisz ustalić dlaczego, przetestuj krok osobno z kanwy. Zobacz testowanie i dzienniki uruchomień.
Sprawdź, ile kosztowało uruchomienie
Sprawdź Transakcje, jeśli nie masz pewności, ile wydało uruchomienie. Każde obciążenie jest wymienione wraz z jego typem i kontekstem. Zobacz kredyty.