Readme AR

ملاحظة: تمت ترجمة هذا الملف آليًا. نرحب بتحسينات الترجمة!

</picture></a>

أوبيك

<a href="#-llm-as-a-judge-metrics">🧑‍⚖️ LLM كقاضي</a> • <a href="#-evaluating-your-llm-application">🔍 تقييم طلبك</a> • <a href="#-star-us-on-github">⭐ ميزنا</a> • <a href="#-contributing">🤝 المساهمة</a>

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

🚀 ما هو أوبيك؟

Opik (تم إنشاؤه بواسطة Comet) عبارة عن منصة مفتوحة المصدر مصممة لتبسيط دورة الحياة الكاملة لتطبيقات LLM. إنه يمكّن المطورين من تقييم واختبار ومراقبة وتحسين نماذجهم وأنظمتهم الوكيلة. تشمل العروض الرئيسية ما يلي:

• ** إمكانية المراقبة الشاملة **: التتبع العميق لمكالمات LLM وتسجيل المحادثات ونشاط الوكيل.
• التقييم المتقدم: تقييم سريع قوي، ماجستير في القانون كقاض، وإدارة التجربة.
• جاهز للإنتاج: لوحات معلومات مراقبة قابلة للتطوير وقواعد تقييم عبر الإنترنت للإنتاج.
• Opik Agent Optimizer: مجموعة SDK مخصصة ومجموعة من أدوات التحسين لتحسين المطالبات والوكلاء.
• Opik Guardrails: ميزات تساعدك على تنفيذ ممارسات الذكاء الاصطناعي الآمنة والمسؤولة.

تشمل القدرات الرئيسية ما يلي:

• ** التطوير والتتبع: **

• تتبع جميع مكالمات وتتبعات LLM بسياق تفصيلي أثناء التطوير وفي الإنتاج (Quickstart).

• عمليات تكامل واسعة النطاق مع جهات خارجية لسهولة المراقبة: التكامل بسلاسة مع قائمة متزايدة من أطر العمل، ودعم العديد من أكبرها وأكثرها شيوعًا محليًا (بما في ذلك الإضافات الحديثة مثل Google ADK، Autogen، و Flowise AI). (عمليات التكامل)

• قم بتعليق الآثار والامتدادات بدرجات التعليقات عبر ملف Python SDK أو UI.

• قم بتجربة المطالبات والنماذج في ساحة اللعب السريعة.

• التقييم والاختبار:

• أتمتة تقييم طلب LLM الخاص بك باستخدام Datasets و التجارب.

• الاستفادة من مقاييس LLM-as-a-judge القوية للمهام المعقدة مثل اكتشاف الهلوسة، الإشراف، وتقييم RAG (الإجابة الصلة، السياق الدقة).

• دمج التقييمات في مسار CI/CD الخاص بك من خلال تكامل PyTest.

• مراقبة الإنتاج وتحسينه:

• تسجيل كميات كبيرة من آثار الإنتاج: تم تصميم Opik على نطاق واسع (أكثر من 40 مليون أثر/يوم).

• مراقبة نتائج التعليقات وأعداد التتبع واستخدام الرموز المميزة بمرور الوقت في Opik Dashboard.

• استخدم قواعد التقييم عبر الإنترنت مع مقاييس LLM-as-a-Judge لتحديد مشكلات الإنتاج.

• الاستفادة من Opik Agent Optimizer وOpik Guardrails لتحسين وتأمين تطبيقات LLM الخاصة بك في الإنتاج بشكل مستمر.

[!TIP] إذا كنت تبحث عن ميزات لا تتوفر في Opik اليوم، فيرجى رفع طلب ميزة جديدة 🚀

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

🛠️ تثبيت خادم Opik

احصل على خادم Opik الخاص بك قيد التشغيل خلال دقائق. اختر الخيار الذي يناسب احتياجاتك:

الخيار 1: سحابة Comet.com (الأسهل والموصى بها)

قم بالوصول إلى Opik على الفور دون أي إعداد. مثالية للبدء السريع والصيانة الخالية من المتاعب.

👉 إنشاء حساب Comet المجاني الخاص بك

الخيار 2: المضيف الذاتي Opik للتحكم الكامل

قم بنشر Opik في بيئتك الخاصة. اختر بين Docker للإعدادات المحلية أو Kubernetes لقابلية التوسع.

الاستضافة الذاتية مع Docker Compose (للتطوير المحلي والاختبار)

هذه هي أبسط طريقة لتشغيل مثيل Opik المحلي. لاحظ نص التثبيت الجديد ./opik.sh:

في بيئة Linux أو Mac:

# 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

في بيئة ويندوز:

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

** ملفات تعريف الخدمة للتطوير **

تدعم البرامج النصية لتثبيت Opik الآن ملفات تعريف الخدمة لسيناريوهات التطوير المختلفة:

# 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

