Readme DE

Hinweis: Diese Datei wurde automatisch übersetzt. Verbesserungen der Übersetzung sind willkommen!

    </picture></a>
    

    Opik: Open-Source-LLM-Observability, -Evaluierung & AI-Agent-Tracing
</div>

<a href="#-llm-as-a-judge-metrics">🧑‍⚖️ LLM als Judge</a> • <a href="#-evaluating-your-llm-application">🔍 Ihre Anwendung evaluieren</a> • <a href="#-star-us-on-github">⭐ Sternchen für uns</a> • <a href="#-contributing">🤝 Mitwirken</a>

<a id="-what-is-opik"></a>

🚀 Was ist Opik?

Opik deckt den gesamten Lebenszyklus von LLM-Anwendungen ab, vom ersten Trace in der Entwicklung bis zur Produktionsüberwachung, für Teams, die LLM-Apps und AI-Agenten entwickeln. Zu den wichtigsten Angeboten gehören:

• AI-Agent-Tracing & -Observability: Tiefgehendes Tracing von LLM-Aufrufen, Protokollierung von Konversationen und Agentenaktivität, mit vollständigen Trace-Bäumen für mehrstufige Agenten und Tool-Aufrufe.
• LLM-Evaluierung: Datasets, Experimente und LLM-as-a-Judge-Metriken zur Halluzinationserkennung, Moderation und RAG-Bewertung.
• Prompt- & Agenten-Optimierung: Das Opik Agent Optimizer SDK zur Verbesserung von Prompts und Agenten.
• Produktionsreife Überwachung: Skalierbare Dashboards und Online-Evaluierungsregeln.
• Opik Guardrails: Funktionen, die Ihnen helfen, sichere und verantwortungsvolle AI-Praktiken umzusetzen.
• CI/CD-Evaluierung: Eine PyTest-Integration zum Testen von LLM-Pipelines bei jedem Commit.

Zu den wichtigsten Fähigkeiten gehören:

• Entwicklung & Tracing:

  • Verfolgen Sie alle LLM-Aufrufe und Traces mit detailliertem Kontext während der Entwicklung und in der Produktion (Schnellstart).
  • Umfangreiche Integrationen von Drittanbietern für einfache Observability: Nahtlose Integration mit einer wachsenden Liste von Frameworks, wobei viele der größten und beliebtesten nativ unterstützt werden (einschließlich neuerer Ergänzungen wie Google ADK, Autogen und Flowise AI). (Integrationen)
  • Annotieren Sie Traces und Spans mit Feedback-Bewertungen über das Python SDK oder die Benutzeroberfläche.
  • Experimentieren Sie mit Prompts und Modellen im Prompt Playground.

• Evaluierung & Testing:

  • Automatisieren Sie die Evaluierung Ihrer LLM-Anwendung mit Datasets und Experimenten.
  • Nutzen Sie leistungsstarke LLM-as-a-Judge-Metriken für komplexe Aufgaben wie Halluzinationserkennung, Moderation und RAG-Bewertung (Answer Relevance, Context Precision).
  • Integrieren Sie Evaluierungen in Ihre CI/CD-Pipeline mit unserer PyTest-Integration.

• Produktionsüberwachung & -optimierung:

  • Protokollieren Sie große Mengen an Produktions-Traces: Opik ist für Skalierung ausgelegt (über 40 Mio. Traces/Tag).
  • Überwachen Sie Feedback-Bewertungen, Trace-Anzahlen und Token-Nutzung im Zeitverlauf im Opik-Dashboard.
  • Nutzen Sie Online-Evaluierungsregeln mit LLM-as-a-Judge-Metriken, um Produktionsprobleme zu identifizieren.
  • Nutzen Sie Opik Agent Optimizer und Opik Guardrails, um Ihre LLM-Anwendungen in der Produktion kontinuierlich zu verbessern und abzusichern.

Für wen es gedacht ist: ML-Ingenieure, die LLM-gestützte Agenten entwickeln, AI-Teams, die vom Prototyp zur Produktion übergehen, und Engineering-Teams, die Open-Source-Observability benötigen, die sie selbst hosten und in ihrer eigenen Umgebung betreiben können.

Warum Open Source hier wichtig ist: Opik ist Apache-2.0-lizenziert und kann kostenlos selbst gehostet werden: die vollständige Plattform, inklusive Backend, nicht nur ein Client-SDK. Das Repository enthält das Server-Backend, die Webanwendung, Tracing, Datasets, Experimente, Evaluierungen, Prompt-Management, Online-Evaluierung und Agenten-Optimierungskomponenten, alle unter Apache-2.0. Sie können LLM-Observability innerhalb Ihrer eigenen Infrastruktur betreiben, ohne dass Daten Ihre Umgebung verlassen und ohne dass ein Enterprise-Verkaufsgespräch erforderlich ist.

[!TIP] Wenn Sie nach Funktionen suchen, die Opik heute noch nicht bietet, erstellen Sie bitte einen neuen Feature-Request 🚀

<a id="-quick-start"></a>

⚡ Schnellstart

Installieren Sie das Python SDK und konfigurieren Sie es:

