Arxi بوابة القرار أصل أساسي
Docs

أساسيات بوابة القرار

البرامج موثوقة لأن المتطلبات واضحة، والمدخلات معروفة، والنتائج يمكن التحقق منها. الوكلاء أقوياء، لكن سير العمل الخاص بهم احتمالي ونتائجهم يصعب إثباتها.

قرار بوابة القرار يعيد إنشاء تلك الضمانات البرمجية لعمليات الوكلاء دون تحويل الوكلاء مرة أخرى إلى برامج. يتم ذلك من خلال ثلاثة مفاهيم تتراكم على بعضها البعض: المنطق يحدد ما يعنيه “الانتهاء”، الأدلة تثبت ما حدث، والبوابات تتخذ القرار.

ثلاثة مفاهيم أساسية

المنطق (كيف يتم التعبير عن المتطلبات)

تقوم البرامج بتشفير المتطلبات داخل مسارات الشيفرة. يحتاج الوكلاء إلى المتطلبات المعلنة بشكل صريح، في شكل يمكن لكل من البشر والأنظمة فحصه. تحول المنطق “هل نجح الأمر؟” إلى شروط واضحة وقابلة للاختبار وتجمعها في بوابة.

{
  "requirement": {
    "And": [
      { "Condition": "tests_ok" },
      { "Condition": "coverage_ok" }
    ]
  }
}

متطلبات بوابة بسيطة: يجب أن تكون كلا الشرطين صحيحين لتجاوز البوابة.

لماذا هذا مهم: تتوقف عن مناقشة النتائج وتبدأ في تقييمها. تجعل المنطق معايير النجاح مرئية ومستقرة وقابلة للتدقيق.

الأدلة (من أين تأتي الإثباتات)

تدرك البرامج مدخلاتها؛ تولد الوكلاء النتائج من خلال الأدوات وAPIs والأنظمة الخارجية. الدليل هو كيف يربط Decision Gate ادعاءات الوكلاء بالبيانات الحقيقية.

  • موثوق: مزود مستخرج، موثوق به، أبطأ (استخدم للتشغيلات المدققة)
  • مؤكد: مزود من قبل العميل، تكرار سريع، ثقة أقل
  • التدقيق: بيانات وصفية مسجلة لا تؤثر على نتائج البوابة
{
  "evidence": {
    "tests_ok": { "lane": "verified", "value": 0 },
    "coverage_ok": { "lane": "verified", "value": 92 }
  }
}

أحمال الأدلة ومسارات الثقة: البيانات التي سيقوم البوابة بتقييمها، بالإضافة إلى مدى موثوقيتها.

لماذا هذا مهم: الأدلة تحول “قال الوكيل ذلك” إلى “البيانات أثبتت ذلك”. إنها تتيح لك التحرك بسرعة في التكرار وما زلت تحصل على دليل رسمي عندما يكون ذلك مهمًا.

البوابات (نقاط التفتيش الرسمية)

البوابات هي نقاط القرار التي تحول المنطق + الأدلة إلى نتائج. تقوم بتقييم الأدلة بشكل حتمي: نفس الأدلة تؤدي إلى نفس النتيجة. تصبح الأدلة المفقودة أو غير الموثوقة unknown، لذا فإن البوابة تحتفظ بدلاً من السماح بالمرور.

{
  "gate_id": "quality",
  "result": "pass"
}

أبسط نتيجة ممكنة: البوابة قامت بتقييم الأدلة ومرت.

لماذا هذا مهم: تحصل على ضمانات بمستوى البرنامج - قرارات حتمية، سلوك مغلق عند الفشل، ومسارات تدقيق قابلة لإعادة التشغيل - داخل سير عمل الوكلاء. كل تشغيل حي ينتج حزمة تشغيل حتى يمكن التحقق من القرارات لاحقًا دون إعادة تشغيل الأدوات.

بعد ذلك، انظر كيف تظهر هذه المفاهيم في سير العمل الحقيقي في أمثلة Decision Gate.

تعلم المزيد