التوجيه

محرك التوجيه في GreatRouter هو الذكاء الأساسي الذي يربط مطالباتك بأفضل نموذج للمهمة. يوفر GreatRouter نقطتي نهاية للتوجيه:

التوجيه التلقائي (/v1/auto/route) — صف ما تحتاجه بلغة طبيعية. يصنّف الموجّه النية ويختار نموذجًا ويمرّر الطلب.
التوجيه الصريح (/v1/models/route) — حدّد نوع المهمة والمرشحات. يرتّب الموجّه النماذج المطابقة ويمرّر الطلب.

معاملات التوجيه

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

المعامل	النوع	الافتراضي	الوصف
`prompt`	string	— (مطلوب)	وصف بلغة طبيعية لما تحتاجه
`input`	object	— (مطلوب)	مدخلات النموذج (رسائل، معاملات، إلخ)
`task`	string	—	تلميح: `text`، `image`، `video`، `music`، `speech`، `code`، `web_search`
`content_mode`	string	—	`generate` أو `edit` أو `combine`
`optimization`	string	`"balanced"`	`price-optimized` أو `output-optimized` أو `balanced`
`budget_dollars`	number	—	الحد الأقصى للتكلفة المقدرة بالدولار

معاملات التوجيه الصريح

المعامل	النوع	الافتراضي	الوصف
`query`	string	— (مطلوب)	نوع المهمة أو الوصف للمطابقة
`input`	object	— (مطلوب)	مدخلات النموذج
`maxCost`	string	—	مستوى السعر: `economy`، `standard`، `balanced`، `premium`، `flagship`

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

تصنّف نقطة التوجيه التلقائي مطالبتك وتوجّه إلى أفضل نموذج:

مطالبة → مصنّف المحتوى → [text, code, image, music, video, speech, web_search]
                              → كاشف الوضع → [generate, edit, combine]
                                → محدد النموذج → أفضل نموذج → وكيل الاستدلال → استجابة

يحلل المصنّف مطالبتك عبر عدة أبعاد:

تصنيف المهمة — يحدد ما إذا كنت تعمل مع نص أو كود أو صور أو موسيقى أو فيديو أو كلام أو بحث ويب.
كشف الوضع — يحدد ما إذا كنت تريد توليد محتوى جديد أو تعديل محتوى موجود.
تقدير التعقيد — يعيّن مستوى (SIMPLE، MEDIUM، COMPLEX، REASONING) لمطابقة جودة النموذج.
تحسين التكلفة — يفضّل النماذج الفعّالة عندما تكون متطلبات القدرة منخفضة.

التوجيه الهرمي للكتالوج

وجّه بدقة أكبر باستخدام محددات الكتالوج على /v1/auto/route و/v1/auto/suggest:

المستوى	المعاملات	السلوك
التصنيف فقط	`taxonomy: "translation"`	يصفّي حسب الفئة ويرتّب بشكل طبيعي
تصنيف + مزوّد	`taxonomy: "translation"`، `provider: "meta"`	أفضل نموذج Meta في الترجمة
العائلة	`catalog_family: "..."`	أفضل متغير قابل للتوجيه في تلك العائلة
نموذج صريح	`model: "meta/m2m100-1.2b"`	يستخدم ذلك النموذج مباشرة

أفضل الممارسات

استخدم التوجيه التلقائي افتراضيًا — دع GreatRouter يصنّف ويختار النموذج.
قدّم تلميحات المهمة عند الحاجة — يحسّن معامل task الدقة للحالات الغامضة.
حدّد حدود الميزانية — استخدم budget_dollars للتحكم في التكاليف في الإنتاج.
تتبّع الجلسات — أعد استخدام session_id لتحسين اتساق السياق.

للوثائق الكاملة بالإنجليزية (جداول مرجعية ومصفوفات وأمثلة متقدمة)، راجع النسخة الإنجليزية أو استكشف الأقسام المرتبطة في الشريط الجانبي.