Chat Completions، API استاندارد برای استفاده با جدیدترین مدلهای OpenAI است. میتوانید با استفاده از راهنمای توسعهدهندگان برای تولید متن ما، با نحوه شروع کار با آن آشنا شوید.
از ۱۱ مارس ۲۰۲۵، اجزای سازنده پلتفرم جدید عاملهای خود را منتشر کردهایم. برای جزئیات، اسناد API ما را برای API پاسخها، ابزارهایی از جمله جستوجوی وب، جستوجوی فایل و استفاده از رایانه، و SDK عاملهای ما همراه با ردیابی ببینید.
از اعلانها به پیامها
برای داشتن گفتگویی تعاملیتر و پویاتر با مدلهای ما، میتوانید بهجای سبک قدیمیِ اعلان که در تکمیلها استفاده میشد، از پیامهایی در قالب گفتگو استفاده کنید.
روش کار به این شکل است:
بهجای ارسال یک رشتهٔ اعلان واحد، فهرستی از اشیای پیام را بهعنوان ورودی میفرستید.
هر پیام یک
roleدارد و معمولاً یکcontentهم دارد.نقشهای رایج شامل
system،user،assistant،developerوtoolهستند. پیامهای ابزار برای نتایج ابزار/تابع استفاده میشوند و باید با فراخوانیهای ابزارِ دستیار متناظر باشند. برای سازگاری با نسخههای قبلی، ممکن است پیامهای تابع همچنان پذیرفته شوند و در پردازش سرور به پیامهای ابزار تبدیل شوند. پیامهای توسعهدهنده ممکن است بسته به پشتیبانی مدل دوباره نگاشت شوند.در
contentمتن پیامِ مربوط به آن نقش قرار میگیرد.دستورالعمل سیستم میتواند دستورالعملهای سطحبالایی برای گفتگو ارائه کند
پیامها به ترتیبی که در فهرست آمدهاند پردازش میشوند و دستیار مطابق آن پاسخ میدهد.
حتی درخواستهای سادهٔ تکمیل را هم میتوان از طریق تکمیلهای گفتگو انجام داد، همانطور که در زیر میبینید:
| قبلاً | اکنون | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
اکنون با گسترش فهرست پیامها در گفتگو، انجام رفتوبرگشت با مدل از همیشه آسانتر است.
'messages': [{'role':'user', 'content':'یک جوک برایم بگو'},
{'role':'assistant', 'content':'چرا مرغ از خیابان رد شد'},
{'role':'user', 'content':'نمیدانم، چرا مرغ از خیابان رد شد'}]دستورالعملهای سیستم
همچنین میتوانید از یک دستورالعمل در سطح سیستم برای هدایت رفتار مدل در سراسر مکالمه استفاده کنید. برای مثال، با استفاده از یک دستورالعمل سیستم و پیامی مانند این
'messages': [{'role':'system', 'content':'شما یک دستیار هستید که مثل شکسپیر صحبت میکند.'},
{'role':'user', 'content':'یک جوک برایم بگو'}, به چیزی شبیه این منجر میشود
{...
'message': {'role':'assistant',
'content':'چرا مرغ از خیابان رد شد؟ تا به آن طرف برسد، اما بهراستی آن طرف پر از مخاطره و خطر بود، پس فوراً به همانجایی که از آن آمده بود بازگشت، فیالواقع!'}
...}اگر میخواهید گزینههایی را بررسی کنید که نیازی به مدیریت دستی تاریخچه مکالمه پیامها توسط خودتان ندارند، API دستیاران را ببینید.