پرسش‌های متداول Assistants API (v2)

Assistants API چیست؟

Assistants API به توسعه‌دهندگان امکان می‌دهد به‌راحتی دستیارهای AI قدرتمند را در برنامه‌های خود بسازند. این API نیاز به مدیریت تاریخچه گفت‌وگو را برطرف می‌کند و دسترسی به ابزارهای میزبانی‌شده توسط OpenAI مانند مفسر کد و جستجوی فایل را اضافه می‌کند. این API همچنین از درخواست عملکرد بهبودیافته برای ابزارهای شخص ثالث پشتیبانی می‌کند.

آیا هنوز می‌توانم از Assistants API v1 beta استفاده کنم؟

خیر. از 18 دسامبر 2024، کاربران دیگر به نسخه v1 بتای Assistant API دسترسی ندارند. در حال حاضر فقط از v2 پشتیبانی می‌کنیم. لطفاً برای تبدیل فراخوانی‌های API خود از v1 به v2، این راهنمای مهاجرت را ببینید

چگونه به آن دسترسی پیدا کنم؟

Assistants API برای هر کسی که حساب OpenAI API دارد در دسترس است، اما منسوخ شده و در اوت 2026 حذف خواهد شد. برای پروژه‌های جدید، به‌جای آن از Responses API استفاده کنید. اگر هم‌اکنون از Assistants API استفاده می‌کنید، برای مهاجرت خود به Responses API برنامه‌ریزی کنید. تا زمانی که API همچنان در دسترس است، هنوز می‌توانید در Assistants Playground به دستیارهای موجود دسترسی داشته باشید.

دستیار چیست؟

یک دستیار نمایانگر یک AI هدف‌ساخته است که از مدل‌های OpenAI استفاده می‌کند و می‌تواند به فایل‌ها دسترسی داشته باشد، رشته‌های پایدار را حفظ کند و ابزارها را فراخوانی کند.

رشته چیست؟

رشته یک جلسه گفت‌وگو بین یک دستیار و یک کاربر است. رشته‌ها با ذخیره تاریخچه پیام‌ها و کوتاه‌کردن آن هنگامی که گفت‌وگو برای طول زمینه مدل بیش از حد طولانی می‌شود، توسعه برنامه را ساده‌تر می‌کنند.

ابزار جستجوی فایل چیست؟

ابزار `file_search` چندین رویه برتر بازیابی را به‌صورت آماده پیاده‌سازی می‌کند تا به شما کمک کند داده‌های درست را از فایل‌هایتان استخراج کنید و پاسخ‌های مدل را تقویت کنید. برای اطلاعات بیشتر، لطفاً مستندات توسعه‌دهنده ما را بخوانید.

به‌طور پیش‌فرض، ابزار file_search از تنظیمات زیر استفاده می‌کند:

• اندازه قطعه: 800 توکن

• هم‌پوشانی قطعه: 400 توکن

• مدل جاسازی: `text-embedding-3-large` با 256 بُعد

• حداکثر تعداد قطعه‌های افزوده‌شده به زمینه: 20

محدودیت‌های بارگذاری فایل چیست؟

محدودیت‌های بارگذاری یک فایل عبارت‌اند از:

• 512 مگابایت برای هر فایل

• 5 میلیون توکن برای هر فایل

• 10 هزار فایل برای هر vector store

• 1 vector store برای هر دستیار

• 1 vector store برای هر رشته

حد کلی فضای ذخیره‌سازی برای هر پروژه در یک سازمان 100 گیگابایت است.

محدودیت‌های ابزار جستجوی فایل چیست؟

چند محدودیت شناخته‌شده داریم که در ماه‌های آینده در حال افزودن پشتیبانی برای آن‌ها هستیم:

1. در حال حاضر راهی برای تغییر تنظیمات قطعه‌بندی، جاسازی یا بازیابی وجود ندارد.

2. ما از تجزیه تصاویر داخل اسناد پشتیبانی نمی‌کنیم.

3. ما از بازیابی روی قالب‌های فایل ساختاریافته (مانند فایل‌های .csv یا .jsonl) پشتیبانی نمی‌کنیم. انواع فایل پشتیبانی‌شده را ببینید.

