phoenix-cli
Debuguj aplikacje LLM za pomocą wiersza poleceń – analizuj ślady, błędy i wydajność w czasie rzeczywistym.
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Phoenix CLI to narzędzie do debugowania aplikacji opartych na modelach językowych. Pozwala pobierać ślady wykonania, analizować błędy, przeglądać eksperymenty i badać zestawy danych bezpośrednio z terminala. Używaj go, gdy chcesz zbadać problemy z wydajnością LLM, przeanalizować dane śledzenia lub pracować z obserwowalnością Phoenix. Narzędzie obsługuje filtrowanie po statusie, rodzaju operacji, nazwie oraz okresie czasu, a wyniki można eksportować w formacie raw do dalszego przetwarzania.
Jak używać
Zainstaluj Phoenix CLI globalnie za pomocą npm lub użyj go bez instalacji poprzez npx @arizeai/phoenix-cli. Jeśli wolisz instalację globalną, uruchom npm install -g @arizeai/phoenix-cli, a następnie używaj polecenia px. W przeciwnym razie poprzedź każde polecenie prefiksem npx @arizeai/phoenix-cli.
Skonfiguruj zmienne środowiskowe, aby połączyć się z instancją Phoenix. Ustaw PHOENIX_HOST na adres serwera (np. http://localhost:6006), PHOENIX_PROJECT na nazwę projektu oraz PHOENIX_API_KEY, jeśli autoryzacja jest włączona. Eksportuj te zmienne w swoim terminalu lub dodaj je do pliku konfiguracyjnego.
Pobierz listę śladów wykonania za pomocą px trace list, dodając filtry takie jak --limit dla liczby wyników, --last-n-minutes dla zakresu czasu lub --format raw dla surowego JSON. Na przykład px trace list --limit 20 --format raw --no-progress wyświetli 20 ostatnich śladów.
Filtruj ślady po statusie błędu, aby znaleźć problematyczne wykonania. Użyj px trace list --format raw --no-progress | jq '.[] | select(.status == "ERROR")' aby wyświetlić tylko ślady ze statusem ERROR, lub sortuj po czasie trwania: px trace list --format raw --no-progress | jq 'sort_by(-.duration) | .[0:5]' dla pięciu najwolniejszych operacji.
Zbadaj szczegóły konkretnego śladu za pomocą px trace get
--format raw, a następnie przeanalizuj poszczególne operacje (spany) wewnątrz niego. Filtruj spany po rodzaju (np. --span-kind LLM), statusie (--status-code ERROR) lub nazwie (--name chat_completion) aby szybko zlokalizować problemy. Łącz wyniki z narzędziem jq do zaawansowanej analizy. Zawsze używaj flag --format raw --no-progress podczas piping do jq, aby uniknąć problemów z formatowaniem. Na przykład px span list --trace-id
--format raw --no-progress | jq . wyświetli wszystkie operacje dla danego śladu w strukturze JSON.