Readme TR

Not: Bu dosya makine tarafından çevrilmiştir. Çeviri iyileştirmelerine katkılarınız memnuniyetle karşılanır!

</resim></a>

Opik

<a href="#-llm-as-a-judge-metrics">🧑‍⚖️ Hakim Olarak Yüksek Lisans</a> • <a href="#-evaluating-your-llm-application">🔍 Başvurunuzu Değerlendirme</a> • <a href="#-star-us-on-github">⭐ Bize Yıldız Verin</a> • <a href="#-contributing">🤝 Katkıda Bulunma</a>

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

🚀 Opik Nedir?

Opik (Comet) tarafından oluşturulmuştur, LLM uygulamalarının tüm yaşam döngüsünü kolaylaştırmak için tasarlanmış açık kaynaklı bir platformdur. Geliştiricilere modellerini ve aracı sistemlerini değerlendirme, test etme, izleme ve optimize etme yetkisi verir. Anahtar teklifler şunları içerir:

• Kapsamlı Gözlemlenebilirlik: LLM çağrılarının, konuşma günlüğünün ve temsilci etkinliğinin derinlemesine izlenmesi.
• Gelişmiş Değerlendirme: Güçlü anında değerlendirme, yargıç olarak Yüksek Lisans ve deney yönetimi.
• Üretime Hazır: Ölçeklenebilir izleme kontrol panelleri ve üretim için çevrimiçi değerlendirme kuralları.
• Opik Agent Optimizer: İstemleri ve aracıları geliştirmek için özel SDK ve optimize ediciler seti.
• Opik Guardrails: Güvenli ve sorumlu yapay zeka uygulamalarını hayata geçirmenize yardımcı olacak özellikler.

Temel yetenekler şunları içerir:

• Geliştirme ve İzleme:

• Geliştirme ve üretim sırasında tüm LLM çağrılarını ve izlemelerini ayrıntılı bağlamla takip edin (Hızlı Başlangıç).

• Kolay gözlemlenebilirlik için kapsamlı 3. taraf entegrasyonları: En büyük ve en popüler çerçevelerin çoğunu yerel olarak destekleyen (Google ADK, Autogen ve Flowise AI gibi son eklemeler dahil) büyüyen çerçeve listesiyle sorunsuz bir şekilde entegre olun. (Entegrasyonlar)

• Python aracılığıyla izlere ve yayılmalara geri bildirim puanlarıyla açıklama ekleyin SDK veya Kullanıcı arayüzü.

• Prompt Playground'daki istemler ve modellerle denemeler yapın.

• Değerlendirme ve Test:

• LLM başvuru değerlendirmenizi Datasets ile otomatikleştirin ve Deneyler.

• Halüsinasyon tespiti gibi karmaşık görevler için güçlü Yargıç Olarak Yüksek Lisans metriklerinden yararlanın, moderation ve RAG değerlendirmesi (Answer Uygunluk, Bağlam Hassasiyet).

• PyTest entegrasyonumuzla değerlendirmeleri CI/CD ardışık düzeninize entegre edin.

• Üretim İzleme ve Optimizasyon:

• Yüksek hacimli üretim izlerini günlüğe kaydedin: Opik ölçek için tasarlanmıştır (günde 40 milyonun üzerinde iz).

• Opik Kontrol Panelinden geri bildirim puanlarını, iz sayılarını ve zaman içindeki jeton kullanımını izleyin.

• Üretim sorunlarını belirlemek için LLM-as-a-Judge metrikleriyle Çevrimiçi Değerlendirme Kurallarını kullanın.

• Üretimdeki LLM uygulamalarınızı sürekli olarak iyileştirmek ve güvence altına almak için Opik Agent Optimizer ve Opik Guardrails'ten yararlanın.

[!TIP] Opik'in bugün sahip olmadığı özellikleri arıyorsanız lütfen yeni bir Özellik isteği 🚀

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

🛠️ Opik Sunucu Kurulumu

Opik sunucunuzu dakikalar içinde çalışır hale getirin. İhtiyaçlarınıza en uygun seçeneği seçin:

Seçenek 1: Comet.com Bulutu (En Kolay ve Önerilen)

Opik'e hiçbir kurulum yapmadan anında erişin. Hızlı başlatma ve sorunsuz bakım için idealdir.

👉 Ücretsiz Comet hesabınızı oluşturun

Seçenek 2: Tam Kontrol için Kendi Kendine Barındıran Opik

Opik'i kendi ortamınızda konuşlandırın. Yerel kurulumlar için Docker'ı veya ölçeklenebilirlik için Kubernetes'i seçin.

Docker Compose ile Kendi Kendine Barındırma (Yerel Geliştirme ve Test için)

Bu, yerel bir Opik örneğini çalıştırmanın en basit yoludur. Yeni ./opik.sh kurulum komut dosyasına dikkat edin:

Linux veya Mac Ortamında:

# 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

Windows Ortamında:

# 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"

Geliştirmeye Yönelik Hizmet Profilleri

Opik kurulum komut dosyaları artık farklı geliştirme senaryolarına yönelik hizmet profillerini destekliyor:

# 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

