فەرمان و کۆد لە هەموو زمانێکدا بە ئینگلیزی دەمێننەوە. جێگرەوە گەورەنووسەکان بە بەهای هەژمار و کاری پارەدراوی خۆت بگۆڕە؛ کلیلی ڕاستەقینە لە نۆتبووکی هاوبەش یان تۆمارەکاندا مەنووسە.
ڕەوتی کاری هێڵی فەرمان
- init / doctor پڕۆژە دروست و پشکنین بکە
- plan بەبێ ڕاهێنان پێداچوونەوە بکە
- run لە سنووری بودجەدا ڕاهێنان بکە
- evaluate پێوەری لادراو بپشکنە
- export پشتڕاست و پاکێج بکە
init / doctor: پڕۆژە دروست و پشکنین بکە. plan: بەبێ ڕاهێنان پێداچوونەوە بکە. run: لە سنووری بودجەدا ڕاهێنان بکە. evaluate: پێوەری لادراو بپشکنە. export: پشتڕاست و پاکێج بکە
ڕیزێکی ڕوونی فەرمان بەدوادا بگرە
بەرنامەی fpai-training هەمان گرێبەستی پڕۆژەی ڕووکاری Python بەکاردەهێنێت: دەستپێکردن، پشکنینی گونجانی، پێداچوونەوە بە پلانی dry-run، جێبەجێکردن، هەڵسەنگاندن و هەناردە. خوێندنەوەی دۆخ یان پلان بەڵگەی سەرکەوتنی ڕاهێنان نییە.
- پشتڕاستکردنەوە لە FUSIONPOINTAI_API_KEY دەخوێنرێتەوە. هەڵبژاردەی command-line بۆ کلیلی API نییە.
- لە بەرنامە یان فەرماندا --help بەکاربهێنە. --version وەشانی دامەزراوی پاکێج ڕادەگەیەنێت.
- پلانە پێداچوونەوەکراوەکە ڕێکخستنی چارەسەرکراو جێگیر دەکات. هیچ زیادکاریی نەنووسراوی CLI بۆ hyperparameter پشتگیری ناکرێت.
| خانە یان ڕووکار | جۆر یان ئەنجام | بنەڕەت یان کۆدی دەرچوون | هەڵسوکەوت و پشتڕاستکردنەوە |
|---|---|---|---|
init --directory PATH |
command |
پێویست / بەبێ بنەڕەت | پێکهاتەی پڕۆژەی نوێ و ڕێکخستنی نموونە دروست بکە؛ بوخچەی ناپڕ بەتاڵ بێت. هیچ ڕاهێنان یان پەیوەندیی پارەدراو ناکات. |
doctor --config PATH |
command |
پێویست / بەبێ بنەڕەت | سکیما، پەڕگەی مۆدێلی ناوخۆ، پەیوەندییەکان، هەڵگرتن، ئامێر و گونجانی ئادا‌پتەر بپشکنە. کێش ناگۆڕێت و مامۆستا بانگ ناکات. |
plan --config PATH --dry-run |
command |
پێویست / بەبێ بنەڕەت | بنەما چارەسەر بکە، fingerprint جێگیر بکە و بابەت، هاوبەشکردن، بودجە و دەرچوون پیشان بدە. باشترکردن یان کاری پارەدراوی مامۆستا ناکات. |
run --config PATH |
command |
پێویست / بەبێ بنەڕەت | پلانێکی دروستی پێداچوونەوەکراو و مۆڵەتی چالاکی دەوێت؛ ڕاکردنێک قفڵ بکە و ڕاهێنانی ڕاستەقینە لە بودجەدا جێبەجێ بکە. |
status --run PATH |
command |
پێویست / بەبێ بنەڕەت | وێنەی دۆخی ناوخۆییی بێ‌نهێنیی ڕاکردن بخوێنەوە. کارکەر هەڵناستێنێتەوە و داواکاریی مامۆستا دروست ناکات. |
pause --run PATH |
command |
پێویست / بەبێ بنەڕەت | داوای وەستانی پارێزراو بکە و تا checkpointی ئەتۆمیکی تەواو چاوەڕێ بکە. تەنها بۆ ڕاکردنی چالاکە. |
resume --run PATH |
command |
پێویست / بەبێ بنەڕەت | تەنها ڕاکردنی pauseکراو/پچڕاوی گەڕاندنەوەپەذیر، دوای پشتڕاستکردنەوەی توندی checkpoint و پلان resume بکە. |
cancel --run PATH |
command |
پێویست / بەبێ بنەڕەت | کارکەرە خاوەنداریکراوەکان بوەستێنە، سەرچاوەی خاوەنداریکراو ئازاد بکە و هەڵوەشاندنەوە تۆمار بکە؛ دەرچوون و diagnosticsی دروست بپارێزە. |
evaluate --run PATH --split test |
command |
پێویست / بەبێ بنەڕەت | مۆدێلی pinکراو بە دژی داتای پشتڕاستکردنەوە یان تاقیکردنەوە هەڵبسەنگێنە. باشترکردن و هاوبەشکردنی داتای شاراوە ناکات. |
export --run PATH --format safetensors |
command |
پێویست / بەبێ بنەڕەت | دەرچوونی پشتگیریکراوی قبوڵکراو پشتڕاست و پاکێج بکە؛ بارکردنی دەرەکی یان دانانی زیندوو نییە. |
fpai-training --version
fpai-training --help
fpai-training init --directory ./german-project
# Replace training.json and rubric/data files with your reviewed configuration.
fpai-training doctor --config ./german-project/training.json
fpai-training plan --config ./german-project/training.json --dry-run
# Inspect resolved values, data sharing and budgets BEFORE the next command.
fpai-training run --config ./german-project/training.json
fpai-training status --run ./german-project/runs/german-001
fpai-training evaluate --run ./german-project/runs/german-001 --split test
fpai-training export --run ./german-project/runs/german-001 --format safetensors
# Supply the key through FUSIONPOINTAI_API_KEY, never a command-line argument.بە شێوەی پارێزراو pause، resume یان cancel بکە
فەرمانی کۆنترۆڵ بۆ یەک بوخچەی ڕاکردنی خاوەنداریکراوە. Pause چاوەڕێی checkpointی ئەتۆمیک و پشتڕاستکردنەوەی کارکەر دەکات. Resume هەمان مۆدێل، داتا، ڕێکخستن، هەڵسەنگێنەر و fingerprintی تۆپۆلۆژی دەپشکنێت. Cancel تەنها کارکەرەکانی ئەم ڕاکردنە دەوەستێنێت و هەڵوەشاندنەوەی کۆتایی تۆمار دەکات. دووبارەکردنەوەی داواکاریی کۆنترۆڵ نابێت پرۆسەی ڕاهێنانی نوێ دروست بکات.
- ڕاکردنی pauseکراو دەتوانرێت بگەڕێندرێتەوە، بەڵام تەواو نییە. ڕاکردنی cancelکراو بەرهەمی قبوڵکراو نییە.
- کاتێک ڕاکردن لە پاشبنەما چالاکە، بۆ کۆنترۆڵ لە terminalێکی دووەم بەکاربهێنە.
- دوای timeout پێش دووبارەکردنەوە دۆخ بخوێنەوە. فایلەکانی lock مەسڕەوە و کاری GPUی بێ‌پەیوەندی مەوەستێنە.
| خانە یان ڕووکار | جۆر یان ئەنجام | بنەڕەت یان کۆدی دەرچوون | هەڵسوکەوت و پشتڕاستکردنەوە |
|---|---|---|---|
--directory |
path |
پێویست / بەبێ بنەڕەت | بۆ init پێویستە. بوخچەی پڕۆژەی نوێی نووسراو. |
--config |
path |
پێویست / بەبێ بنەڕەت | بۆ doctor، plan و run پێویستە. ڕێڕەوی پەڕگەی تەواوی schema 1.0. |
--run |
path |
پێویست / بەبێ بنەڕەت | بۆ status، pause، resume، cancel، evaluate و export پێویستە. بوخچەی ڕاکردنی خاوەنداریکراوە، نەک IDی هەژمار/session. |
--dry-run |
flag |
true |
هەڵبژاردەی دیاریکراوی پلان؛ plan هەمیشە بەرامبەر کێش و کاری پارەدراو تەنها خوێندنەوەیە. دۆخی جێبەجێکردنی false/off نییە. |
--split |
enum |
"test" |
تەنها evaluate: validation یان test. داتای test هەرگیز بۆ باشترکردن بەکارناهێنرێت. |
--format |
enum |
"safetensors" |
تەنها export: safetensors یان adapters، بەپێی توانای ئادا‌پتەر. |
--help |
flag |
false |
یارمەتیی بەرنامە یان فەرمان پیشان بدە بێ دەستگەیشتن بە دابینکەر. |
--version |
flag |
false |
metadataی ڕاستەقینەی وەشانی دامەزراو پیشان بدە، نەک وەشانی schemaی ڕێکخستن. |
# Run controls from a separate terminal if training is active.
fpai-training pause --run ./german-project/runs/german-001
# Wait for status=paused and a completed atomic checkpoint before stopping a host.
fpai-training status --run ./german-project/runs/german-001
fpai-training resume --run ./german-project/runs/german-001
# Cancellation is terminal; preserve existing artifacts, do not pretend it passed.
fpai-training cancel --run ./german-project/runs/german-001
# Repeat status, not run(), after a timeout. Never kill an unrelated process.دۆخ و کۆدی دەرچوون پێکەوە لێک بدەرەوە
دەرچوونی صفر واتە کردارە داواکراوەکە سەرکەوتوو بوو؛ بەڵام خوێندنەوەی سەرکەوتووی دۆخ، pause یان dry-run ڕاهێنانی قبوڵکراو نییە. ئەنجامی ڕاهێنانیش دۆخی تەواوبوو، هۆکاری وەستانی پەسەندکراو و تێپەڕاندنی هەموو پێوەری پێویست دەوێت. ئامانجی تێپەڕنەبوو لە ڕاپۆرتدا دەمێنێتەوە، نەک بە سەرکەوتوو ناوببرێت.
- فەرمانەکان JSONی خوێندراوەی ئامێر بۆ stdout و diagnosticsی بێ‌نهێنی بۆ stderr دەنووسن. نهێنی لە هیچکامدا نایەت.
- run و resume تا دۆخی کۆتایی یان pauseکراو چاوەڕێ دەکەن؛ status وێنەی دۆخی ئێستا دەگەڕێنێتەوە.
- SIGINT دوای پاککردنەوەی باشترین-هەوڵی کارکەرە خاوەنداریکراوەکان بە 130 دەردەچێت. پرۆسەی پچڕاو ناتوانێت checkpointی تەواوبوو دروست بکات.
SDK 0.2.0 EXIT AND STATE CONTRACT
0 accepted, successful read/control, or successful dry-run; inspect operation.
2 invalid configuration; no training started.
3 incompatible model/runtime/method/export combination.
4 authentication, entitlement or authorized-sharing failure.
5 resource budget exhausted; preserve latest valid checkpoint and report.
6 evaluation requirements not met; not an accepted model.
7 execution, checkpoint, cancellation-control or export failure.
130 interrupted by the caller.
Lifecycle:
planned -> preparing -> training -> evaluating -> completed
training -> pausing -> paused -> training (validated resume)
active -> cancelling -> cancelled
active -> failed
stop_reason: accepted | budget_exhausted | no_progress | regression |
cancelled | failed
paused is a recoverable state, not an accepted training result.
completed requires stop_reason=accepted and all required criteria passing.
Repeated control requests must read/reuse the owned transition, not spawn workers.
One run lock prevents duplicate execution of the same run directory.