Chat Completions، API استاندارد برای استفاده با جدیدترین مدلهای OpenAI است. میتوانید با استفاده از راهنمای توسعهدهندگان برای تولید متن ما، با نحوه شروع کار با آن آشنا شوید.
از ۱۱ مارس ۲۰۲۵، اجزای سازنده پلتفرم جدید عاملهای خود را منتشر کردهایم. برای جزئیات، اسناد API ما را برای API پاسخها، ابزارهایی از جمله جستوجوی وب، جستوجوی فایل و استفاده از رایانه، و SDK عاملهای ما همراه با ردیابی ببینید.
تبدیل اعلانها به پیامها
برای داشتن گفتوگویی تعاملیتر و پویاتر با مدلهای ما، میتوانید بهجای قالب قدیمی مبتنی بر اعلان که در تکمیلها استفاده میشد، از پیامها در قالب چت استفاده کنید.
نحوهٔ کار به این صورت است:
بهجای ارسال یک رشتهٔ اعلان، فهرستی از اشیای پیام را بهعنوان ورودی میفرستید.
هر پیام یک نقش و معمولاً یک محتوا دارد.
نقشهای رایج عبارتاند از system، user، assistant، developer و tool. پیامهای ابزار برای نتایج ابزار یا تابع استفاده میشوند و باید با فراخوانیهای ابزار توسط دستیار مطابقت داشته باشند. برای سازگاری با نسخههای قبلی، ممکن است پیامهای تابع همچنان پذیرفته شوند و هنگام پردازش در سرور به پیامهای ابزار تبدیل شوند. ممکن است پیامهای توسعهدهنده بسته به پشتیبانی مدل بازنگاشت شوند.
محتوا شامل متن پیامِ ارسالشده از سوی آن نقش است.
دستورالعمل سیستم میتواند رهنمودهای کلی گفتوگو را مشخص کند.
پیامها بهترتیب نمایش در فهرست پردازش میشوند و دستیار نیز متناسب با آنها پاسخ میدهد.
همانطور که در ادامه میبینید، حتی درخواستهای سادهٔ تکمیل را نیز میتوان از طریق تکمیلهای چت انجام داد:
| قبلاً | اکنون |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'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 دستیاران را ببینید.