# شروع اجرا با دستیار گام‌به‌گام

> هر مرحلهٔ دستیار ارسال، از وظیفه تا بررسی قرارداد.

ویزارد ارسال یک اجرا را راه‌اندازی و شروع می‌کند. این ویزارد چهار مرحله دارد: **وظیفه**، **ورودی‌ها**، **بهینه‌ساز** و **معیار و اجرا**. هر مرحله یک یا چند صفحه دارد. این راهنما هر صفحه را توضیح می‌دهد، از وظیفه تا بررسی قرارداد و شروع اجرا.

> [!NOTE]
> ویزارد برای هر سطح تجربه تنظیمات بیشتر یا کمتری نشان می‌دهد: **راهنمایی‌شده**، **استاندارد** یا **حرفه‌ای**. راهنمایی‌شده پیش‌فرض است. سطح را در **تنظیمات ← حساب**، در **چه مقدار نمایش داده شود** تغییر دهید. برخی برچسب‌ها در سطح راهنمایی‌شده ساده‌تر هستند. این راهنما از برچسب‌های استاندارد و حرفه‌ای استفاده می‌کند و هر جا برچسب راهنمایی‌شده متفاوت باشد، آن را داخل پرانتز می‌آورد.

## مرحلهٔ 1: وظیفه

### چه چیزی را می‌خواهید بهینه کنید؟

وظیفهٔ خود را در گفتگوی **مصاحبهٔ وظیفه** برای دستیار توضیح دهید. دستیار دو فیلد را برای شما می‌نویسد:

- **هدف** (راهنمایی‌شده: **مقصود شما**): کاری که آرتیفکت بهینه‌شده باید به‌خوبی انجام دهد.
- **پیش‌زمینه** (راهنمایی‌شده: **زمینهٔ بیشتر**): زمینه، محدودیت‌ها و اینکه یک نتیجهٔ خوب چه شکلی دارد.

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

### چه چیزی بهینه می‌شود

**نوع آرتیفکت** را انتخاب کنید:

| نوع آرتیفکت   | چه چیزی تغییر می‌کند                                  |
| ------------- | ----------------------------------------------------- |
| پرامپت        | دستورالعمل‌هایی که به یک مدل زبانی فرستاده می‌شوند     |
| کد            | کد منبع یک برنامه                                     |
| برنامهٔ DSPy  | دستورالعمل‌های predictor یک ماژول DSPy                 |
| متن           | هر متن دیگری، مانند یک سند یا یک قالب                 |

سپس **نسخهٔ شروع** (راهنمایی‌شده: **نقطهٔ شروع**) را بدهید. نسخهٔ فعلی را بچسبانید، یا بگذارید دستیار یک پیش‌نویس بنویسد.

### بهینه‌سازی یک مخزن

همچنین می‌توانید کد یک مخزن را بهینه کنید. این فیلدها را تنظیم کنید:

- **مخزن**: یک مخزن انتخاب کنید، یا آن را به شکل `owner/name` بنویسید.
- **کامیت**: یک SHA چهل‌نویسه‌ای. برای استفاده از آخرین کامیت شاخه، آن را خالی بگذارید.
- **مسیرهایی که بهینه‌ساز می‌تواند تغییر دهد**: در هر خط یک فایل یا پوشه. نقطه به معنی کل مخزن است.
- **فرمان راه‌اندازی**: پیش از امتیازدهی در هر checkout تازه اجرا می‌شود. آن را خالی بگذارید تا Skynet فرمان را پیدا کند.

## مرحلهٔ 2: ورودی‌ها

### داده

نمونه‌های اجرا را اضافه کنید. می‌توانید:

- یک فایل CSV، JSON یا Excel بارگذاری کنید.
- یک مجموعه‌داده از کتابخانهٔ خود انتخاب کنید.

صفحه‌های [مجموعه‌داده‌ها و تقسیم](/docs/fa/concepts/datasets) و [آماده‌سازی یک مجموعه‌داده](/docs/fa/guides/datasets) را بخوانید.

### نحوهٔ خواندن داده

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

- هر ستون را به‌عنوان ورودی یا خروجی مورد انتظار علامت بزنید، یا آن را نادیده بگیرید.
- بدون ستون خروجی، Skynet از ردیف اول به‌عنوان یک ورودی استفاده می‌کند.
- تقسیم به مجموعه‌های آموزش، اعتبارسنجی و آزمون را تنظیم کنید. مجموع تقسیم باید 1 باشد.

> [!WARNING]
> تا وقتی مرحلهٔ **ورودی‌ها** مشکلی دارد، نمی‌توانید مراحل بعدی را باز کنید. مشکلاتی را که ویزارد نشان می‌دهد برطرف کنید و سپس ادامه دهید.

## مرحلهٔ 3: بهینه‌ساز

در سطح استاندارد، این مرحله یک صفحه دارد. این صفحه بهینه‌ساز، بودجه و در صورت نیاز، مدل‌ها را نشان می‌دهد. در سطح‌های راهنمایی‌شده و حرفه‌ای، این مرحله سه صفحه دارد: **بهینه‌ساز**، **مدل‌ها** و **بودجه**.

### بهینه‌ساز

