الانتقال إلى المحتوى الرئيسي

​
متى تستخدم كل واجهة

​
نقاط النهاية

أدوات MCP المقابلة هي didit_transaction_rule_list وdidit_transaction_rule_get وdidit_transaction_rule_create وdidit_transaction_rule_update وdidit_transaction_rule_delete وdidit_transaction_rule_backtest وdidit_transaction_rule_library_list وdidit_transaction_rule_install وdidit_transaction_rule_uninstall - راجع مرجع أدوات MCP. يُوثَّق المخطط الكامل - ويشمل كتالوج الحقول، وجميع المشغّلات البالغ عددها 19، والنوافذ الزمنية لمعدل المعاملات، والشروط المجمّعة، وأنواع الإجراءات الستة - في صفحة القواعد واحتساب الدرجات ويُضمَّن في مرجع API.

​
الإنشاء والاختبار الرجعي والتفعيل

نمط الإطلاق الآمن لأي قاعدة جديدة:
1

إنشاء القاعدة في وضع TEST

اقرأ الحمولة على جزأين. يصف scope وconditions المعاملة التي يتم تقييمها: معاملة مالية واردة بعملة EUR بقيمة amount الخام أقل من 10,000. وتصف مدخلات aggregation نافذة الـ30 يومًا للطرف نفسه: 20 معاملة مالية واردة على الأقل بعملة EUR، ولا تبلغ أيٌّ منها 10,000 EUR أو أكثر. يجب أن تتحقق مدخلتا التجميع معًا، بغض النظر عن قيمة evaluation_mode - فهذا الإعداد يحكم الشروط فقط.يستخدم هذا المثال amount الخام ويثبّت currency على EUR في النصفين، لذا فهو لا يعتمد على توحيد أسعار الصرف. لاختبار بيانات التجربة في البيئة التجريبية بالاختبار الرجعي، أرسل 20 معاملة مالية واردة على الأقل بعملة EUR للطرف نفسه خلال 30 يومًا، ولكلٍّ منها amount أقل من 10,000. لا يُشترط أيٌّ من preferred_currency_amount أو amount_in_default_currency. تخزّن عملية إدخال البيانات في البيئة التجريبية هذه المعاملات؛ فشغّل الاختبار الرجعي صراحةً.تُقيِّم القاعدة من نوع TEST كل معاملة جديدة وتسجل ما كانت ستطابقه، لكنها لا تمسّ أبدًا درجة المعاملة أو حالتها.
تصفية التجميع ليست شرطًا. لا يقرأ الشرط أبدًا إلا المعاملة التي يتم تقييمها؛ ولا تضيّق تصفية التجميع إلا نافذة السجل التاريخية، وتقارن بالمساواة أو بعضوية القائمة - لا يوجد مرشح lt، لذا لا يمكنك أن تحسب التحويلات الأقل من 10,000 فقط.مدخلة max ... lt 10000 هي الطريقة المدعومة لوضع سقف على النافذة: إذ تشترط أن تكون كل معاملة في النافذة أقل من 10,000، وهذا أشدّ من احتساب الصغيرة فقط - فتحويل واحد بقيمة 12,000 بين العشرين يمنع القاعدة من التفعيل. احذف هذه المدخلة إذا كنت تفضّل أن يقوم العدّ بذاته، ثم اذكر ذلك في العنوان: بدونها تحسب القاعدة التحويلات الواردة بأي حجم، فتطابقها تسعة عشر تحويلًا بقيمة 50,000 يليها تحويل صغير واحد.
2

الاختبار الرجعي على سجلك

يعني عدد matched غير المتوقع أن الحدود تحتاج إلى ضبط قبل أن تتمكن القاعدة من اتخاذ إجراء بشأن أي شيء.
اختبر التكوين الذي ستفعّله بمطابقة تامة: نفس conditions وaggregation وevaluation_mode وscope. لا تضيف conditions وaggregation وscope المُغفلة أي قيود خاصة بها؛ إذ قد يؤدي حذف النطاق إلى تضمين اتجاهات أو أنواع معاملات تتجاهلها القاعدة المحفوظة. القيمة الافتراضية لـ evaluation_mode عند حذفها هي ALL، لذا قد يقلل حذفها للقاعدة من نوع ANY عدد المطابقات. القيمة الافتراضية لـ period_days عند حذفها هي 90 يومًا؛ ولا تعني أنها تختار سجلًّا غير محدود.
3

التفعيل

تُطبَّق القاعدة فورًا على جميع المعاملات الجديدة لتطبيق في بيئة الإنتاج.
لا تقيّم تطبيقات البيئة التجريبية القواعد أبدًا. تُخزَّن المعاملة في البيئة التجريبية دون أي إجراء آخر، لذا فإن تفعيل قاعدة على تطبيق في البيئة التجريبية لا يغيّر أي شيء يمكنك ملاحظته. الاختبار الرجعي هو الطريقة المدعومة لتجربة القاعدة قبل أن تصبح مباشرة - راجع مراقبة المعاملات في البيئة التجريبية.