pip install opik
opik configure

Umschließen Sie eine beliebige Funktion mit dem @track-Decorator, um mit der Protokollierung von Traces zu beginnen:

from opik import track

@track
def my_function(input: str) -> str:
    return input

Jeder Aufruf von my_function wird nun in Opik protokolliert, einschließlich verschachtelter Aufrufe, sodass dies für vollständige Agenten- und Pipeline-Traces funktioniert, nicht nur für einzelne LLM-Aufrufe. Im Schnellstart-Leitfaden finden Sie das TypeScript SDK und weitere Einrichtungsoptionen.

<a id="-how-opik-compares"></a>

📊 Wie schneidet Opik im Vergleich ab?

Opik konkurriert in der Kategorie LLM-Observability / AI-Agent-Evaluierung neben LangSmith, Arize (Phoenix und Arize AX), Weights & Biases (Weave), Langfuse und Braintrust.

Wann sich Teams für Opik entscheiden: Opiks vollständige Plattform für Observability, Evaluierung und Optimierung ist Apache-2.0-lizenziert und kann kostenlos selbst gehostet werden. Anders als bei geschlossenen Plattformen, deren Self-Hosted-Bereitstellung einen Enterprise-Plan erfordert, kann Opik ohne kommerzielle Lizenz bereitgestellt werden, und es ist Framework-agnostisch, sodass es Sie nicht an ein einzelnes Agenten-Ökosystem bindet. In der Tabelle oben sehen Sie, wo sich Self-Hosting und Lizenzierung bei den Alternativen unterscheiden.

<a id="-frequently-asked-questions"></a>

❓ Häufig gestellte Fragen

Ist Opik Open Source?

Opik ist unter Apache 2.0 lizenziert. Sein Server, seine Webanwendung und seine grundlegenden Observability- und Evaluierungsfunktionen können ohne kommerzielle Lizenz selbst gehostet werden.

Kann ich Opik selbst hosten?

Ja. Opik kann lokal oder in Ihrer eigenen Infrastruktur mithilfe der dokumentierten Self-Hosting-Optionen bereitgestellt werden.

Unterstützt Opik AI-Agent-Tracing?

Ja. Opik erfasst mehrstufige Traces, die LLM-Aufrufe, Tool-Ausführungen, Retrieval-Schritte und andere Agentenaktivitäten enthalten.

Unterstützt Opik LLM-Evaluierung?

Ja. Opik unterstützt Datasets, Experimente, codebasierte Metriken, LLM-as-a-Judge-Evaluierung und Online-Evaluierung.

Ist Opik an ein bestimmtes Agenten-Framework gebunden?

Nein. Opik ist Framework-agnostisch und unterstützt sein SDK, OpenTelemetry und framework-spezifische Integrationen.

<a id="%EF%B8%8F-opik-server-installation"></a>

🛠️ Opik-Server-Installation

Bringen Sie Ihren Opik-Server in wenigen Minuten zum Laufen. Wählen Sie die Option, die Ihren Anforderungen am besten entspricht:

Option 1: Comet.com Cloud (Am einfachsten & empfohlen)

Greifen Sie sofort auf Opik zu, ohne Einrichtung. Ideal für einen schnellen Start und wartungsfreien Betrieb.

👉 Erstellen Sie Ihr kostenloses Comet-Konto

Option 2: Opik selbst hosten für volle Kontrolle

Stellen Sie Opik in Ihrer eigenen Umgebung bereit. Wählen Sie zwischen Docker für lokale Setups oder Kubernetes für Skalierbarkeit.

Self-Hosting mit Docker Compose (für lokale Entwicklung & Tests)

Dies ist die einfachste Methode, um eine lokale Opik-Instanz zum Laufen zu bringen. Beachten Sie das neue Installationsskript ./opik.sh:

Unter Linux- oder Mac-Umgebung:

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
./opik.sh

Unter Windows-Umgebung:

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
powershell -ExecutionPolicy ByPass -c ".\\opik.ps1"

Service-Profile für die Entwicklung

Die Opik-Installationsskripte unterstützen jetzt Service-Profile für verschiedene Entwicklungsszenarien:

# Start full Opik suite (default behavior)
./opik.sh

# Start only infrastructure services (databases, caches etc.)
./opik.sh --infra

# Start infrastructure + backend services
./opik.sh --backend

# Enable guardrails with any profile
./opik.sh --guardrails # Guardrails with full Opik suite
./opik.sh --backend --guardrails # Guardrails with infrastructure + backend

Verwenden Sie die Optionen --help oder --info, um Probleme zu beheben. Die Dockerfiles stellen jetzt sicher, dass Container als Nicht-Root-Benutzer laufen, um die Sicherheit zu erhöhen. Sobald alles läuft, können Sie nun localhost:5173 in Ihrem Browser aufrufen! Ausführliche Anweisungen finden Sie im Leitfaden zur lokalen Bereitstellung.

Self-Hosting mit Kubernetes & Helm (für skalierbare Bereitstellungen)

