OpenAI
این صفحه به‌صورت ماشینی ترجمه شده است. مقاله اصلی انگلیسی را مشاهده کنید.

مدیریت اعلان در Playground

اعلان‌های باکیفیت برای شروع سریع هر یکپارچه‌سازی موفق

به‌روزرسانی: 11 days ago

نمای کلی

آخرین به‌روزرسانی Playground ما یک جریان کاری ساختاریافته و سازگار با بازگشت به نسخه قبلی معرفی می‌کند تا بتوانید با اطمینان تکرار کنید، تغییرات را اعتبارسنجی کنید و با گام‌های کمتر از آزمایش به تولید برسید. در ادامه، نگاهی سریع به قابلیت‌هایی که عرضه می‌شوند و روش شروع کار داریم.

تازه‌ها

اعلان‌های سطح پروژه

اعلان‌ها اکنون در سطح پروژه هستند و دیگر در سطح کاربر نیستند.

تاریخچه نسخه با بازگشت یک‌کلیکی

هر پیش‌نویسی را منتشر کنید تا نسخه‌ای جدید ایجاد شود، سپس نسخه‌ای قبلی را فوراً بازیابی کنید. در پشت صحنه، یک شناسه اعلان همیشه به آخرین نسخه منتشرشده اشاره می‌کند و اگر مرجعی ثابت می‌خواهید، می‌توانید یک نسخه مشخص را نیز تعیین کنید.

متغیرهای اعلان

جای‌نگهدارهایی مانند {user_goal} اضافه کنید تا اعلان ثابت از اطلاعات ویژه هر نمونه (ورودی‌ها) جدا شود.

شناسه اعلان

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

مقایسه کنار هم

پیش از عرضه، خروجی‌های دو نسخه را به‌صورت بصری مقایسه کنید تا تصمیم بگیرید کدام بهتر عمل می‌کند.

متغیرهای شناسایی‌شده در API و SDK

اکنون Responses API و Agents SDK همان {variables}ی را می‌پذیرند که در Playground تعریف می‌کنید؛ بنابراین اعلانی که آزمایش می‌کنید همان اعلانی است که به‌صورت برنامه‌نویسی فراخوانی می‌کنید—فعلاً فقط متن رندرشده را ارسال کنید.

یکپارچه‌سازی داخلی ارزیابی‌ها (اجراهای دستی)

یک ارزیابی را پیوند دهید تا متغیرها از پیش پر شوند و نتایج قبولی/رد را مستقیماً در صفحه جزئیات اعلان ببینید. این پیوند همراه با شناسه اعلان ذخیره می‌شود تا آزمون‌ها قابل تکرار باشند.

بهینه‌سازی

بهینه‌سازی ابزار جدیدی است که در صفحه‌های Playground و گزارش‌ها در دسترس است و با شناسایی و رفع تناقض‌ها، دستورالعمل‌های نامشخص و قالب‌های خروجیِ جاافتاده، اعلان‌ها را به‌طور خودکار بهبود می‌دهد.

وقتی اجرا شود، نسخه‌ای بهبودیافته از اعلان شما یا پیشنهادهایی مفید، همراه با خلاصه‌ای از تغییرات انجام‌شده، برمی‌گرداند. می‌توانید بازبینی‌ها را پیش‌نمایش کنید و با یک کلیک آن‌ها را مستقیماً در Playground اعمال کنید.

---

راهنمای شروع سریع

ایجاد یک اعلان

به Playground → اعلان‌ها → ایجاد مورد جدید بروید، متن خود را پیش‌نویس کنید و در صورت نیاز {variables} اضافه کنید.

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

از قابلیت بهینه‌سازی برای بازبینی و پیشنهاد بهبودها استفاده کنید.

افزودن یک عملکرد (اختیاری)

درخواست عملکرد به شما امکان می‌دهد بدون ترک Playground، اعلان خود را به کنش‌ها یا داده‌های دنیای واقعی متصل کنید.

برای دستورالعمل‌های بیشتر درباره استفاده از عملکردها، لطفاً به مقاله ما مراجعه کنید: درخواست عملکرد در Chat Playground

پیوست کردن یک ارزیابی (اختیاری)

برای ایجاد داده‌های آزمایشی، اجرای نمره‌دهنده‌ها و بررسی نتایج قبولی/رد، پیوند دادن ارزیابی را انتخاب کنید. پس از هر انتشار، ارزیابی را دوباره اجرا کنید تا تا زمان فعال شدن اجراهای خودکار، پسرفت‌ها را شناسایی کنید.

انتشار

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

تکرار

اعلان جدید خود را آزمایش کنید، نتایج را بررسی کنید و در صورت نیاز تکرار کنید.

نکاتی برای ساخت اعلان‌های عالی

راهنمایی کلی درباره لحن یا نقش را در پیام سیستم قرار دهید؛ جزئیات و نمونه‌های ویژه وظیفه را در پیام‌های کاربر نگه دارید.

نمونه‌های چند نمونه را در یک بلوک کوتاه به سبک YAML یا فهرست گلوله‌ای ترکیب کنید تا مرور و به‌روزرسانی آن‌ها آسان باشد.

ساختار پروژه خود را با نام‌های پوشه روشن بازتاب دهید تا هم‌تیمی‌ها بتوانند اعلان‌ها را سریع پیدا کنند.

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

---

پرسش‌های متداول

آیا پیش‌تنظیم‌های موجود من دچار مشکل می‌شوند؟

اعلان‌ها روشی قدرتمندتر برای مدیریت پیکربندی هستند و از نسخه‌بندی و متغیرهای الگو پشتیبانی می‌کنند. همه پیش‌تنظیم‌های موجود شما را می‌توان با استفاده از گزینه «وارد کردن پیش‌تنظیم» در فهرست کشویی اعلان Playground به اعلان‌ها وارد کرد.

Import preset as prompt dialog with preset options and a warning that prompts are visible to project users

آیا باید نسخه‌ای را در کد مشخص کنم؟

فقط اگر می‌خواهید یک نسخه قدیمی‌تر را ثابت نگه دارید. فراخوانی شناسه اعلان به‌تنهایی همیشه از آخرین نسخه استفاده می‌کند.

آیا می‌توانم اجرای ارزیابی‌ها را خودکار کنم؟

در حال حاضر، فقط اجرای مجددِ دستی در دسترس است.

آیا این مقاله مفید بود؟