الموجّه التلقائي

orcarouter/auto هو موجّه مسمّى نُنشئه لكلّ حساب عند التسجيل. يوجّه كلّ طلب إلى أرخص نموذج محادثة نشط يملك حسابك صلاحية الوصول إليه، ويُختار من جديد عند كلّ طلب.

الاستخدام

response = client.chat.completions.create(
    model="orcarouter/auto",
    messages=[{"role": "user", "content": "..."}],
)

لا يلزم أيّ إعداد آخر — يكون الموجّه موجودًا منذ لحظة إنشاء حسابك.

السلوك الافتراضي

الإعداد المُهيّأ:

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

يمكنك رؤية وتعديل الموجّه التلقائي من لوحة التحكّم ضمن التوجيه. يمكنك تضييق النمط (مثلًا حصره في openai/*)، أو تبديل الاستراتيجية، أو ضبط default_model، أو حذف الموجّه كليًّا — تمامًا كأيّ موجّه مسمّى.

تبديل الاستراتيجيات

تكشف لوحة التحكّم عن أربع بطاقات استراتيجية. الأرخص هو الإعداد الافتراضي المُهيّأ أعلاه؛ اختر غيره لتغيير كيفية حلّ orcarouter/auto للاختيارات:

البطاقة	enum الخلفي	ما تفعله
الأرخص	`cheapest`	أقلّ سعر لكلّ رمز من بين المرشّحين النشطين. الإعداد الافتراضي المُهيّأ.
الجودة	`quality`	أعلى درجة جودة من بين المرشّحين النشطين، بغضّ النظر عن السعر.
المتوازن	`balanced`	يختار خيارًا منخفض التكلفة يستوفي عتبة جودة؛ ويعود إلى الخيار الأعلى جودة إذا لم يستوفِها شيء. الإعداد الافتراضي للموجّهات الجديدة التي تنشئها بنفسك.
التكيّفي	`linucb` / `gated_adaptive`	سارق سياقي LinUCB لكلّ موجّه يتعلّم من حركتك الفعلية ليوازن بين الجودة والتكلفة والكمون والموثوقية لكلّ طلب. وضعان فرعيّان (القياسي / المُبوَّب) — انظر الموجّهات المسمّاة.

يحتاج التكيّفي إلى إحماء قصير لكلّ نموذج قبل أن يبدأ في توجيه الاختيارات. خلال الإحماء يتصرّف مثل المتوازن — وهذا متوقّع، وليس عيبًا.

متى تفضّل الموجّه التلقائي على أسماء النماذج الصريحة

لا تريد التثبيت على نموذج معيّن؛ تريد أرخص نموذج محادثة نشط في كلّ طلب.
أنت في طور النمذجة الأوّليّة ولا تريد الاهتمام بأيّ مزوّد يعمل.
تريد أن “يعمل” توجيه OrcaRouter دون التفكير فيه.

متى تفضّل أسماء النماذج الصريحة

تحتاج إلى مخرجات حتمية — اختيار نماذج مختلفة في أوقات مختلفة سيغيّر أسلوب التوليد وجودته.
تستخدم ميزات خاصة بنموذج واحد (مثل cache_control في Claude، أو توليد الصور الأصلي لنموذج معيّن).
تريد تكلفة قابلة للتنبّؤ لكلّ طلب.

رؤية اختيار الموجّه التلقائي

تفقّد ترويسة الاستجابة X-Orca-Resolved-Model. انظر ترويسات الاستجابة.

res = client.chat.completions.with_raw_response.create(
    model="orcarouter/auto", ...
)
actual_model = res.headers.get("X-Orca-Resolved-Model")
# e.g. "openai/gpt-4o-mini"

​الاستخدام

​السلوك الافتراضي

​تبديل الاستراتيجيات

​متى تفضّل الموجّه التلقائي على أسماء النماذج الصريحة

​متى تفضّل أسماء النماذج الصريحة

​رؤية اختيار الموجّه التلقائي