Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

python-sdk

/python-sdk

Podpowiada przy pracy nad SDK Pythona dla Opik: API, integracjami i przetwarzaniem komunikatów.

Repozytorium
opik ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Podpowiada przy pracy nad SDK Pythona dla Opik: API, integracjami i przetwarzaniem komunikatów.

Oryginalny opis (EN)

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

Jak działa

  1. Three-Layer Architecture
  2. Critical Gotchas
  3. Integration Patterns
  4. Dependency Policy
  5. Batching System
  6. API Method Naming
  7. Reference Files
Sekcje z nagłówków SKILL.md, w oryginale · 105 linii, 303 słów
Podgląd SKILL.md
---
name: python-sdk
description: Python SDK patterns for Opik. Use when working in sdks/python, on SDK APIs, integrations, or message processing.
---

# Python SDK

## Three-Layer Architecture
```
Layer 1: Public API      (opik.Opik, @opik.track)
    ↓
Layer 2: Message Processing   (queue, batching, retry)
    ↓
Layer 3: REST Client     (OpikApi, HTTP)
```

## Critical Gotchas

### Flush Before Exit
```python
# ✅ REQUIRED for async operations
client = opik.Opik()
# ... tracing operations ...
client.flush()  # Must call before exit!
```

### Async vs Sync Operations

**Async (via message queue)** - fire-and-forget:
- `trace()`, `span()`
- `log_traces_feedback_scores()`
- `experiment.insert()`

**Sync (blocking, returns data)**:
- `create_dataset()`, `get_dataset()`
- `create_prompt()`, `get_prompt()`
- `search_traces()`, `search_spans()`

### Lazy Imports for Integrations
```python
# ✅ GOOD - integration files assume dependency exists
import anthropic  # Only imported when user uses integration

# ❌ BAD - importing at package level
from opik.integrations import anthropic  # Would fail if not installed
```

## Integration Patterns

### Pattern Selection
```
Library has callbacks? → Pure Callback (LangChain, LlamaIndex)
No callbacks?         → Method Patching (OpenAI, Anthropic)
Callbacks unreliable? → Hybrid (ADK)
```

### Method Patching (OpenAI, Anthropic)
```python
from opik.integrations.anthropic import track_anthropic

client = anthropic.Anthropic()
tracked_client = track_anthropic(client)  # Wraps methods
```

### Callback-Based (LangChain)
```python
from opik.integrations.langchain import OpikTracer

tracer = OpikTracer()
chain.invoke(input, config={"callbacks": [tracer]})
```

### Decorator-Based
```python
@opik.track
def my_function(input: str) -> str:
    # Auto-creates span, captures input/output
    return process(input)
```

## Dependency Policy
- Avoid adding new dependencies
- Use conditional imports for integrations
- Keep version bounds flexible: `>=2.0.0,<3.0.0`

## Batching System
Messages batch together for efficiency:
- Flush triggers: time (1s), size (100), memory (50MB), manual
- Reduces HTTP overhead significantly

## API Method Naming
```python
# CRUD: create/get/list/update/delete
client.create_experiment(name="exp")
client.get_dataset(name="ds")

# Search for complex queries
client.search_spans(project_name="proj")
client.search_traces(project_name="proj")

# Batch for bulk operations
client.batch_create_items(...)
```

## Reference Files
- [testing.md](testing.md) - fake_backend, verifiers, test naming
- [error-handling.md](error-handling.md) - Exception hierarchy, MetricComputationError
- [good-code.md](good-code.md) - Access control, imports, factories, DI
Pliki w paczce (5)
  • SKILL.md 3 KB
  • error-handling.md 2 KB
  • good-code.md 4 KB
  • testing.md 5 KB
  • agents/refactor-helper.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie python-sdk.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 8f80ed086875 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 96typescript-sdk
    Opisuje wzorce SDK TypeScript dla Opik i pomaga przy pracy w katalogu sdks/typescript.
  • 100opik-integrations
    Buduje, aktualizuje, testuje i dokumentuje integracje SDK Opik w Pythonie i TypeScript, w tym sprawdza, czy integracja poprawnie loguje ślady.
  • 90opik-integrations-auditor
    Audytuje i porównuje integracje Opik w SDK Python i TypeScript oraz w backendzie OTEL, a także pisze dokumentację.
  • 96dataverse-python-sdk
    Pomaga korzystać z SDK Dataverse dla Pythona przy pisaniu i poprawianiu kodu integracji.
  • 100opik
    Objaśnia SDK Opik: tracing, typy spanów, integracje z frameworkami, wątki i bibliotekę promptów w Pythonie, TypeScript i REST.
  • 100opik
    Objaśnia SDK Opik: tracing, typy spanów, integracje z frameworkami, wątki i bibliotekę promptów w Pythonie, TypeScript i REST.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.