Sorunları gidermek için "--help" veya "--info" seçeneklerini kullanın. Dockerfiles artık gelişmiş güvenlik için konteynerlerin root olmayan kullanıcılar olarak çalışmasını sağlıyor. Her şey hazır ve çalışır durumda olduğunda, artık tarayıcınızda localhost:5173 adresini ziyaret edebilirsiniz! Ayrıntılı talimatlar için Yerel Dağıtım Kılavuzuna bakın.

Kubernetes ve Helm ile Kendi Kendine Barındırma (Ölçeklenebilir Dağıtımlar için)

Üretim veya daha büyük ölçekli kendi kendine barındırılan dağıtımlar için Opik, Helm grafiğimizi kullanarak bir Kubernetes kümesine kurulabilir. Helm Kullanarak Kubernetes Kurulum Kılavuzu için rozeti tıklayın.

[!IMPORTANT] Sürüm 1.7.0 Değişiklikleri: Önemli güncellemeler ve son değişiklikler için lütfen changelog'u kontrol edin.

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

💻 Opik İstemci SDK'sı

Opik, Opik sunucusuyla etkileşime geçmek için bir istemci kitaplıkları paketi ve bir REST API sağlar. Buna Python, TypeScript ve Ruby (OpenTelemetry aracılığıyla) için SDK'lar dahildir ve iş akışlarınızla kusursuz entegrasyona olanak tanır. Ayrıntılı API ve SDK referansları için Opik İstemci Referans Belgelerine bakın.

Python SDK Hızlı Başlangıç

Python SDK'yı kullanmaya başlamak için:

Paketi yükleyin:

# install using pip
pip install opik

# or install with uv
uv pip install opik

Python SDK'sını, sizden Opik sunucu adresinizi (kendi kendine barındırılan örnekler için) veya API anahtarınızı ve çalışma alanınızı (Comet.com için) isteyecek olan "opik yapılandırma" komutunu çalıştırarak yapılandırın:

opik configure

[!TIP] SDK'yı yerel olarak kendi kendine barındırılan bir kurulumda çalışacak şekilde yapılandırmak için Python kodunuzdan opik.configure(use_local=True) çağrısını da yapabilirsiniz veya doğrudan Comet.com için API anahtarı ve çalışma alanı ayrıntılarını sağlayabilirsiniz. Daha fazla yapılandırma seçeneği için Python SDK belgelerine bakın.

Artık Python SDK kullanarak izleri günlüğe kaydetmeye başlamaya hazırsınız.

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

📝 Entegrasyonlarla İzlerin Günlüğe Kaydedilmesi

İzleri kaydetmenin en kolay yolu doğrudan entegrasyonlarımızdan birini kullanmaktır. Opik, Google ADK, Autogen, AG2 ve Flowise AI gibi son eklemeler de dahil olmak üzere çok çeşitli çerçeveleri destekler:

[!TIP] Kullandığınız çerçeve yukarıda listelenmiyorsa bir sorun açmaktan veya entegrasyonla ilgili bir PR göndermekten çekinmeyin.

Yukarıdaki çerçevelerden herhangi birini kullanmıyorsanız, izleri günlüğe kaydetmek için "izleme" işlevi dekoratörünü de kullanabilirsiniz:

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] Parça dekoratörü herhangi bir entegrasyonumuzla birlikte kullanılabilir ve aynı zamanda iç içe geçmiş işlev çağrılarını izlemek için de kullanılabilir.

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

🧑‍⚖️ Hakim Olarak Yüksek Lisans ölçümleri

Python Opik SDK'sı, LLM başvurunuzu değerlendirmenize yardımcı olacak bir dizi LLM değerlendirme ölçütü içerir. Bu konu hakkında daha fazla bilgiyi metrik belgelerine bakarak öğrenebilirsiniz.

Bunları kullanmak için ilgili metriği içe aktarmanız ve "puan" işlevini kullanmanız yeterlidir:

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 ayrıca bir dizi önceden oluşturulmuş buluşsal ölçümün yanı sıra kendi ölçümünüzü oluşturma yeteneğini de içerir. Bu konu hakkında daha fazla bilgiyi metrik belgelerine bakarak öğrenebilirsiniz.

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

🔍 Yüksek Lisans Başvurularınızı Değerlendirme

Opik, LLM başvurunuzu geliştirme sırasında Datasets aracılığıyla değerlendirmenize olanak tanır ve Deneyler. Opik Dashboard, deneyler ve büyük izlerin daha iyi işlenmesi için geliştirilmiş grafikler sunar. Ayrıca PyTest entegrasyonumuzu kullanarak CI/CD ardışık düzeninizin bir parçası olarak değerlendirmeler çalıştırabilirsiniz.

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

⭐ GitHub'da Bize Yıldız Verin

Opik'i yararlı buluyorsanız lütfen bize bir yıldız vermeyi düşünün! Desteğiniz topluluğumuzu büyütmemize ve ürünü geliştirmeye devam etmemize yardımcı oluyor.

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

🤝 Katkıda Bulunmak

Opik'e katkıda bulunmanın birçok yolu vardır:

• Hata raporlarını ve özellik isteklerini gönderin
• Belgeleri inceleyin ve geliştirmek için Çekme İsteklerini gönderin
• Opik hakkında konuşmak veya yazmak ve bize bilgi vermek
• Desteğinizi göstermek için popüler özellik isteklerine olumlu oy verme

Opik'e nasıl katkıda bulunacağınız hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma yönergelerimize bakın.