از 11 مارس 2025، ما اجزای سازنده پلتفرم جدید Agents خود را منتشر کرده‌ایم. برای جزئیات، مستندات API ما را برای Responses API، ابزارهایی از جمله جستجوی وب، جستجوی فایل و استفاده از رایانه، و Agents SDK ما همراه با ردیابی ببینید. بر اساس بازخورد شما برای نسخه بتای Assistants API، بهبودهای کلیدی را در Responses API گنجانده‌ایم. پس از دستیابی به برابری کامل قابلیت‌ها، اواخر امسال یک برنامه منسوخ‌سازی Assistants API را اعلام خواهیم کرد، با تاریخ هدف برای پایان ارائه در نیمه اول 2026.
پرسش‌های متداول
API دستیارها چیست؟
API دستیارها به توسعه‌دهندگان امکان می‌دهد به‌راحتی دستیارهای هوش مصنوعی قدرتمندی در برنامه‌های خود بسازند. این API نیاز به مدیریت تاریخچهٔ گفتگو را برطرف می‌کند و دسترسی به ابزارهایی مانند مفسر کد و جستجوی فایل را که OpenAI میزبانی می‌کند، فراهم می‌سازد. این API همچنین از قابلیت بهبودیافتهٔ درخواست عملکرد برای ابزارهای شخص ثالث پشتیبانی می‌کند.
آیا هنوز می‌توانم از نسخه بتای v1 Assistants API استفاده کنم؟
خیر. از ۱۸ دسامبر ۲۰۲۴، کاربران دیگر به نسخه v1 بتای Assistant API دسترسی ندارند. در حال حاضر فقط از v2 پشتیبانی می‌کنیم. برای تبدیل فراخوانی‌های API خود از v1 به v2، این راهنمای مهاجرت را ببینید.
چگونه به آن دسترسی پیدا کنم؟
Assistants API برای هر کسی که حساب OpenAI API دارد در دسترس است، اما منسوخ شده و در اوت 2026 حذف خواهد شد. برای پروژه‌های جدید، به‌جای آن از Responses API استفاده کنید. اگر هم‌اکنون از Assistants API استفاده می‌کنید، برای مهاجرت خود به Responses API برنامه‌ریزی کنید. تا زمانی که API همچنان در دسترس است، هنوز می‌توانید در Assistants Playground به دستیارهای موجود دسترسی داشته باشید.
دستیار چیست؟
دستیار، هوش مصنوعی‌ای است که برای هدف مشخصی ساخته شده، از مدل‌های OpenAI استفاده می‌کند و می‌تواند به فایل‌ها دسترسی داشته باشد، رشته‌های گفتگو را به‌صورت پایدار نگه دارد و ابزارها را فراخوانی کند.
رشتهٔ گفتگو چیست؟
رشتهٔ گفتگو، نشستی برای گفتگو میان دستیار و کاربر است. رشته‌های گفتگو با ذخیرهٔ تاریخچهٔ پیام‌ها و کوتاه‌کردن آن وقتی طول گفتگو از ظرفیت بافت مدل فراتر می‌رود، توسعهٔ برنامه را ساده‌تر می‌کنند.
ابزار جستجوی فایل چیست؟
ابزار file_search از همان ابتدا چند روش برتر بازیابی اطلاعات را به کار می‌گیرد تا بتوانید داده‌های مناسب را از فایل‌های خود استخراج کنید و پاسخ‌های مدل را غنی‌تر کنید.
ابزار file_search به‌طور پیش‌فرض از تنظیمات زیر استفاده می‌کند:
اندازهٔ هر قطعه: ۸۰۰ توکن
هم‌پوشانی قطعه‌ها: ۴۰۰ توکن
مدل تعبیه‌سازی: text-embedding-3-large با ۲۵۶ بُعد
حداکثر تعداد قطعه‌های افزوده‌شده به بافت: ۲۰
بارگذاری فایل چه محدودیت‌هایی دارد؟
محدودیت‌های بارگذاری فایل عبارت‌اند از:
۵۱۲ مگابایت برای هر فایل
۵ میلیون توکن برای هر فایل
۱۰ هزار فایل برای هر مخزن برداری
۱ مخزن برداری برای هر دستیار
۱ مخزن برداری برای هر رشتهٔ گفتگو
سقف کل فضای ذخیره‌سازی برای هر پروژه در یک سازمان ۱۰۰ گیگابایت است.
ابزار جستجوی فایل چه محدودیت‌هایی دارد؟
چند محدودیت شناخته‌شده وجود دارد که در تلاشیم طی ماه‌های آینده آن‌ها را برطرف کنیم:
در حال حاضر، امکان تغییر تنظیمات قطعه‌بندی، تعبیه‌سازی یا بازیابی وجود ندارد.
از تجزیه‌وتحلیل تصاویر داخل اسناد پشتیبانی نمی‌کنیم.
از بازیابی اطلاعات از قالب‌های فایل ساختاریافته (مانند فایل‌های .csv یا .jsonl) پشتیبانی نمی‌کنیم. انواع فایل پشتیبانی‌شده را ببینید.
محدودیت نرخ درخواست در API دستیارها چقدر است؟
محدودیت‌های نرخ درخواست در API دستیارها به سطح استفاده و مدل وابسته نیستند. در عوض، به‌جز چند استثنا، محدودیت‌های پیش‌فرض بر اساس نوع درخواست تعیین می‌شوند:
GET: ۱۰۰۰ درخواست در دقیقه
POST: ۳۰۰ درخواست در دقیقه
DELETE: ۳۰۰ درخواست در دقیقه
هزینهٔ مفسر کد در API چگونه محاسبه می‌شود؟
هزینهٔ مفسر کد برای هر نشست ۰٫۰۳ دلار است. اگر دستیار شما مفسر کد را هم‌زمان در دو رشتهٔ گفتگوی مختلف فراخوانی کند، دو نشست مفسر کد ایجاد می‌شود (۲ × ۰٫۰۳ دلار). هر نشست به‌طور پیش‌فرض یک ساعت فعال می‌ماند؛ یعنی اگر کاربر شما تا یک ساعت در همان رشتهٔ گفتگو به مفسر کد دستور بدهد، فقط یک بار این هزینه را پرداخت می‌کنید.
هزینهٔ جستجوی فایل در API چگونه محاسبه می‌شود؟
هزینهٔ جستجوی فایل روزانه ۰٫۱۰ دلار به‌ازای هر گیگابایت فضای ذخیره‌سازی مخزن برداری است (اولین گیگابایت رایگان است). حجم مخزن برداری بر اساس حجم نهایی آن پس از تجزیه، قطعه‌بندی و تعبیه‌سازی فایل شما محاسبه می‌شود.
مخزن‌های برداری ایجادشده پیش از ۱۷ آوریل ۲۰۲۴ تا پایان سال ۲۰۲۴ رایگان خواهند بود و پس از آن، یکی از دو حالت زیر برایشان اعمال می‌شود:
اگر دست‌کم یک بار در یک Run ایجادشده پس از ۱۷ آوریل ۲۰۲۴ استفاده شده باشند، هزینهٔ آن‌ها با نرخ جاری محاسبه می‌شود (در حال حاضر، روزانه ۰٫۱۰ دلار به‌ازای هر گیگابایت).
اگر از ۱۷ آوریل ۲۰۲۴ تا ۳۱ دسامبر ۲۰۲۴ در هیچ Run استفاده نشده باشند، حذف می‌شوند. این کار برای جلوگیری از دریافت هزینه بابت مخزن‌های برداری‌ای است که ممکن است پیش از اعلام این تغییر قیمت ساخته باشید، اما هرگز از آن‌ها استفاده نکرده باشید.
آیا محدودیتی برای تعداد دستیارهایی که می‌توانم ایجاد کنم وجود دارد؟
هیچ محدودیتی برای تعداد دستیارهایی که یک سازمان می‌تواند ایجاد کند وجود ندارد.
آیا دریافت جریانی پاسخ در API در دسترس است؟
بله، دریافت جریانی پاسخ در API دستیارها در دسترس است.
آیا حالت JSON در API دستیارها در دسترس است؟
بله، حالت JSON در API دستیارها از طریق پارامتر response_format در اشیای Assistants یا Run در دسترس است.
آیا API دستیارها درخواست‌های فراخوانی توابع شخص ثالث را هم مدیریت می‌کند؟
خیر. قابلیت درخواست عملکرد به مدل اجازه می‌دهد ابزارها را انتخاب و درخواست‌های مربوط به آن‌ها را قالب‌بندی کند، اما اجرای فراخوانی ابزارهای شخص ثالث را OpenAI مدیریت نمی‌کند.
با داده‌هایی که به OpenAI می‌فرستم چگونه برخورد می‌شود؟
مانند سایر بخش‌های پلتفرم ما، داده‌ها و فایل‌های ارسال‌شده به API OpenAI هرگز برای آموزش مدل‌های ما استفاده نمی‌شوند و هر زمان که بخواهید می‌توانید داده‌های خود را حذف کنید. داده‌های بارگذاری‌شده در API دستیارها بدون محدودیت زمانی نگهداری می‌شوند، تا زمانی که کاربر آن‌ها را به‌صورت دستی حذف کند.
آیا DALL-E از طریق API دستیارها در دسترس است؟
در حال حاضر، DALL-E در دسترس نیست.
آیا برای Assistants API رابط کاربری وجود دارد؟
می‌توانید Playground را برای Assistants API بررسی کنید. مطمئن شوید در نمای Assistants در نوار کناری سمت چپ هستید و از مدلی سازگار با ابزارهایی که می‌خواهید فعال کنید استفاده می‌کنید.
محدودیت تعداد نویسه‌های دستورالعمل‌های دستیار در API دستیارها چقدر است؟
فیلد دستورالعمل‌های دستیار حداکثر ۲۵۶٬۰۰۰ نویسه می‌پذیرد.
با خطایی مانند این روبه‌رو می‌شوم: «سرور هنگام پردازش درخواست شما با خطا مواجه شد. از این بابت عذرخواهی می‌کنیم! می‌توانید درخواست خود را دوباره ارسال کنید یا اگر خطا ادامه داشت، از طریق مرکز راهنمایی ما به نشانی help.openai.com با ما تماس بگیرید. » چه کار باید بکنم؟
اگر با این خطا روبه‌رو می‌شوید، ممکن است اعلان شما به‌درستی تنظیم نشده باشد. اگر با ارسال دوبارهٔ درخواست همچنان خطا دریافت می‌کنید، این راه‌ها را امتحان کنید:
ساختار اعلان را طوری تغییر دهید که هر دستور شبیه به تابع، به‌عنوان تابع در نظر گرفته شود
هر دستوری را که در اعلان دارید، به‌صورت تابع به tools اضافه کنید
چرا ابزار جستجوی فایل من خوب کار نمی‌کند؟
هنگام استفاده از ابزار جستجوی فایل، توصیه می‌کنیم مقدار max_prompt_tokens را دست‌کم روی ۲۰٬۰۰۰ تنظیم کنید. برای گفتگوهای طولانی‌تر یا تعامل‌های متعدد با جستجوی فایل، بهتر است این سقف را به ۵۰٬۰۰۰ افزایش دهید یا، در حالت ایدئال، محدودیت max_prompt_tokens را به‌کلی بردارید تا باکیفیت‌ترین نتایج را دریافت کنید.
چگونه می‌توانم بازخورد بدهم؟
خوشحال می‌شویم بازخورد شما را در انجمن توسعه‌دهندگان، از طریق مرکز راهنمایی به نشانی help.openai.com یا در توییتر @OpenAIDevs دریافت کنیم.