​
ترحيل القواعد من مزود آخر

لأن إنشاء القاعدة استدعاء API بسيط بمخطط موثّق بالكامل، يستطيع مساعد ذكي تحويل تصدير القواعد من مزود آخر إلى قواعد Didit نيابةً عنك.
  1. تصدير قواعدك من المزود الحالي، إذ تُصدّر معظم الأدوات إلى ملفات CSV أو Excel.
  2. ارفع الملف إلى مساعد وحدة تحكم Didit (أو أي وكيل متصل بـ MCP، مثل Claude مع Didit MCP مُرفقًا). تُحوَّل جداول البيانات إلى نص تلقائيًا.
  3. يقوم المساعد بربط كل صف بمخطط Didit (الشروط، والنوافذ الزمنية لمعدّل المعاملات، والإجراءات)، ويعرض لك الربط، مع الإشارة إلى أي عنصر لا يقابله شيء في Didit، وذلك قبل إنشاء أي شيء.
  4. بعد موافقتك، يُنشئ القواعد في وضع TEST، ويُجري عليها اختبارًا رجعيًا على سجل معاملاتك، ويُبلغ عن الصفوف التي أُنشئت وفشلت وتعذّر ربطها.
  5. راجع الأرقام وفعّل القواعد التي تبدو صحيحة، من وحدة التحكم أو باستخدام PATCH {"mode": "ACTIVE"}.
مثال على تصدير من مزود آخر:
يتحول إلى قواعد كهذه:
يحمل صف CSV اتجاهًا وعملة، لذا يحمل نصفا القاعدة كليهما: scope وconditions يحصران المعاملة المُقيَّمة في تحويل صادر بعملة EUR أقل من 10,000، وفلاتر التجميع تحصر النافذة الزمنية البالغة 30 يومًا على التحويلات الصادرة بعملة EUR للجهة نفسها. الحقل amount الخام قابل للمقارنة داخل عملة واحدة فقط، لذا أبقِ العملة مُثبَّتة كما هو موضّح أعلاه. يتطلب الحد الأعلى عبر العملات وجود مبلغ موحّد لكل معاملة في النافذة. والتبديل إلى preferred_currency_amount وحده لا يضمن التوفر، إذ قد تُعامَل المبالغ الموحّدة التاريخية المفقودة على أنها صفر في التجميعات العددية. إدخال max هو ما يُبقي النافذة أقل من 10,000 EUR، لأن فلتر التجميع لا يستطيع التعبير عن “أقل من 10,000”، انظر الملاحظة عن خطوة الإنشاء أعلاه للمفاضلة التي يتضمنها ذلك. وأي شيء لا يستطيع المخطط التعبير عنه بدقة يستحق الإفصاح عنه صراحةً في description الخاصة بالقاعدة، بدلًا من التقريب بصمت.
قبل إعادة إنشاء قاعدة مزود آخر كقاعدة مخصصة، راجع مكتبة القواعد: تقدّم Didit 150+ قالبًا جاهزًا تغطي الأنماط الشائعة (الهيكلة، والسرعة، والتعرض للعقوبات، وإعادة استخدام الجهاز، ومخاطر العملات المشفرة)، وتثبيت القالب يتم عبر استدعاء واحد.

​
أخطاء التحقق دقيقة عن قصد

تتحقق endpoint الخاصة بإنشاء القواعد وتحديثها من قيم الشروط والتجميع والنطاق مقابل ما يقبله محرك القواعد تمامًا: المشغّلات أو المقاييس غير المعروفة، ونوافذ مُشكَّلة بشكل خاطئ ("30days" بدلًا من "30d")، واتجاهات نطاق غير صالحة، وcontains_any بدون قائمة، وfuzzy_match بدون score، وchange_status إلى AWAITING_USER بدون workflow_id. كل هذه الحالات تعيد 400 يذكر الفهرس والمشكلة، بدلًا من حفظ قاعدة لا تتطابق أبدًا بصمت. ينبغي للوكلاء والنصوص البرمجية قراءة نص الخطأ وتصحيح الحمولة. أما مفاتيح النطاق الإضافية بخلاف transaction_types وdirections وaction_types فتُحفظ لكن يتجاهلها المحرك، وهذا يطابق الطريقة التي كانت Business Console تحفظ بها هذه المفاتيح دائمًا.

​
الخطوات التالية

القواعد واحتساب الدرجات

المخطط الكامل للقاعدة: الحقول والمشغّلات ونوافذ السرعة والإجراءات.

واجهة برمجة تطبيقات إنشاء القاعدة

مرجع endpoint مع مخططات الطلب والاستجابة.

مكتبة القواعد

فهرس القوالب الجاهزة البالغ 150+ وحزمها.

نظرة عامة على MCP

اربط وكيلًا ذكيًا بمساحة عمل Didit الخاصة بك.
آخر تعديل في ٧ نوفمبر ٢٠٢٦