از ۱۱ مارس ۲۰۲۵، اجزای سازندهٔ پلتفرم جدید عاملهای خود را منتشر کردهایم. برای جزئیات، مستندات API ما را برای API پاسخها، ابزارهایی از جمله جستجوی وب، جستجوی فایل و استفاده از رایانه، و نیز SDK عاملها همراه با ردیابی ببینید.
بدون ارتقای خودکار: دستیارها، رشتهها و اجراهای فعلی شما بهطور خودکار به v2 منتقل نمیشوند. آنها همچنان از طریق API نسخه v1 در دسترس و فعال میمانند، مگر اینکه خودتان آنها را بهصورت دستی منتقل کنید.
دسترسی به هر دو نسخه: هر دو نسخه v1 و v2 از API بهطور کامل در دسترس شما هستند. بنابراین، میتوانید برای دستیارهای فعلی خود همچنان از v1 استفاده کنید یا قابلیتها و بهبودهای جدید v2 را بررسی کنید.
تفاوت در مصرف توکن: ممکن است مصرف توکن در v1 و v2، بهویژه در ابزارهایی مانند file_search و retrieval، متفاوت باشد. ابزار file_search در v2 معمولاً بهطور میانگین نسبت به ابزار retrieval در v1 توکنهای کمتری مصرف میکند؛ بااینحال، در صورت تمایل همچنان میتوانید با سربرگ نسخه v1 از ابزار قدیمیتر retrieval استفاده کنید.
گزینههای مهاجرت: رابط کاربری Playground و نسخههای بهروزشده SDK از نسخه v2 این API استفاده میکنند و درخواستهای Assistants API باید شامل سربرگ OpenAI-Beta: assistants=v2 باشند. نسخه v1 از Assistants API منسوخ شده است؛ همه یکپارچهسازیهای باقیمانده با v1 باید به v2 منتقل شوند. برای اطلاعات بیشتر درباره مهاجرت از Assistants v1 به v2، این راهنمای مهاجرت را ببینید.