retellai-known-pitfalls

Umiejętność do przeglądu kodu Retell AI pod kątem typowych błędów integracji i anty-wzorców. Retell obsługuje telefonię, rozpoznawanie mowy i syntezę w potoku WebSocket — wymaga to innego podejścia niż standardowe API REST. Skill dokumentuje cztery główne pułapki: budżet opóźnień głosu, przejścia stanów połączeń, konfigurację jakości audio i obsługę błędów. Użyj podczas przeglądu kodu, wdrażania nowych deweloperów lub audytu istniejących integracji.

1. Zainstaluj skill w swoim środowisku Claude Code, upewniając się, że masz dostęp do narzędzi Read i Grep do analizy kodu.

2. Przygotuj kod Retell AI do przeglądu — umieść pliki integracji w dostępnym katalogu lub przesłij je jako kontekst.

3. Wyzwól skill frazami takimi jak "retellai mistakes", "retellai anti-patterns", "retellai pitfalls" lub "retellai code review", podając konkretny kod lub opis problemu.

4. Skill przeanalizuje kod pod kątem czterech głównych anty-wzorców: synchronicznych zapytań do bazy danych w ścieżce krytycznej (webhook handler musi odpowiedzieć w poniżej 1 sekundy), braku śledzenia aktywnych połączeń i czyszczenia zasobów na zdarzeniach call_ended, niedokonfigurowanej jakości audio (brak ustawień ambient_sound i responsiveness), oraz słabej obsługi przerwań połączeń.

5. Przejrzyj rekomendacje — skill pokaże złe i dobre przykłady kodu dla każdego anty-wzorca, wyjaśniając, dlaczego każdy powoduje problemy w produkcji.

6. Zastosuj sugerowane poprawki: pre-compute kontekst, cache'uj odpowiedzi w Redis, odłóż ciężkie operacje do zadań w tle, śledź stany połączeń w Map, uruchom timer czyszczący dla pominięcia zdarzeń call_ended, i skonfiguruj parametry audio dla lepszego rozpoznawania mowy.