محدودیت تعداد درخواست برای Assistants API چیست؟

محدودیت‌های تعداد درخواست برای Assistants API به سطح استفاده و مدل وابسته نیستند. در عوض، محدودیت‌های پیش‌فرض بر اساس نوع درخواست وجود دارد، با چند استثنا:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 درخواست در دقیقه

قیمت‌گذاری مفسر کد در API چگونه است؟

مفسر کد با قیمت 0.03 دلار به‌ازای هر جلسه محاسبه می‌شود. اگر دستیار شما مفسر کد را هم‌زمان در دو رشته متفاوت فراخوانی کند، این کار دو جلسه مفسر کد ایجاد می‌کند (2 * $0.03). هر جلسه به‌طور پیش‌فرض به‌مدت یک ساعت فعال است؛ یعنی اگر کاربر شما تا یک ساعت در همان رشته به مفسر کد دستور بدهد، این هزینه را فقط یک‌بار پرداخت می‌کنید.

قیمت‌گذاری جستجوی فایل در API چگونه است؟

جستجوی فایل با قیمت 0.10 دلار به‌ازای هر گیگابایت فضای ذخیره‌سازی vector store در روز محاسبه می‌شود (اولین گیگابایت ذخیره‌سازی رایگان است). اندازه vector store بر اساس اندازه نهایی vector store پس از تجزیه، قطعه‌بندی و جاسازی فایل شما تعیین می‌شود.

هر vector store که پیش از 17 آوریل 2024 ایجاد شده باشد تا پایان سال 2024 رایگان خواهد بود و پس از آن یکی از این دو حالت رخ می‌دهد:

• اگر حداقل یک‌بار در یک Run ایجادشده پس از 17 آوریل 2024 استفاده شده باشند، با نرخ‌های فعلی (در حال حاضر 0.10 دلار/گیگابایت/روز) صورتحساب می‌شوند.

• اگر بین 17 آوریل 2024 و 31 دسامبر 2024 حتی در یک Run هم استفاده نشده باشند، حذف می‌شوند — این برای جلوگیری از صدور صورتحساب برای vector storeهایی است که شاید پیش از اعلام این تغییر قیمت‌گذاری ایجاد کرده اما هرگز استفاده نکرده باشید.

آیا محدودیتی برای تعداد دستیارهایی که می‌توانم ایجاد کنم وجود دارد؟

هیچ محدودیتی برای تعداد دستیارهایی که یک سازمان می‌تواند ایجاد کند وجود ندارد.

آیا پخش جریانی در 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 با ما تماس بگیرید. » دریافت می‌کنم. چه کار کنم؟

اگر این خطا را دریافت می‌کنید، ممکن است به این معنی باشد که اعلان شما به‌درستی تنظیم نشده است. اگر مدام درخواست را دوباره امتحان می‌کنید و ناموفق است، چند مورد را امتحان کنید:

1. مطمئن شوید اعلان خود را بازساختاردهی می‌کنید تا هر دستور شبیه عملکرد را به‌عنوان عملکرد در نظر بگیرد

2. هر فرمان موجود در اعلان خود را به‌عنوان یک عملکرد به tools اضافه کنید

چرا ابزار جستجوی فایل من خوب کار نمی‌کند؟

هنگام استفاده از ابزار جستجوی فایل، توصیه می‌کنیم max_prompt_tokens را کمتر از 20,000 تنظیم نکنید. برای گفت‌وگوهای طولانی‌تر یا تعاملات متعدد با جستجوی فایل، در نظر بگیرید این محدودیت را به 50,000 افزایش دهید یا در حالت ایده‌آل، محدودیت‌های max_prompt_tokens را به‌طور کامل حذف کنید تا باکیفیت‌ترین نتایج را دریافت کنید. اطلاعات بیشتر را اینجا بخوانید.

چگونه می‌توانم بازخورد بدهم؟

خوشحال می‌شویم بازخورد شما را در انجمن توسعه‌دهندگان ما، از طریق مرکز راهنمایی در help.openai.com، یا در توییتر @OpenAIDevs بشنویم.