ویزارد فقط بهینه‌سازهایی را فهرست می‌کند که با وظیفه و ورودی‌های شما سازگار هستند. **Auto** برای شما انتخاب شده است. اگر بخواهید، بهینه‌ساز دیگری انتخاب کنید. صفحه‌های [موتورها](/docs/fa/concepts/engines) و [بهینه‌سازی چگونه کار می‌کند](/docs/fa/concepts/optimization) را بخوانید.

### مدل‌ها

- **مدل وظیفه**: مدلی که کد اجرای شما فراخوانی می‌کند. اگر کد اجرای شما مدلی را فراخوانی نمی‌کند، آن را خالی بگذارید. برنامهٔ DSPy باید مدل وظیفه داشته باشد.
- **مدل بازاندیشی**: مدلی که امتیازها و بازخورد را می‌خواند و نامزدهای بعدی را می‌نویسد. با یک بهینه‌ساز مبتنی بر عامل کدنویسی، این همان مدل عامل است.

### بودجه

تعیین کنید اجرا تا چه مدت می‌تواند به تلاش ادامه دهد و چقدر می‌تواند خرج کند:

- **حداکثر اجراهای امتیازدهنده** (راهنمایی‌شده: **حداکثر تلاش‌ها**): بیشترین تعداد نامزدهایی که Skynet امتیاز می‌دهد. برخی بهینه‌سازها به یک حداقل تعداد نیاز دارند.
- **توقف در امتیاز** (راهنمایی‌شده: **وقتی امتیاز به این مقدار رسید زودتر متوقف شود**): وقتی یک نسخه به این امتیاز برسد، اجرا متوقف می‌شود.
- **حداکثر تکرارها** (راهنمایی‌شده: **حداکثر دورها**): برای بهینه‌سازهایی که از آن پشتیبانی می‌کنند نمایش داده می‌شود.
- **سقف هزینه**: بیشترین مبلغی که اجرا می‌تواند خرج کند. پیش‌فرض $5 است، یا مبلغ **لازم برای شروع** اگر بیشتر باشد. همچنین می‌توانید **بدون سقف** را انتخاب کنید.

اگر سقف یا موجودی شما کمتر از مبلغ لازم برای شروع باشد، ویزارد اجازهٔ ادامه نمی‌دهد. صفحهٔ [بودجه‌ها و صورت‌حساب](/docs/fa/concepts/billing) را بخوانید.

## مرحلهٔ 4: معیار و اجرا

### کد و معیار

دو فایل بنویسید:

- `run.py`: کد اجرا که آرتیفکت شما را روی یک نمونه اجرا می‌کند.
- `metric.py`: معیاری که به خروجی امتیاز می‌دهد و بازخورد می‌نویسد.

**عامل کدنویسی** می‌تواند هر فایلی را برای شما بنویسد و تغییر دهد. این عامل کد خود را بررسی می‌کند و آنچه را ناموفق است اصلاح می‌کند. می‌توانید حداکثر 20 فایل اضافی اضافه کنید. صفحهٔ [معیارها و امتیازدهنده‌ها](/docs/fa/concepts/scorers) را بخوانید.

اگر معیار شما `llm()` را فراخوانی می‌کند، **مدل معیار** را تنظیم کنید. به‌طور پیش‌فرض از مدل بازاندیشی استفاده می‌کند.

### بررسی قرارداد

**بررسی قرارداد** (راهنمایی‌شده: **اجرای آزمایشی**) کد و معیار شما را در sandbox روی 3 نمونهٔ آزمایشی اجرا می‌کند. این موارد را بررسی می‌کند:

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

**بررسی** (راهنمایی‌شده: **آزمودن**) را انتخاب کنید. تا وقتی بررسی قبول نشود، نمی‌توانید اجرا را شروع کنید. اگر پس از قبول شدن، کد یا تنظیمات را تغییر دهید، بررسی را دوباره اجرا کنید.

> [!TIP]
> هر نمونه را باز کنید تا ورودی، خروجی و بازخورد آن را ببینید. بازخورد خوب، چیزی بیشتر از امتیاز تنها در اختیار بهینه‌ساز می‌گذارد.

### اجرای زمان‌بندی‌شده

می‌توانید بهینه‌سازی را پس از موفقیت، طبق یک زمان‌بندی دوباره اجرا کنید. پیش‌فرض **خاموش** است.

### آماده‌ی اجرا

صفحهٔ آخر یک خلاصه را در پنج زبانه نشان می‌دهد: **عمومی**، **داده‌ها**، **مدل‌ها**، **بودجه** و **پاداش**. تنظیمات را بررسی کنید و سپس بهینه‌سازی را شروع کنید.

خلاصه همچنین میزان نمایان بودن اجرا را نشان می‌دهد. اجراهای جدید به‌طور پیش‌فرض عمومی هستند. بعداً آن را در پنجرهٔ **اشتراک‌گذاری و حریم خصوصی** در صفحهٔ اجرا تغییر دهید. صفحهٔ [اشتراک‌گذاری و انتشار](/docs/fa/guides/sharing) را بخوانید.

> [!NOTE]
> اجرای مخزن در این مرحله فقط صفحهٔ **کد و معیار** و خلاصه را دارد. Skynet هنگام شروع اجرا، تنظیمات را در برابر مخزن بررسی می‌کند.

## پس از شروع

صفحهٔ اجرا باز می‌شود. صفحه‌های [اجراها](/docs/fa/concepts/runs) و [خواندن نتایج](/docs/fa/guides/results) را بخوانید.

---

Source: https://staging.skynetml.com/docs/fa/guides/submit