استخدم خيارات --help أو --info لاستكشاف المشكلات وإصلاحها. تضمن ملفات Dockerfiles الآن تشغيل الحاويات كمستخدمين غير جذريين لتعزيز الأمان. بمجرد الانتهاء من تشغيل كل شيء، يمكنك الآن زيارة localhost:5173 على متصفحك! للحصول على تعليمات تفصيلية، راجع دليل النشر المحلي.

الاستضافة الذاتية مع Kubernetes & Helm (عمليات النشر القابلة للتوسع)

بالنسبة للإنتاج أو عمليات النشر المستضافة ذاتيًا على نطاق واسع، يمكن تثبيت Opik على مجموعة Kubernetes باستخدام مخطط Helm الخاص بنا. انقر على الشارة للحصول على دليل تثبيت Kubernetes باستخدام Helm الكامل.

[!IMPORTANT] ** تغييرات الإصدار 1.7.0 **: يرجى مراجعة سجل التغيير للحصول على التحديثات المهمة والتغييرات العاجلة.

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

💻 عميل Opik SDK

توفر Opik مجموعة من مكتبات العملاء وREST API للتفاعل مع خادم Opik. يتضمن ذلك حزم SDK لـ Python وTypeScript وRuby (عبر OpenTelemetry)، مما يسمح بالتكامل السلس في سير العمل لديك. للحصول على مراجع تفصيلية لواجهة برمجة التطبيقات (API) وSDK، راجع الوثائق المرجعية لعميل Opik.

البداية السريعة لـ Python SDK

للبدء باستخدام Python SDK:

تثبيت الحزمة:

# install using pip
pip install opik

# or install with uv
uv pip install opik

قم بتكوين python SDK عن طريق تشغيل الأمر opikconfig، والذي سيطالبك بعنوان خادم Opik الخاص بك (للمثيلات المستضافة ذاتيًا) أو مفتاح API ومساحة العمل (لـ Comet.com):

opik configure

[!TIP] يمكنك أيضًا الاتصال بـ opik.configure(use_local=True) من كود Python الخاص بك لتكوين SDK ليتم تشغيله على تثبيت محلي مستضاف ذاتيًا، أو توفير مفتاح واجهة برمجة التطبيقات وتفاصيل مساحة العمل مباشرةً لموقع Comet.com. ارجع إلى وثائق Python SDK لمزيد من خيارات التكوين.

أنت الآن جاهز لبدء تسجيل التتبعات باستخدام Python SDK.

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

📝 تسجيل الآثار بالتكاملات

أسهل طريقة لتسجيل التتبعات هي استخدام إحدى عمليات التكامل المباشرة لدينا. يدعم Opik مجموعة واسعة من أطر العمل، بما في ذلك الإضافات الحديثة مثل Google ADK و Autogen و AG2 و Flowise AI:

[!TIP] إذا لم يكن إطار العمل الذي تستخدمه مدرجًا أعلاه، فلا تتردد في فتح مشكلة أو إرسال علاقة عامة مع التكامل.

إذا كنت لا تستخدم أيًا من أطر العمل المذكورة أعلاه، فيمكنك أيضًا استخدام أداة تزيين الوظائف track لـ تسجيل التتبعات:

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] يمكن استخدام مصمم المسار جنبًا إلى جنب مع أي من عمليات التكامل لدينا ويمكن استخدامه أيضًا لتتبع استدعاءات الوظائف المتداخلة.

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

🧑‍⚖️ LLM كمقاييس القاضي

يتضمن Python Opik SDK عددًا من LLM كمقاييس تحكيمية لمساعدتك في تقييم تطبيق LLM الخاص بك. تعرف على المزيد حول هذا الموضوع في وثائق المقاييس.

لاستخدامها، ما عليك سوى استيراد المقياس ذي الصلة واستخدام وظيفة "النتيجة":

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 أيضًا عددًا من المقاييس الإرشادية المعدة مسبقًا بالإضافة إلى القدرة على إنشاء المقاييس الخاصة بك. تعرف على المزيد حول ذلك في وثائق المقاييس.

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

🔍 تقييم طلبات الحصول على ماجستير إدارة الأعمال

يتيح لك Opik تقييم تطبيق LLM الخاص بك أثناء التطوير من خلال Datasets و التجارب. توفر لوحة معلومات Opik مخططات محسنة للتجارب ومعالجة أفضل للآثار الكبيرة. يمكنك أيضًا إجراء التقييمات كجزء من مسار CI/CD الخاص بك باستخدام تكامل PyTest.

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

⭐ قم بتمييزنا على GitHub

إذا وجدت Opik مفيدًا، فيرجى التفكير في منحنا نجمة! يساعدنا دعمك على تنمية مجتمعنا ومواصلة تحسين المنتج.

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

🤝 المساهمة

هناك طرق عديدة للمساهمة في Opik:

• إرسال تقارير الأخطاء وطلبات الميزات
• راجع الوثائق وأرسل طلبات السحب لتحسينها
• التحدث أو الكتابة عن Opik وإعلامنا
• التصويت لصالح طلبات الميزات الشائعة لإظهار دعمك

لمعرفة المزيد حول كيفية المساهمة في Opik، يرجى الاطلاع على إرشادات المساهمة.