Skip to content

readme_AR.md

Latest commit

 

History

History
322 lines (237 loc) · 35 KB

readme_AR.md

File metadata and controls

322 lines (237 loc) · 35 KB

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

شعار Comet Opik
أوبيك

إمكانية مراقبة وتقييم وتحسين الذكاء الاصطناعي مفتوح المصدر

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

Python SDK الترخيص Build

موقع الويب • مجتمع Slack • Twitter • سجل التغيير • الوثائق


لقطة شاشة لمنصة Opik (thumbnail)

🚀 ما هو أوبيك؟

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 اليوم، فيرجى رفع طلب ميزة جديدة 🚀


🛠️ تثبيت خادم 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 الكامل.

Kubernetes

Important

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

💻 عميل 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.

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

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

التكامل الوصف التوثيق
أدك تسجيل التتبعات لـ Google Agent Development Kit (ADK) التوثيق
AG2 تسجيل التتبعات لمكالمات AG2 LLM التوثيق
جناح تسجيل التتبعات لمكالمات aisuite LLM التوثيق
أجنو تسجيل التتبعات لاستدعاءات إطار عمل تنسيق وكيل Agno التوثيق
انثروبي تسجيل التتبعات لمكالمات Anthropic LLM التوثيق
أوتوجين تسجيل التتبعات لسير عمل وكيل Autogen التوثيق
حجر الأساس تسجيل التتبعات لمكالمات Amazon Bedrock LLM التوثيق
بي آي (بايثون) تتبعات السجل لاستدعاءات إطار عمل وكيل BeeAI Python التوثيق
BeeAI (تايب سكريبت) تسجيل تتبعات لاستدعاءات إطار عمل وكيل BeeAI TypeScript التوثيق
بايت بلس تسجيل التتبعات لمكالمات BytePlus LLM التوثيق
عمال Cloudflare الذكاء الاصطناعي تسجيل التتبعات لمكالمات Cloudflare Workers AI التوثيق
كوهير تسجيل التتبعات لمكالمات Cohere LLM التوثيق
كرو آي تسجيل التتبعات لمكالمات CrewAI التوثيق
المؤشر تسجيل آثار محادثات المؤشر التوثيق
ديب سيك تسجيل تتبعات لمكالمات DeepSeek LLM التوثيق
ديفي تسجيل التتبعات لتشغيل وكيل Dify التوثيق
دسبي تسجيل التتبعات لتشغيل DSPy التوثيق
الألعاب النارية منظمة العفو الدولية تسجيل آثار مكالمات Fireworks AI LLM التوثيق
فلويز الذكاء الاصطناعي تسجيل التتبعات لمنشئ Flowise AI visual LLM التوثيق
الجوزاء (بيثون) تسجيل التتبعات لمكالمات Google Gemini LLM التوثيق
الجوزاء (تايب سكريبت) سجل تتبعات مكالمات Google Gemini TypeScript SDK التوثيق
جروك تسجيل تتبعات لمكالمات Groq LLM التوثيق
الدرابزين تسجيل التتبعات لعمليات التحقق من صحة Guardrails AI التوثيق
كومة قش سجل آثار مكالمات Haystack التوثيق
الميناء تتبعات السجل لتجارب تقييم معيار Harbour التوثيق
مدرس سجل تتبعات مكالمات LLM التي تم إجراؤها باستخدام Instructor التوثيق
لانج تشين (بيثون) تسجيل التتبعات لمكالمات LangChain LLM التوثيق
لانج تشين (JS/TS) تسجيل التتبعات لمكالمات LangChain JavaScript/TypeScript التوثيق
لانغغراف تتبعات السجل لعمليات تنفيذ LangGraph التوثيق
لانجفلو تسجيل تتبعات لـ Langflow visual AI builder التوثيق
لايت إل إل إم تسجيل التتبعات لاستدعاءات نموذج LiteLLM التوثيق
وكلاء LiveKit تسجيل التتبعات لاستدعاءات إطار عمل وكيل LiveKit Agents AI التوثيق
مؤشر اللاما تسجيل تتبعات لمكالمات LlamaIndex LLM التوثيق
ماسترا تسجيل التتبعات لاستدعاءات إطار عمل سير عمل Mastra AI التوثيق
Microsoft Agent Framework (بيثون) تسجيل التتبعات لمكالمات Microsoft Agent Framework التوثيق
Microsoft Agent Framework (.NET) تسجيل التتبعات لمكالمات Microsoft Agent Framework .NET التوثيق
ميسترال لمنظمة العفو الدولية تسجيل التتبعات لمكالمات Mistral AI LLM التوثيق
ن8ن تسجيل التتبعات لعمليات تنفيذ سير العمل n8n التوثيق
نوفيتا منظمة العفو الدولية تسجيل التتبعات لمكالمات Novita AI LLM التوثيق
أولاما تسجيل تتبعات لمكالمات Ollama LLM التوثيق
أوبن إيه آي (بيثون) تسجيل التتبعات لمكالمات OpenAI LLM التوثيق
OpenAI (JS/TS) تسجيل التتبعات لاستدعاءات OpenAI JavaScript/TypeScript التوثيق
وكلاء OpenAI تسجيل التتبعات لمكالمات OpenAI Agents SDK التوثيق
OpenClaw تسجيل التتبعات لتشغيلات وكلاء OpenClaw التوثيق
اوبن راوتر تسجيل التتبعات لمكالمات OpenRouter LLM التوثيق
القياس عن بعد مفتوح تسجيل التتبعات للمكالمات المدعومة من OpenTelemetry التوثيق
واجهة ويب مفتوحة تسجيل التتبعات لمحادثات OpenWebUI التوثيق
بيبيكات سجل آثار مكالمات وكيل الصوت في الوقت الحقيقي لـ Pipecat التوثيق
بريديباس تسجيل التتبعات لمكالمات Predibase LLM التوثيق
الذكاء الاصطناعي Pydantic تسجيل تتبعات مكالمات وكيل PydanticAI التوثيق
راجاس تتبعات السجل لتقييمات Ragas التوثيق
النواة الدلالية تسجيل التتبعات لاستدعاءات Microsoft Semantic Kernel التوثيق
سمولوجينتس سجل آثار وكلاء Smolagents التوثيق
الربيع لمنظمة العفو الدولية تتبعات السجل لاستدعاءات إطار عمل Spring AI التوثيق
وكلاء ستراندس تسجيل التتبعات لمكالمات وكلاء Strands التوثيق
معا منظمة العفو الدولية تسجيل التتبعات لمكالمات Together AI LLM التوثيق
فيرسيل AI SDK تسجيل التتبعات لمكالمات Vercel AI SDK التوثيق
فولتاجنت تسجيل التتبعات لاستدعاءات إطار عمل وكيل VoltAgent التوثيق
واتسون اكس تسجيل التتبعات لمكالمات IBM watsonx LLM التوثيق
xAI جروك تسجيل تتبعات لمكالمات xAI Grok LLM التوثيق

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

يمكن استخدام مصمم المسار جنبًا إلى جنب مع أي من عمليات التكامل لدينا ويمكن استخدامه أيضًا لتتبع استدعاءات الوظائف المتداخلة.

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

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

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

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

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

مخطط تاريخ النجوم

🤝 المساهمة

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

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