از ۱۱ مارس ۲۰۲۵، اجزای سازندهٔ پلتفرم جدید عاملهای خود را منتشر کردهایم. برای جزئیات، مستندات API ما را برای API پاسخها، ابزارهایی از جمله جستجوی وب، جستجوی فایل و استفاده از رایانه، و نیز SDK عاملها همراه با ردیابی ببینید.
بدون ارتقای خودکار: Assistants، Threads و Runs فعلی شما بهطور خودکار به 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 را برای یکپارچهسازی خود استفاده کنید. به یاد داشته باشید که هیچ نسخهٔ پیشفرضی از API برای اشیای Assistant وجود ندارد، بنابراین در صورت تمایل میتوانید تا پایان سال ۲۰۲۴ به استفاده از نسخهٔ قدیمیتر ادامه دهید. برای اطلاعات بیشتر دربارهٔ مهاجرت از Assistants v1 به v2، لطفاً این راهنمای مهاجرت را ببینید.