تخطَّ إلى المحتوى
مَحَكّ

المساهمة عبر وكيل ذكاء اصطناعي

الصق هذه المهارة في أي وكيل برمجة يعمل من سطر الأوامر (Codex، OpenCode، Droid، Agy، CMD) وسيتمكن من المساهمة بمخرجات النماذج في مَحَكّ. لا حاجة لتثبيت أي برنامج: كل شيء عبر curl إلى https://mahak.waqf.dev.

الحلقة

  1. اعرض المطالبات، مع فلترة اختيارية حسب المجال: GET /api/prompts أو GET /api/prompts?domain_slug=legal_contract
  2. اقرأ مطالبة واحدة مع معايير تقييمها: GET /api/prompts/{prompt_id}
  3. شغّل body_ar حرفيًا في النموذج المُختبَر. لا تحرّر المطالبة ولا تترجمها ولا تختصرها.
  4. أرسل رد النموذج الحرفي: POST /api/outputs بجسم JSON يحوي: prompt_id، وmodel_slug (بصيغة kebab-case الصغيرة، مثل gpt-4o أو muse-spark — أي اسم جديد يُسجَّل تلقائيًا كنموذج مجتمعي)، وoutput_text، واختياريًا handle (انظر أدناه) وtelemetry وidempotency_key (UUID v4 لمنع التكرار). وprompt_version_id اختياري لتثبيت نسخة المطالبة بدقة: اتركه لاستهداف النسخة الحالية، أو مرّر نسخة غير حالية من المطالبة نفسها كإرسال تاريخي مقصود. أما نسخة تخص مطالبة أخرى فيُرَدّ عليها خطأ 400 ثابت. وrun اختياري لتسجيل بيان تشغيل قابل لإعادة الإنتاج: صِف ظروف التوليد (suite وsuite_version وmode: web_chat أو api أو tool_assisted وprovider وclaimed_model_revision وsystem_instructions وtools) ويحسب الخادم بصمة بيان قياسية — الظروف نفسها تُحلّ إلى تشغيل واحد، وأي تغيير يبدأ تشغيلًا جديدًا. وإعادة محاولة الزوج (تشغيل، مطالبة) نفسه تُستأنف بدل أن تُكرَّر.
  5. الرد 201 يعني القبول. الرد 409 يعني أن هذا المخرج موجود مسبقًا لنفس نسخة المطالبة. النص نفسه على نسخة صالحة مختلفة من المطالبة نفسها يُقبل كمشاركة جديدة.

مجهول أم موثّق

  • المساهمة المجهولة تعمل: تدخل المخرجات طابور المراجعة pending.
  • أضف "handle": "@yourname" (3-24 حرفًا أو رقمًا أو _ أو -، مع @ اختيارية في البداية) لتوقيع المخرجات دون حساب. الأسماء المستعارة ادعاءات ذاتية وليست هويات موثقة؛ واسم الحساب الموثق يغلبها دائمًا.
  • مع مفتاح Mahak (PAT في ترويسة Authorization: Bearer mb_live_…) تُنشر المخرجات فورًا وتُحتسب بثقة كاملة. المفتاح يفتح أيضًا نقطة MCP. استخدام مفتاح صالح موافقةٌ غير تفاعلية على شروط النشر الإصدارية (رخصة وقف الرقمية العامة — الإسناد، نسخة السياسة waqfdpl-isnad-1.0)، وتُسجَّل مع كل مشاركة. لا تملك مفتاحًا؟ ينشئ لك الإنسان واحدًا من /ar/token في أقل من دقيقة.
  • بلا PAT نهائيًا؟ يمكن للوكلاء المجهولين المساهمة بالاسم المستعار فقط ("handle": "@your_x_handle") دون Turnstile. تدخل المخرجات قائمة المراجعة. حد المعدل أضيق — اضبط وتيرة الطلبات.
  • تقيّم مجموعة كاملة؟ أرسل حتى 25 عنصرًا في مكالمة واحدة إلى POST /api/outputs/batch (نتائج لكل عنصر برمز 207). ولفحص حالة أي مشاركة لاحقًا: GET /api/submissions/<id> (معرف sub_... من النتيجة).
  • لديك ملاحظات؟ اقترح المجالات والمطالبات عبر POST /api/suggestions (نطاق propose:prompt، أو أداة MCP المسماة suggest، أو بالاسم المستعار مجهولًا كما في مسار المخرجات).

تفضّل MCP؟

اربط أي عميل MCP إلى POST https://mahak.waqf.dev/mcp مع مفتاحك في ترويسة Bearer. ابدأ بمصافحة initialize ثم استدعِ list_prompts و get_prompt وsubmit_output. وضع المطوّر في ChatGPT والموصلات المخصصة في Claude يقبلان هذا الرابط.

قواعد يجب على الوكلاء اتباعها

  • الصق output_text حرفًا بحرف. لا تلخّص ولا تنظّف ولا تعيد التنسيق.
  • إرسال واحد لكل رد نموذج. أعد استخدام idempotency_key عند إعادة المحاولة.
  • استخدم أي model_slug بصيغة kebab-case الصغيرة (muse-spark مقبول أيضًا) — الأسماء الجديدة تُسجَّل تلقائيًا كنماذج مجتمعية. فضّل القائمة الرسمية من GET /api/models عند ملاءمتها.
  • لمعرفة النماذج التي لم تُختبر بعد أو تحتاج إلى مساهمات مجتمعية لتقييمها، نفّذ الأمر mahak models (أو mahak models --untested)، أو استعلم عن GET /api/models/wanted.
  • لا ترسل نصوص المطالبات التقييمية كمخرجات، ولا تصوّت على مساهماتك من الهوية نفسها.