python-sdk
/python-sdk
Podpowiada przy pracy nad SDK Pythona dla Opik: API, integracjami i przetwarzaniem komunikatów.
- Autor
- comet-ml ↗
- Repozytorium
- opik ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
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
- Three-Layer Architecture
- Critical Gotchas
- Integration Patterns
- Dependency Policy
- Batching System
- API Method Naming
- Reference Files
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.