python-sdk

Python SDK patterns for Opik. Use when working in sdks/python, on SDK APIs, integrations, or message processing.

1. Zainstaluj Opik SDK dla Pythona i upewnij się, że masz dostęp do repozytorium comet-ml/opik. Skill zawiera wzorce dla trzech warstw architektury: publicznego API (opik.Opik, @opik.track), przetwarzania wiadomości (queue, batching, retry) oraz REST client.
2. Wybierz odpowiedni wzorzec integracji na podstawie biblioteki, którą używasz: jeśli biblioteka ma callbacks (LangChain, LlamaIndex), użyj wzorca callback-based; jeśli nie ma callbacks (OpenAI, Anthropic), zastosuj method patching; jeśli callbacks są zawodne, wybierz podejście hybrydowe.
3. Dla method patchingu zaimportuj funkcję track z odpowiedniego modułu integracji (np. track_anthropic z opik.integrations.anthropic), a następnie opakowaj klienta: tracked_client = track_anthropic(client). To automatycznie będzie śledzić wywołania metod.
4. Dla callback-based integracji utwórz instancję trackera (np. OpikTracer z opik.integrations.langchain) i przekaż go w konfiguracji: chain.invoke(input, config={"callbacks": [tracer]}).
5. Jeśli używasz dekoratora @opik.track, opakowuj funkcje, które chcesz śledzić — automatycznie utworzy spany i przechwyci input/output bez dodatkowego kodu.
6. Pamiętaj, że operacje takie jak trace(), span() i log_traces_feedback_scores() są asynchroniczne (fire-and-forget), podczas gdy create_dataset(), get_dataset(), search_traces() są synchroniczne i blokują. Zawsze wywołaj client.flush() przed wyjściem z programu, aby upewnić się, że wszystkie asynchroniczne operacje zostały przetworzone.