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

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

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

به‌روزرسانی: 15 hours 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

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

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

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

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

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