اعتبارًا من 11 مارس 2025، أصدرنا اللبنات الأساسية لمنصة الوكلاء الجديدة لدينا. للتفاصيل، راجع وثائق API الخاصة بنا لـ Responses API، والأدوات بما في ذلك Web Search وFile Search وComputer Use، وAgents SDK لدينا مع Tracing. استنادًا إلى ملاحظاتك حول الإصدار التجريبي من Assistants API، أدرجنا تحسينات رئيسية في Responses API. بعد أن نحقق تكافؤًا كاملًا في الميزات، سنعلن عن خطة إيقاف Assistants API في وقت لاحق من هذا العام، مع تاريخ مستهدف للإيقاف النهائي في النصف الأول من 2026.
الأسئلة الشائعة
ما هي واجهة Assistants API؟
تتيح واجهة Assistants API للمطوّرين إنشاء مساعدين أقوياء يعملون بالذكاء الاصطناعي داخل تطبيقاتهم بسهولة. تُغني هذه الواجهة عن الحاجة إلى إدارة سجل المحادثات، وتتيح الوصول إلى أدوات تستضيفها OpenAI، مثل منفّذ التعليمات البرمجية والبحث في الملفات. تدعم الواجهة أيضًا إمكانات محسَّنة لاستدعاء الأدوات التابعة لجهات خارجية.
هل لا يزال بإمكاني استخدام الإصدار التجريبي v1 من واجهة برمجة تطبيقات Assistants؟
لا. اعتبارًا من 18 ديسمبر 2024، لم يعد بإمكان المستخدمين الوصول إلى الإصدار v1 التجريبي من واجهة برمجة تطبيقات Assistants. لا ندعم حاليًا سوى الإصدار v2. يرجى الاطلاع على دليل الترحيل هذا لتحويل استدعاءات واجهة برمجة التطبيقات من v1 إلى v2.
كيف يمكنني الوصول إليها؟
تتوفر Assistants API لأي شخص لديه حساب OpenAI API، لكنها مهملة وستُزال في أغسطس 2026. للمشاريع الجديدة، استخدم Responses API بدلاً منها. إذا كنت تستخدم Assistants API بالفعل، فخطط للترحيل إلى Responses API. لا يزال بإمكانك الوصول إلى المساعدين الحاليين في Assistants Playground ما دامت API متاحة.
ما هو المساعد؟
المساعد هو نظام ذكاء اصطناعي مصمَّم لغرض محدد، يستخدم نماذج OpenAI، ويمكنه الوصول إلى الملفات والاحتفاظ بسلاسل محادثة دائمة واستدعاء الأدوات.
ما هي سلسلة المحادثة؟
سلسلة المحادثة هي جلسة محادثة بين مساعد ومستخدم. تُسهِّل سلاسل المحادثة تطوير التطبيقات من خلال تخزين سجل الرسائل واقتطاع جزء منه عندما تتجاوز المحادثة طول السياق الذي يدعمه النموذج.
ما هي أداة البحث في الملفات؟
تطبّق أداة file_search عدة ممارسات مُثلى للاسترجاع دون الحاجة إلى إعداد إضافي، لمساعدتك على استخراج البيانات المناسبة من ملفاتك وتعزيز ردود النموذج بها.
تستخدم أداة file_search الإعدادات التالية افتراضيًا:
حجم الجزء: 800 رمز مميز
التداخل بين الأجزاء: 400 رمز مميز
نموذج التضمين: text-embedding-3-large باستخدام 256 بُعدًا
الحد الأقصى لعدد الأجزاء المُضافة إلى السياق: 20
ما القيود المفروضة على رفع الملفات؟
تخضع عملية رفع الملفات للقيود التالية:
512 ميغابايت لكل ملف
5 ملايين رمز مميز لكل ملف
10 آلاف ملف لكل مخزن متجهات
مخزن متجهات واحد لكل مساعد
مخزن متجهات واحد لكل سلسلة محادثة
يبلغ الحد الإجمالي للتخزين لكل مشروع في المؤسسة 100 غيغابايت.
ما قيود أداة البحث في الملفات؟
هناك بعض القيود المعروفة التي نعمل على معالجتها بإضافة الدعم اللازم خلال الأشهر المقبلة:
لا توجد حاليًا طريقة لتعديل إعدادات التجزئة أو التضمين أو الاسترجاع.
لا ندعم تحليل الصور داخل المستندات.
لا ندعم الاسترجاع من تنسيقات الملفات ذات البيانات المنظَّمة (مثل ملفات .csv أو .jsonl). اطّلع على أنواع الملفات المدعومة.
ما حدود معدل الطلبات لواجهة Assistants API؟
لا ترتبط حدود معدل الطلبات لواجهة Assistants API بفئة الاستخدام والنموذج. بل توجد حدود افتراضية بحسب نوع الطلب، مع بعض الاستثناءات:
GET: 1000 طلب في الدقيقة
POST: 300 طلب في الدقيقة
DELETE: 300 طلب في الدقيقة
ما تكلفة منفّذ التعليمات البرمجية في واجهة API؟
تبلغ تكلفة منفّذ التعليمات البرمجية 0.03 دولار لكل جلسة. إذا استدعى مساعدك منفّذ التعليمات البرمجية في وقت واحد ضمن سلسلتَي محادثة مختلفتين، فسيؤدي ذلك إلى إنشاء جلستين لمنفّذ التعليمات البرمجية (2 × 0.03 دولار). تبقى كل جلسة نشطة افتراضيًا لمدة ساعة واحدة، ما يعني أنك لن تدفع هذه الرسوم إلا مرة واحدة إذا استمر مستخدمك في توجيه التعليمات إلى منفّذ التعليمات البرمجية ضمن سلسلة المحادثة نفسها لمدة تصل إلى ساعة واحدة.
ما تكلفة البحث في الملفات في واجهة API؟
تبلغ تكلفة البحث في الملفات 0.10 دولار لكل غيغابايت من مساحة تخزين المتجهات يوميًا (أول غيغابايت من التخزين مجاني). يُحدَّد حجم مخزن المتجهات بناءً على حجمه الناتج بعد تحليل ملفك وتجزئته وتضمينه.
ستظل جميع مخازن المتجهات التي أُنشئت قبل 17 أبريل 2024 مجانية حتى نهاية عام 2024، وبعد ذلك سيُطبَّق عليها أحد الإجراءين التاليين:
تُحتسب رسومها بالأسعار السارية (حاليًا 0.10 دولار لكل غيغابايت يوميًا) إذا استُخدمت مرة واحدة على الأقل في عملية تشغيل أُنشئت بعد 17 أبريل 2024.
تُحذف إذا لم تُستخدم في أي عملية تشغيل بين 17 أبريل 2024 و31 ديسمبر 2024، وذلك لتجنّب تحميلك رسوم مخازن متجهات ربما أنشأتها قبل الإعلان عن هذا التغيير في الأسعار ولم تستخدمها مطلقًا.
هل يوجد حد لعدد المساعدين الذين يمكنني إنشاؤهم؟
لا يوجد حد لعدد المساعدين الذين يمكن للمؤسسة إنشاؤهم.
هل تدعم واجهة API البث؟
نعم، تدعم واجهة Assistants API البث.
هل يتوفر وضع JSON في واجهة Assistants API؟
نعم، يتوفر وضع JSON في واجهة Assistants API عبر المعلمة response_format في كائنات Assistants أو Run.
هل ستتولى واجهة Assistants API أيضًا إدارة طلبات استدعاء دوال الجهات الخارجية؟
لا. تتيح ميزة استدعاء الأدوات للنموذج اختيار الأدوات وتنسيق الطلبات الموجَّهة إليها، لكن OpenAI لا تتولى إدارة تنفيذ الاستدعاءات لأدوات الجهات الخارجية.
كيف يجري التعامل مع البيانات التي أرسلها إلى OpenAI؟
كما هو الحال في بقية منصتنا، فإن البيانات والملفات المُرسَلة إلى واجهة OpenAI API لا تُستخدم مطلقًا لتدريب نماذجنا، ويمكنك حذف بياناتك متى شئت. تُخزَّن البيانات المرفوعة إلى واجهة Assistants API لأجل غير مسمّى إلى أن يحذفها المستخدم يدويًا.
هل يتوفر DALL-E عبر واجهة Assistants API؟
لا يتوفر DALL-E حاليًا.
هل توجد واجهة مستخدم لـ Assistants API؟
يمكنك تجربة Playground الخاص بـ Assistants API. تأكد من أنك في عرض Assistants في الشريط الجانبي الأيسر وتستخدم نموذجًا متوافقًا مع الأدوات التي تريد تفعيلها.
ما الحد الأقصى لعدد الأحرف في تعليمات المساعد في واجهة Assistants API؟
يبلغ الحد الأقصى لطول حقل تعليمات المساعد 256,000 حرف.
تظهر لي رسالة خطأ مثل «حدث خطأ في الخادم أثناء معالجة طلبك. نعتذر عن ذلك! يمكنك إعادة محاولة إرسال طلبك، أو التواصل معنا عبر مركز المساعدة على help.openai.com إذا استمر الخطأ. » ماذا أفعل؟
إذا ظهر لك هذا الخطأ، فقد يعني ذلك أن مطالبتك لم تُعَدّ بشكل صحيح. إذا كررت محاولة إرسال الطلب واستمر فشله، فإليك بعض الخطوات التي يمكنك تجربتها:
أعِد هيكلة مطالبتك بحيث يُتعامل مع أي أوامر تشبه الدوال على أنها دوال
أضِف أي أوامر في مطالبتك إلى tools بصفتها دوال
لماذا لا تعمل أداة البحث في الملفات لديّ بشكل جيد؟
عند استخدام أداة البحث في الملفات، نوصي بضبط max_prompt_tokens على قيمة لا تقل عن 20,000. للمحادثات الأطول أو التفاعلات المتعددة مع البحث في الملفات، فكّر في زيادة هذا الحد إلى 50,000، أو يُفضَّل إزالة حدود max_prompt_tokens تمامًا للحصول على نتائج بأعلى جودة.
كيف يمكنني تقديم ملاحظاتي؟
يسعدنا تلقّي ملاحظاتك على منتدى المطوّرين، أو عبر مركز المساعدة على help.openai.com، أو على تويتر عبر @OpenAIDevs.