Skip to main content
استخدم هذه الوصفة عندما تحتاج خدمة Python إلى الاعتماد على القيم الافتراضية التي يديرها dashboard بدلًا من تكرار إعداد المطالبات والتوجيه والمعاملات في كل طلب.

الهدف

  • إبقاء شيفرة استدعاء Python صغيرة
  • التوجيه باستخدام slug لإعداد مُسبق بدلًا من تثبيت نموذج في الشيفرة
  • طلب مخرجات منظّمة صارمة
  • الاحتفاظ ببيانات استجابة وصفية كافية لتصحيح أخطاء التوجيه أو سلوك الإضافات

1. ابدأ بعميل مشترك

أعد استخدام العميل نفسه بدلًا من إنشاء عميل لكل طلب.

2. انقل القيم الافتراضية المستقرة إلى إعداد مُسبق

أنشئ إعدادًا مسبقًا ضمن لوحة التحكم -> الإعدادات -> الإعدادات المسبقة عندما ينبغي تثبيت القيم التالية عبر عدة مستدعين:
  • مطالبة النظام
  • النموذج أو قائمة النماذج المسموح بها
  • تفضيلات المزوّد
  • إعداد الاستدلال
  • درجة الحرارة ومعاملات التوليد ذات الصلة
  • سياسة التخزين المؤقت للاستجابات عندما يكون التكرار الحتمي مهمًا
بعد إنشاء الإعداد المسبق، يمكن إبقاء شيفرة استدعاء Python موجزة.

3. اطلب شكل JSON صارمًا

أسباب فعالية هذا الشكل:
  • يُبقي preset إعدادات التوجيه والمطالبة الافتراضية خارج شيفرة التطبيق
  • يجعل response_format العقد واضحًا
  • يمكن لـ plugins استعادة JSON غير السليم شبه الصالح عندما يسمح سير العمل بذلك
  • يحتفظ meta بتفاصيل التوجيه وتنفيذ الإضافات لتصحيح الأخطاء

4. حلّل JSON وسجّل معرّفات التشغيل

يكفي هذا عادةً للعاملين في Python لربط سطر سجل واحد في التطبيق بما يلي:
  • نافذة تفاصيل الطلب في لوحة التحكم
  • تشخيصات التوجيه
  • بيانات تنفيذ الإضافات الوصفية

5. صحّح الأخطاء قبل إضافة تجاوزات

إذا وُجّه طلب بطريقة مختلفة عن المتوقع:
  1. افتح الطلب ضمن Gateway -> الاستخدام
  2. افحص تشخيصات التوجيه والمزوّدين المرشحين
  3. افحص بيانات تنفيذ الإضافات الوصفية إذا كان الطلب يتضمن JSON منظّمًا
  4. غيّر الإعداد المسبق بعد أن توضّح السجلات ما حدث فعلًا فقط
تجنب محاولة إصلاح طلب واحد سيئ عبر إضافة تجاوزات مضمنة كثيرة. فهذا يهزم عادةً الغرض من استخدام الإعدادات المسبقة.

6. حافظ على التوافق مع التخزين المؤقت عند إعادة الاستخدام

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

أدلة ذات صلة

آخر تعديل في ٢ أكتوبر ٢٠٢٦