الانتقال إلى المحتوى الرئيسي
يخزّن الإعداد المسبق النموذج وموجّه النظام والمعاملات وقواعد المزوّدين لمهمة واحدة تحت اسم مثل @support-triage. يرسل المستدعون هذا الاسم في model مع المدخلات فقط، ويملأ الـ Gateway الباقي قبل أن يختار مزوّدًا. بدّل حقول الطلب لترى أي قيمة تفوز: القواعد هي:
  • المعاملات تملأ الفراغات. لا تنطبق المعاملات الافتراضية للإعداد المسبق إلا على الحقول التي يتركها الطلب. القيمة الموجودة في الطلب تفوز دائمًا.
  • موجّهات النظام تتراكم. يأتي موجّه الإعداد المسبق أولًا. إذا كان للطلب موجّه نظام خاص به أو instructions، فإنه يليه بعد سطر فارغ.
  • إعدادات المزوّد في الطلب تفوز. تستبدل حقول مثل provider.order أو provider.max_price في الطلب قيمة الإعداد المسبق لذلك الحقل.
  • قوائم السماح تضيّق ولا توسّع أبدًا. تُطبَّق قوائم السماح والتجاهل للمزوّدين في الإعداد المسبق قبل اختيار المزوّد، لذا فهي تحدّ أيضًا من المزوّدين الذين يمكن أن يستخدمهم الاحتياط. يفشل النموذج الواقع خارج النماذج المسموح بها في الإعداد المسبق بخطأ validation_error كلمته المفتاحية في التفاصيل هي preset_model_not_allowed، ولا يُعاد توجيهه.

أنشئ إعدادًا مسبقًا واستخدمه

1

أنشئ الإعداد المسبق

افتح لوحة التحكم ← الإعدادات ← الإعدادات المسبقة وأنشئ إعدادًا مسبقًا بمعرّف نصي (slug) مثل support-triage. أضف فقط القيم الافتراضية التي يجب أن يتشاركها كل المستدعين.لإنشائه من سكربت، استدعِ POST /v1/presets باستخدام مفتاح إدارة.
2

استدعِه بالاسم

3

تحقّق مما طُبِّق

افتح الطلب في Gateway ← الاستخدام لترى أي قيم افتراضية من الإعداد المسبق طُبِّقت وأي مزوّد خدم الطلب.

ما الذي يمكن أن يحمله الإعداد المسبق

أبقِ المنطق الخاص بكل مستدعٍ في تطبيقك، واستخدم إعدادات مسبقة منفصلة عندما تحتاج مسارات العمل إلى موجّهات أو توجيه أو تخزين مؤقت مختلف.

سمِّ إعدادًا مسبقًا

أرسل الإعداد المسبق عبر الحقل model، أو عبر prompt.id عندما يحتوي على قالب موجّه. لا يوجد حقل preset منفصل. يتطلب نشر إعداد مسبق عام ملفًا شخصيًا عامًا مفعّلًا واسم مستخدم. أسماء المستخدمين فريدة على مستوى Phaseo، أما المعرّفات النصية فيكفي أن تكون فريدة لدى ناشر واحد. تُحوَّل المعرّفات النصية إلى أحرف صغيرة ويمكن أن تحتوي على أحرف وأرقام و- و_ و. و:.

أدِر الإصدارات وتراجع عنها

يحرّر الحفظ مسودة خاصة. يحوّل نشر إصدار جديد المسودة إلى إصدار مرقّم غير قابل للتغيير، ويحتفظ بكل الإصدارات السابقة. اختر شكل تسميات الإصدارات: وجّه تسمية مسماة مثل production إلى إصدار، وأعِدها إلى إصدار سابق للتراجع. راجع الإصدارات والتسميات. من سكربت، انشر باستخدام POST /v1/presets/{id}/versions وانقل الوسوم باستخدام PUT /v1/presets/{id}/labels/{label}، مع مفتاح إدارة. يمكن لتسجيل الدخول عبر CLI أو لتطبيق يستخدم تسجيل الدخول باستخدام Phaseo قراءة الإعدادات المسبقة، لكن لا يمكنه تغييرها.

انسخ إعدادًا مسبقًا من السوق

تبقى نسخة الإعداد المسبق المأخوذة من السوق مثبّتة على الإصدار الذي نسخته. عندما يطرح الناشر تحديثًا، تعرض نسختك إشعارًا. تطبيقه يغيّر مسودتك فقط، لذا لا يصل شيء إلى الإنتاج حتى تنشره بنفسك. يسجّل Phaseo مصدر كل نسخة وسلسلة أصولها الكاملة، لذا يمكن لصفحة في السوق أن تعرض النسخ المباشرة بشكل منفصل عن جميع النسخ المتفرعة منها. لجمع التقييمات على إجابات إعداد مسبق، راجع جمع الملاحظات حول الإعدادات المسبقة.
آخر تعديل في ٧ نوفمبر ٢٠٢٦