اعتبارًا من 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 المطورين من إنشاء مساعدين أقوياء مدعومين بـ AI بسهولة داخل تطبيقاتهم. تلغي واجهة API هذه الحاجة إلى إدارة سجل المحادثة وتضيف إمكانية الوصول إلى أدوات تستضيفها OpenAI مثل منفّذ التعليمات البرمجية وFile Search. تدعم API أيضًا استدعاء الأدوات المحسّن لأدوات الجهات الخارجية.
هل لا يزال بإمكاني استخدام Assistants API v1 beta؟
لا. اعتبارًا من 18 ديسمبر 2024، لم يعد لدى المستخدمين وصول إلى الإصدار v1 من Assistant API beta. ندعم حاليًا v2 فقط. يرجى الاطّلاع على دليل الترحيل هذا لتحويل استدعاءات API من v1 إلى v2
كيف يمكنني الوصول إليها؟
تتوفر Assistants API لأي شخص لديه حساب OpenAI API، لكنها مهملة وستُزال في أغسطس 2026. للمشاريع الجديدة، استخدم Responses API بدلاً منها. إذا كنت تستخدم Assistants API بالفعل، فخطط للترحيل إلى Responses API. لا يزال بإمكانك الوصول إلى المساعدين الحاليين في Assistants Playground ما دامت API متاحة.
ما هو المساعد؟
يمثّل المساعد نظام AI مخصصًا لغرض محدد يستخدم نماذج OpenAI ويمكنه الوصول إلى الملفات، والحفاظ على سلاسل محادثة مستمرة، واستدعاء الأدوات.
ما هي سلسلة المحادثة؟
سلسلة المحادثة هي جلسة حوار بين مساعد ومستخدم. تسهّل سلاسل المحادثة تطوير التطبيقات من خلال تخزين سجل الرسائل واقتطاعه عندما تصبح المحادثة أطول من طول سياق النموذج.
ما هي أداة File Search؟
تنفّذ أداة `file_search` عدة ممارسات فضلى للاسترجاع تلقائيًا لمساعدتك في استخراج البيانات المناسبة من ملفاتك لتعزيز ردود النموذج. لمزيد من المعلومات، يرجى قراءة وثائق المطورين لدينا.
افتراضيًا، تستخدم أداة file_search الإعدادات التالية:
حجم المقطع: 800 رمز
تداخل المقاطع: 400 رمز
نموذج التضمين: `text-embedding-3-large` بـ 256 بُعدًا
الحد الأقصى لعدد المقاطع المضافة إلى السياق: 20
ما قيود تحميل الملفات؟
قيود تحميل ملف هي:
512 ميغابايت لكل ملف
5 ملايين رمز لكل ملف
10 آلاف ملف لكل مخزن متجهات
مخزن متجهات واحد لكل مساعد
مخزن متجهات واحد لكل سلسلة محادثة
حد التخزين الإجمالي لكل مشروع في المؤسسة هو 100 غيغابايت.
ما قيود أداة File Search؟
لدينا بعض القيود المعروفة التي نعمل على إضافة دعم لها خلال الأشهر المقبلة:
لا توجد حاليًا طريقة لتعديل إعدادات التقسيم إلى مقاطع أو التضمين أو الاسترجاع.
لا ندعم تحليل الصور داخل المستندات.
لا ندعم عمليات الاسترجاع عبر تنسيقات الملفات المهيكلة (مثل ملفات .csv أو .jsonl). اطّلع على أنواع الملفات المدعومة.
ما حدود الاستخدام الخاصة بـ Assistants API؟
لا ترتبط حدود الاستخدام الخاصة بـ Assistants API بـ فئة الاستخدام والنموذج. بدلاً من ذلك، توجد حدود افتراضية حسب نوع الطلب، مع بعض الاستثناءات:
GET: 1000 طلب في الدقيقة
POST: 300 طلب في الدقيقة
DELETE: 300 طلب في الدقيقة
كيف يتم تسعير منفّذ التعليمات البرمجية في API؟
يبلغ سعر منفّذ التعليمات البرمجية 0.03 دولار أمريكي لكل جلسة. إذا استدعى مساعدك منفّذ التعليمات البرمجية في سلسلتي محادثة مختلفتين في الوقت نفسه، فسيؤدي ذلك إلى إنشاء جلستين لمنفّذ التعليمات البرمجية (2 * 0.03 دولار). تكون كل جلسة نشطة افتراضيًا لمدة ساعة واحدة، ما يعني أنك لن تدفع هذه الرسوم إلا مرة واحدة إذا واصل المستخدم إعطاء التعليمات إلى منفّذ التعليمات البرمجية في سلسلة المحادثة نفسها لمدة تصل إلى ساعة واحدة.
كيف يتم تسعير File Search في API؟
يبلغ سعر File Search 0.10 دولار أمريكي/غيغابايت من مساحة تخزين مخزن المتجهات يوميًا (أول غيغابايت من التخزين مجاني). يعتمد حجم مخزن المتجهات على الحجم الناتج لمخزن المتجهات بعد تحليل ملفك وتقسيمه إلى مقاطع وتضمينه.
أي مخازن متجهات أُنشئت قبل 17 أبريل 2024 ستكون مجانية حتى نهاية عام 2024، وبعد ذلك إما أن:
تُفرض عليها الرسوم بالأسعار الحالية (حاليًا 0.10 دولار أمريكي/غيغابايت/اليوم) إذا استُخدمت مرة واحدة على الأقل في Run أُنشئ بعد 17 أبريل 2024.
تُحذف إذا لم تُستخدم في أي Run واحد بين 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
لماذا لا تعمل أداة File Search لديّ جيدًا؟
عند استخدام أداة File Search، نوصي بتعيين max_prompt_tokens على ما لا يقل عن 20,000. للمحادثات الأطول أو التفاعلات المتعددة مع File Search، فكّر في زيادة هذا الحد إلى 50,000، أو الأفضل، إزالة حدود max_prompt_tokens تمامًا للحصول على أعلى جودة للنتائج. اقرأ المزيد هنا.
كيف يمكنني تقديم ملاحظات؟
يسعدنا سماع ملاحظاتك على منتدى المطورين، أو عبر مركز المساعدة على help.openai.com، أو على Twitter @OpenAIDevs.