ابدأ الآن

البدء السريع

ثبِّت المحرك، وأنشئ هيكل مشروع، واحصل على أول تشغيل وأول قرار بوابة على جهازك. لا يغادر جهازَك شيءٌ ما لم تدفعه بنفسك.

هذه الخطوات هي خطوات ملف README، معروضة هنا لا منسوخة يدويًا: README.md هو النسخة التي يصادفها المطوّر على GitHub، وهو النسخة التي تختبرها اختبارات الإعداد الأولي مقابل الشيفرة، لذا يبقى هو المصدر، وتُولَّد هذه الصفحة منه بواسطة scripts/generate_quickstart.py.

التثبيت للتطوير

من جذر المستودع:

python3 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'
pnpm install --frozen-lockfile
make check
pnpm --filter @oloproof/web check

الواجهة العامة في Python هي:

from oloproof import evaluate, system, current_case
from oloproof.evaluators import ExactMatch, Contains, JsonSchema, Regex, RubricJudge, evaluator

كل ما يقع تحت oloproof_core هو من الأجزاء الداخلية للمحرك.

البدء السريع

أنشئ مشروعًا صغيرًا:

. .venv/bin/activate
oloproof init /tmp/oloproof-demo
cd /tmp/oloproof-demo
oloproof run

المُقيِّمات

قيم type: التي يقبلها oloproof.yaml:


حتمي	exact_match، contains، regex، json_schema
حَكَم LLM	rubric_judge، groundedness_judge، citation_support_judge؛ probability_judge: سؤال بنعم/لا أو باختيار أو بدرجة يُجاب عنه باحتمالات رمز واحد؛ cascade: حَكَم احتمالي أولًا، ثم حَكَم ثانٍ فقط حيث لا يكون الأول متيقنًا
نموذج	model_classifier: مُصنِّف مُدرَّب أو نموذج NLI على خادم TEI، تُقاس نتيجته مقابل عتبة
الاسترجاع	hit_rate، recall، mrr، ndcg، citation_validity
وكيل	agent_max_steps، agent_tool_called، agent_no_tool_loop، agent_tool_sequence، agent_no_undeclared_tool، agent_constraints_satisfied
متعدد الوكلاء	agent_route، agent_tool_permissions، agent_max_handoffs
تنبؤي	predictive_correct، predictive_precision، predictive_recall، predictive_ranking، predictive_brier، predictive_log_loss، predictive_absolute_error

يُسمّي الحَكَم مزوِّده provider (anthropic أو openai أو openai_compatible)، ونموذجه model، ومعياره عبر rubric_text أو rubric_file. والحَكَم الذي يعمل لدى مزوِّد يتحدث بواجهة OpenAI API وليس OpenAI نفسها — مثل Groq أو Together أو خادم محلي — يحتاج أيضًا إلى base_url وapi_key_env:

evaluators:
  - type: rubric_judge
    criterion: answer_correct
    provider: openai_compatible
    model: openai/gpt-oss-20b
    base_url: https://api.groq.com/openai/v1
    api_key_env: GROQ_API_KEY
    rubric_text: "PASS if the answer conveys the same fact as the reference."

إذا ذكرتَ حقلًا لا يقبله المُقيِّم، فالرد يسرد الحقول التي يقبلها.

أعِد اتخاذ القرار بشأن تشغيل موجود دون إعادة تشغيل النظام أو المُقيِّمات:

oloproof gate RUN_ID --policy release.yaml

افحص الإخفاقات وحالة واحدة:

oloproof inspect RUN_ID --failures
oloproof inspect RUN_ID --case refund_00

صدِّر حزمة وافتحها في منضدة العمل على الويب:

oloproof export RUN_ID
OLOPROOF_BUNDLE_DIR="$PWD/.oloproof/bundles" pnpm --dir /path/to/Oloproof --filter @oloproof/web dev

يجب أن يكون مسار الحزمة مطلقًا، لأن pnpm يشغّل التطبيق من apps/web. تُفتح منضدة العمل على فهرس مساحات العمل؛ ويظهر OLOPROOF_BUNDLE_DIR المنفرد هناك بوصفه المشروع local/bundles. ولحفظ عدة مشاريع على جهاز واحد، وجِّه OLOPROOF_WORKBENCH_DIR بدلًا من ذلك إلى دليل يحتوي على workbench.json (docs/API_CONTRACTS.md).