ما هو Auto API في CometAPI؟
CometAPI Auto API هو نقطة نهاية ذكية لتوجيه النماذج تتيح للمطورين الوصول إلى نماذج الذكاء الاصطناعي المناسبة دون تحديد اسم نموذج ثابت لكل طلب. بدلًا من اختيار نموذج فردي مثل GPT أو Claude أو Gemini أو نموذج مدعوم آخر، يمكن للمطورين إرسال model=auto، وتحدد CometAPI تلقائيًا نموذجًا مناسبًا بناءً على خصائص ومتطلبات الطلب.
بالنسبة لأعباء العمل التي تُفضَّل فيها جودة استجابة أعلى، يمكن للمطورين استخدام auto-high. كل من auto وauto-high هما خيارات توجيه وليسا نماذج ذكاء اصطناعي ثابتة.
يتيح هذا النهج للتطبيقات استخدام واجهة برمجة تطبيقات ثابتة بينما تتولى CometAPI اختيار النموذج في الخلفية.
معلمات ومواصفات Auto API
يستخدم Auto API نفس بنية طلبات واجهة برمجة التطبيقات المدعومة بواسطة نقطة النهاية المقابلة في CometAPI. الاختلاف الأساسي هو قيمة معامل model.
| المعلمة | النوع | الوصف |
|---|---|---|
| model | string | تُضبط على auto أو auto-high |
| messages | array | رسائل المحادثة |
| stream | boolean | يفعّل البث عند دعمه |
| tools | array | تعريفات الأدوات |
| response_format | object | إعدادات المخرجات المهيكلة |
| Image input | object/array | محتوى الصورة عند دعمه |
| File input | object/array | محتوى الملف عند دعمه |
| Reasoning parameters | object/string | إعدادات متعلقة بالتفكير يدعمها النموذج المُختار |
كيف يعمل Auto API؟
عند استخدام model=auto أو model=auto-high، تفحص CometAPI أولًا خصائص الطلب. قد تشمل هذه الخصائص نوع العميل، وما إذا كان الطلب يحتوي على صور أو ملفات، والطول التقديري للمدخلات، واستخدام الأدوات، ومتطلبات المخرجات المهيكلة، والبث، والمعلمات المتعلقة بالتفكير.
استنادًا إلى هذه الخصائص، يُطابَق الطلب مع سيناريو التوجيه المناسب. بعد ذلك تختار CometAPI نموذجًا مؤهلًا من مجموعة النماذج المقابلة وفقًا لمستوى الجودة المُعد، وتوافر النماذج، والأولوية، والوزن، وأذونات مجموعة المستخدمين، والقدرات، والتسعير، وتوافر القنوات.
بعد اختيار النموذج، يتابع الطلب المرور عبر نظام توجيه القنوات المعتاد في CometAPI. لذا يحدد التوجيه التلقائي ما هو النموذج الذي ينبغي أن يتعامل مع الطلب، بينما يحدد توجيه القنوات أي مزود قناة متاح سيعالج طلب ذلك النموذج.
لا ينشئ التوجيه التلقائي القنوات تلقائيًا ولا يتجاوز إعدادات القنوات الحالية. يجب أن يمتلك النموذج إعدادات التسعير وتوجيه القنوات اللازمة قبل أن يتمكن من معالجة الطلبات بنجاح.
لذا قد يختلف النموذج المُعاد في استجابة واجهة برمجة التطبيقات عن النموذج المحدد في الطلب. على سبيل المثال، قد يعيد طلب يستخدم model=auto اسم نموذج فعليًا في حقل model. هذا سلوك متوقع ويُشير إلى النموذج الذي اختاره الموجه في النهاية.
Auto مقابل Auto-High: ما الفرق؟
يعتمد كل من auto وauto-high على نفس مفهوم التوجيه الذكي لكنهما يستهدفان مستويات جودة مختلفة.
Auto هو خيار توجيه لأغراض عامة. يهدف إلى توفير توازن عملي بين جودة الاستجابة والتكلفة والسرعة والتوافر. وهو مناسب كخيار افتراضي لمعظم التطبيقات اليومية.
Auto-High مُصمم للمستخدمين الذين يفضلون نماذج أقوى وجودة استجابة أعلى. وهو أنسب للاستدلالات المعقدة، والبرمجة المتقدمة، والتحليل المفصل، وغيرها من أعباء العمل الحساسة للجودة.
لا يعني auto-high أن كل طلب يُرسل إلى نموذج مميز واحد بعينه. مثل auto، يختار نموذجًا ديناميكيًا من مجموعة نماذج عالية الجودة المُهيأة وفقًا لخصائص الطلب.
| الميزة | auto | auto-high |
|---|---|---|
| الغرض | توجيه تلقائي عام | توجيه تلقائي بجودة أعلى |
| اختيار النموذج | تلقائي | تلقائي |
| نموذج ثابت | لا | لا |
| التركيز الأساسي | توازن التكلفة والسرعة والتوافر والقدرات | اختيار نماذج أعلى جودة |
| الأفضل لـ | أعباء العمل الإنتاجية العامة | الأعباء المعقدة أو الحساسة للجودة |
| قد يتغير النموذج | نعم | نعم |
بعبارات بسيطة، استخدم auto عندما تريد افتراضيًا متوازنًا، واستخدم auto-high عندما تكون جودة الاستجابة هي الأولوية الأعلى.
حالات الاستخدام
تطبيقات الذكاء الاصطناعي العامة
يُعد Auto خيارًا مناسبًا لبرامج الدردشة، وتوليد المحتوى، والتلخيص، والتصنيف، ودعم العملاء، وغيرها من تطبيقات الذكاء الاصطناعي العامة. لا يحتاج المطورون إلى الحفاظ على استراتيجية اختيار نموذج ثابت لكل طلب.
الترميز والتطوير
يمكن لتطبيقات البرمجة الاستفادة من توجيه Auto لأن الطلبات المتعلقة بالبرمجة يمكن توجيهها نحو نماذج مُهيأة لمهام هندسة البرمجيات. وهذا مفيد لمساعدي الترميز، وتكاملات IDE، وتوليد الشفرات، وتصحيح الأخطاء، ومراجعة الشفرات، ووكلاء التطوير.
التحليل المعقد والاستدلال
يُعد auto-high مناسبًا للمهام التي تكون فيها جودة الاستجابة أهم من تقليل تكلفة النموذج. تشمل الأمثلة التحليل التقني، والاستدلالات المعقدة، والمهام البحثية، وتحليل المستندات التفصيلي، وتدفقات الوكلاء المتقدمة.
التطبيقات متعددة الوسائط
عندما تدعمها قواعد التوجيه المُهيأة والنماذج المرشحة، يمكن لـ Auto توجيه الطلبات التي تحتوي على صور أو ملفات نحو نماذج قادرة على معالجة تلك المدخلات.
التطبيقات ذات الحجم الكبير
يمكن أن يكون Auto مفيدًا أيضًا للتطبيقات التي تُعالج مجموعة واسعة من الطلبات. بدلًا من تنفيذ وصيانة منطق اختيار النماذج في كود التطبيق، يمكن للمطورين ترك اختيار النموذج لإدارة CometAPI مركزيًا.
ما هي قيود Auto API؟
لا يضمن Auto أن كل طلب سيُعالَج بواسطة نفس النموذج. نظرًا لأن اختيار النموذج ديناميكي، يمكن أن يتغير النموذج الأساسي مع تغيّر شروط وإعدادات التوجيه.
كما لا يضمن Auto أقل سعر ممكن. فهو مصمم لاختيار النموذج بذكاء بدلًا من مجرد اختيار أرخص نموذج متاح.
قيد آخر هو أن قدرات النماذج قد تختلف. قد تدعم النماذج المختلفة أطوال سياق مختلفة، أو أدوات، أو مدخلات الصور، أو مخرجات مهيكلة، أو ميزات أخرى. لذلك يعمل Auto بأفضل شكل عندما تكون معلومات القدرات للنماذج المرشحة دقيقة.
أخيرًا، لا يضمن اختيار نموذج أن الطلب سيُستكمل بنجاح. يجب أن يكون للنموذج المختار مسار قناة متاح لمجموعة المستخدمين المعنية. إذا لم تكن هناك قناة مناسبة متاحة، فقد يفشل الطلب حتى لو حدد Auto نموذجًا بنجاح.
كيف يتعامل Auto مع أنواع الطلبات المختلفة؟
الفائدة الأساسية من Auto هي أن المطورين لا يحتاجون إلى صيانة منطق اختيار منفصل لكل نوع طلب شائع.
يمكن معالجة طلب نصي عادي بواسطة مجموعة النماذج الافتراضية. ويمكن توجيه طلب برمجي نحو مجموعة نماذج موجهة للبرمجة. ويمكن مطابقة طلب سياق كبير مع نماذج تدعم حجم الإدخال المطلوب. ويمكن توجيه طلب صورة نحو نموذج يمتلك قدرات رؤية.
يتيح ذلك لنقطة دخول واحدة في واجهة برمجة التطبيقات دعم سيناريوهات تطبيق مختلفة مع الحفاظ على بساطة التكامل من جهة العميل.
ما هي فوائد استخدام CometAPI Auto API؟
الفائدة الأساسية من Auto هي أنه يفصل منطق التطبيق عن منطق اختيار النموذج.
بدون التوجيه التلقائي، غالبًا ما يحتاج المطورون إلى تقرير أي نموذج يجب أن يتعامل مع كل طلب ثم الحفاظ على استراتيجيات بديلة عندما تصبح النماذج غير متاحة أو مكلفة أو غير مناسبة لعبء عمل معين.
مع Auto، يمكن للتطبيقات استخدام معرّف توجيه ثابت بينما تُدار استراتيجية النماذج الأساسية مركزيًا.
يمكن أن يُبسّط هذا النهج التطبيقات متعددة النماذج، ويجعل تغييرات النماذج أسهل في النشر، ويقلل كمية منطق التوجيه الخاص بالنماذج الذي يجب صيانته داخل التطبيق.
بالنسبة للفرق التي تعمل مع مزودين متعددين للذكاء الاصطناعي وقدرات نماذج تتغير بسرعة، يمكن أن تكون هذه الطبقة التجريدية ذات قيمة خاصة.
Auto API مقابل نموذج محدد
| الميزة | Auto | نموذج محدد |
|---|---|---|
| اختيار النموذج تلقائيًا | نعم | لا |
| هوية نموذج ثابتة | لا | نعم |
| بساطة التطبيق | مرتفعة | متوسطة |
| التحكم في النموذج | أقل | أعلى |
| المرونة | مرتفعة | أقل |
| القدرة على التنبؤ | أقل | أعلى |
| مناسب لأعباء العمل المختلطة | نعم | يعتمد على النموذج |
| مناسب للاختبارات القابلة للتكرار | محدودة | نعم |
| الأفضل لـ | أعباء عمل إنتاجية ديناميكية | تطبيقات خاصة بنموذج معين |
كيفية استخدام CometAPI Auto API
تم تصميم CometAPI Auto API للعمل مع واجهة Chat Completions المتوافقة مع OpenAI. لست بحاجة لاختيار نموذج أساسي محدد. كل ما عليك هو ضبط معامل model على auto أو auto-high، وستختار CometAPI تلقائيًا نموذجًا مناسبًا بناءً على الطلب.
الخطوة 1: الحصول على صلاحية واجهة برمجة التطبيقات
سجّل الدخول إلى cometAPI. إذا لم تكن مستخدمًا لدينا بعد، يُرجى التسجيل أولًا. سجّل الدخول إلى وحدة تحكم CometAPI. احصل على مفتاح واجهة برمجة التطبيقات للوصول. انقر على “Add Token” عند API token في المركز الشخصي، واحصل على مفتاح الرمز: sk-xxxxx ثم أرسِل.
الخطوة 2: إرسال الطلبات إلى Auto API
اختر نقطة النهاية “auto” أو “auto-high” لإرسال طلب واجهة برمجة التطبيقات واضبط جسم الطلب. يتم الحصول على طريقة الطلب وجسم الطلب من وثائق واجهة برمجة التطبيقات على موقعنا. يوفر موقعنا أيضًا اختبار Apifox لتسهيل استخدامك. استبدل <YOUR_API_KEY> بمفتاح CometAPI الفعلي من حسابك.
الاختلاف بسيط:
auto— خيار متوازن لأعباء العمل العامة.auto-high— يُعطي أولوية لاختيار نماذج أعلى جودة.
ولا يمثل أي منهما نموذجًا أساسيًا ثابتًا.
الخطوة 3: كيف تختار CometAPI Auto النموذج؟
عند إرسال طلب باستخدام model=auto أو model=auto-high، تحدد CometAPI أولًا خصائص الطلب وتقرر سيناريو التوجيه الأكثر ملاءمة له. يمكن للنظام أخذ عوامل مثل نوع العميل، وما إذا كان الطلب يحتوي على صور أو ملفات، والطول السياقي التقديري للمدخلات، واستخدام الأدوات، ومتطلبات المخرجات المهيكلة، والبث، وغيرها من القدرات المدعومة بالاعتبار.
بعد تحديد مسار التوجيه المناسب، تختار CometAPI النماذج المرشحة من مجموعة نماذج auto أو auto-high المقابلة. تُستبعد النماذج المعطلة، أو غير المتاحة لمجموعة المستخدم، أو غير المتوافقة مع الطلب، أو التي لا يمكنها دعم السياق أو القدرات المطلوبة. ثم تُقيَّم النماذج المتبقية وفقًا لأولوية التوجيه المُعدة، والوزن، والتوافر.
بعد ذلك يُمرَّر النموذج المختار إلى نظام توجيه القنوات القائم في CometAPI، والذي يجد قناة متاحة لهذا النموذج ولمجموعة المستخدم. ونتيجة لذلك، قد لا يكون النموذج النهائي ثابتًا مسبقًا وقد يختلف حسب الطلب وإعدادات التوجيه الحالية.