perplexity-known-pitfalls

Umiejętność do identyfikacji błędów i anty-wzorców w kodzie Perplexity. Perplexity Sonar API wykonuje wyszukiwanie w sieci dla każdego zapytania — to fundamentalnie różni się od standardowych chatbotów. Skill wskazuje typowe pułapki: używanie API do zadań, które nie wymagają wyszukiwania (marnowanie pieniędzy), ignorowanie cytowań zwracanych przez API, oraz błędne parsowanie struktury odpowiedzi. Przydatna podczas przeglądu kodu, wdrażania nowych developerów lub audytu istniejących integracji pod kątem zgodności z best practices.

1. Zainstaluj skill w swoim środowisku Claude Code, Codex lub OpenClaw, upewniając się że masz skonfigurowany klucz API Perplexity i rozumiesz format OpenAI-compatible chat endpoint. 2. Wyzwól skill frazami takimi jak "perplexity mistakes", "perplexity anti-patterns", "perplexity pitfalls", "perplexity code review" lub "perplexity gotchas" podczas przeglądania kodu. 3. Skill przeanalizuje Twój kod i zidentyfikuje główne błędy: używanie Perplexity jako zwykłego chatbota do zadań bez potrzeby wyszukiwania (co marnotrawnie zużywa budżet API), oraz ignorowanie pola citations zwracanego przez API — cytowania znajdują się na poziomie top-level odpowiedzi, nie wewnątrz choices. 4. Zwróć uwagę na strukturę odpowiedzi: zawartość wiadomości znajduje się w data["choices"][0]["message"]["content"], a cytowania w data.get("citations", []) — to częsty błąd w parsowaniu. 5. Wykorzystuj wyszukiwanie sieciowe Perplexity tylko dla zapytań, które rzeczywiście tego wymagają, na przykład do pozyskania najnowszych informacji o wydaniach produktów lub zmianach w branży. 6. Jeśli przeglądasz istniejącą integrację, skill pomoże Ci zweryfikować czy cytowania są prawidłowo wyświetlane użytkownikom zamiast surowych znaczników [1], [2].