Für Produktions- oder größere Self-Hosted-Bereitstellungen kann Opik mithilfe unseres Helm-Charts auf einem Kubernetes-Cluster installiert werden. Klicken Sie auf das Badge für den vollständigen Kubernetes-Installationsleitfaden mit Helm.

[!IMPORTANT] Änderungen in Version 1.7.0: Bitte prüfen Sie das Changelog auf wichtige Aktualisierungen und Breaking Changes.

<a id="-opik-client-sdk"></a>

💻 Opik-Client-SDK

Opik bietet eine Reihe von Client-Bibliotheken und eine REST-API zur Interaktion mit dem Opik-Server. Dazu gehören SDKs für Python, TypeScript und Ruby (über OpenTelemetry), die eine nahtlose Integration in Ihre Workflows ermöglichen. Ausführliche API- und SDK-Referenzen finden Sie in der Opik-Client-Referenzdokumentation.

Python-SDK-Schnellstart

So beginnen Sie mit dem Python SDK:

Installieren Sie das Paket:

# install using pip
pip install opik

# or install with uv
uv pip install opik

Konfigurieren Sie das Python SDK, indem Sie den Befehl opik configure ausführen, der Sie nach der Adresse Ihres Opik-Servers (für Self-Hosted-Instanzen) oder nach Ihrem API-Schlüssel und Workspace (für Comet.com) fragt:

opik configure

[!TIP] Sie können auch opik.configure(use_local=True) aus Ihrem Python-Code aufrufen, um das SDK für die Ausführung auf einer lokalen Self-Hosted-Installation zu konfigurieren oder API-Schlüssel und Workspace-Details direkt für Comet.com anzugeben. Weitere Konfigurationsoptionen finden Sie in der Python-SDK-Dokumentation.

Sie sind nun bereit, mit der Protokollierung von Traces über das Python SDK zu beginnen.

<a id="-logging-traces-with-integrations"></a>

📝 Traces mit Integrationen protokollieren

Der einfachste Weg, Traces zu protokollieren, ist die Verwendung einer unserer direkten Integrationen. Opik unterstützt eine breite Palette von Frameworks, einschließlich neuerer Ergänzungen wie Google ADK, Autogen, AG2 und Flowise AI:

[!TIP] Falls das von Ihnen verwendete Framework oben nicht aufgeführt ist, können Sie gerne ein Issue eröffnen oder einen PR mit der Integration einreichen.

Wenn Sie keines der oben genannten Frameworks verwenden, können Sie auch den Funktions-Decorator track verwenden, um Traces zu protokollieren:

import opik

opik.configure(use_local=True) # Run locally

@opik.track
def my_llm_function(user_question: str) -> str:
    # Your LLM code here

    return "Hello"

[!TIP] Der track-Decorator kann in Verbindung mit jeder unserer Integrationen verwendet werden und lässt sich auch zur Verfolgung verschachtelter Funktionsaufrufe einsetzen.

<a id="-llm-as-a-judge-metrics"></a>

🧑‍⚖️ LLM-as-a-Judge-Metriken

Das Python Opik SDK enthält eine Reihe von LLM-as-a-Judge-Metriken, die Ihnen bei der Evaluierung Ihrer LLM-Anwendung helfen. Erfahren Sie mehr darüber in der Metrik-Dokumentation.

Um sie zu verwenden, importieren Sie einfach die relevante Metrik und nutzen Sie die score-Funktion:

from opik.evaluation.metrics import Hallucination

metric = Hallucination()
score = metric.score(
    input="What is the capital of France?",
    output="Paris",
    context=["France is a country in Europe."]
)
print(score)

Opik enthält außerdem eine Reihe vorgefertigter heuristischer Metriken sowie die Möglichkeit, eigene zu erstellen. Erfahren Sie mehr darüber in der Metrik-Dokumentation.

<a id="-evaluating-your-llm-application"></a>

🔍 Ihre LLM-Anwendungen evaluieren

Mit Opik können Sie Ihre LLM-Anwendung während der Entwicklung anhand von Datasets und Experimenten evaluieren. Das Opik-Dashboard bietet verbesserte Diagramme für Experimente und einen besseren Umgang mit großen Traces. Sie können Evaluierungen auch als Teil Ihrer CI/CD-Pipeline mithilfe unserer PyTest-Integration ausführen.

<a id="-star-us-on-github"></a>

⭐ Geben Sie uns einen Stern auf GitHub

Wenn Sie Opik nützlich finden, geben Sie uns bitte einen Stern! Ihre Unterstützung hilft uns, unsere Community wachsen zu lassen und das Produkt weiter zu verbessern.

<a id="-contributing"></a>

🤝 Mitwirken

Es gibt viele Möglichkeiten, zu Opik beizutragen:

• Reichen Sie Fehlerberichte und Feature-Requests ein
• Prüfen Sie die Dokumentation und reichen Sie Pull-Requests ein, um sie zu verbessern
• Sprechen oder schreiben Sie über Opik und lassen Sie es uns wissen
• Stimmen Sie für beliebte Feature-Requests ab, um Ihre Unterstützung zu zeigen

Um mehr darüber zu erfahren, wie Sie zu Opik beitragen können, lesen Sie bitte unsere Beitragsrichtlinien.