بازدان بۆ ناوەڕۆکی سەرەکی
بەشەکانی ڕێنمایی ڕاهێنان هەموو بەڵگەنامەکان

پڕۆژەی ڕاهێنان دروست بکە و ڕایبکە

SDK 0.2.0 دابمەزرێنە، پڕۆژە ڕێک بخە، پلانی بپشکنە و مۆدێلێکی ناوخۆ ڕابهێنە.

فەرمان و کۆد لە هەموو زمانێکدا بە ئینگلیزی دەمێننەوە. جێگرەوە گەورەنووسەکان بە بەهای هەژمار و کاری پارەدراوی خۆت بگۆڕە؛ کلیلی ڕاستەقینە لە نۆتبووکی هاوبەش یان تۆمارەکاندا مەنووسە.

پڕۆژە دروست بکە و ڕایبکە

پێش بەکارهێنانی بەرهەمی ناوخۆ، پلان و هەڵسەنگاندن بپشکنە.
  1. دامەزراندن ژینگەی Python
  2. ڕێکخستن مۆدێل، داتا و ڕوبریک
  3. پلان گونجانی تەکنیکی و بودجە
  4. ڕاهێنان باشترکردنی ناوخۆ
  5. پشکنین هەڵسەنگاندن و بەرهەم

دامەزراندن: ژینگەی Python. ڕێکخستن: مۆدێل، داتا و ڕوبریک. پلان: گونجانی تەکنیکی و بودجە. ڕاهێنان: باشترکردنی ناوخۆ. پشکنین: هەڵسەنگاندن و بەرهەم

ژینگەکەت ئامادە بکە

Python 3.10 یان نوێتر لە ژینگەیەکی مەجازیی تایبەتدا بەکاربهێنە. زیادکراوی ڕاهێنان و وەشانی PyTorchی گونجاو لەگەڵ ژینگە دابمەزرێنە. TrainingProject ئادا‌پتەری مۆدێلی زمانی causalی Transformersی بەردەست بە پشکنینی توانای SFT، LoRA یان QLoRA بەکاردەهێنێت. کلیلی APIی هەژمار، دەستگەیشتنی پارەدراوی چالاک بۆ کردارەکانی مامۆستا، مۆدێلی ناوخۆی گونجاو، داتای پەسەندکراو و هەڵگرتنی بەس پێویستە. هەڵبژاردنی ژینگەیەک ئامێری ڕاستەقینە دابین ناکات.

  • پاکێجی بنەڕەتی TrainingClient و APIی پڕۆژە دابین دەکات؛ زیادکراوی train پێداویستییەکانی ڕاهێنانی ناوخۆ دادەمەزرێنێت.
  • کلیلەکانی API لە ژینگەی نهێنیی runtime هەڵبگرە، نەک پەڕگەی پڕۆژە یان ئارگومێنتی فەرمان.
  • QLoRA ژینگەی CUDAی گونجاو و پەیوەندییەکانی quantization پێویستە.
نموونە · bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
# Install the GPU-compatible PyTorch build for your runtime first.
python -m pip install 'fusionpointai-training[train] @ https://fusionpointai.com/downloads/fusionpointai-training.zip'
# API-only use without local training dependencies:
# python -m pip install 'fusionpointai-training @ https://fusionpointai.com/downloads/fusionpointai-training.zip'

پڕۆژەکە ڕێک بخە و پێداچوونەوەی بۆ بکە

بوخچەی پڕۆژە دروست بکە، پەڕگەی JSONLی ڕاهێنان، پشتڕاستکردنەوە و تاقیکردنەوەی کۆتایی ئامادە بکە و training.json و rubric.json دەستکاری بکە. ڕێڕەوی مۆدێلی قوتابیی ناوخۆ، دابینکەر و reference_model_idی لەخۆگیراو دابنێ. پلان ڕێکخستن، گونجانی مۆدێل، fingerprintی داتا، سیاسەتی هاوبەشکردن، بودجە و دەرچوونەکان پشتڕاست دەکاتەوە بێ گۆڕینی کێش یان پەیوەندی بە مامۆستا.

  • schema_version 1.0 بەکاربهێنە؛ ئەمە سکیماکەی ڕێکخستنە، نەک وەشانی پاکێج.
  • ڕێڕەوی پەیوەندیدار بە پڕۆژە بەکاربهێنە کە لە ناو ڕەگی پڕۆژە چارەسەر دەبن.
  • ڕاکردن پێویستی بە بوخچەی دەرچوونی نوێ هەیە؛ resume کردارێکی جیاوازە و fingerprintی توندی دەپشکنێت.
نموونە · bash
# Enter the key using a secure runtime secret facility or this history-safe prompt.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
python --version
fpai-training --version
# After the project run, clear the shell value: unset FUSIONPOINTAI_API_KEY
نموونە · json
{
  "schema_version": "1.0",
  "mode": "automatic",
  "objective": "Classify support messages as billing, account_access or technical_issue.",
  "model": {"path": "./models/student", "adapter": "transformers-causal-lm", "revision": null},
  "teacher": {"provider": "openai", "reference_model_id": 123},
  "data": {
    "sources": ["./data/train.jsonl"], "teacher_sharing": "none",
    "validation_path": "./data/validation.jsonl", "test_path": "./data/test.jsonl",
    "deduplicate": true, "seed": 42
  },
  "runtime": {"target": "customer_datacenter", "devices": "auto"},
  "training": {"method": "auto"},
  "curriculum": {"topics": ["intent", "ambiguous_requests", "class_balance"], "max_improvement_cycles": 3, "stop_on_regression": true},
  "budgets": {"max_training_minutes": 120, "max_teacher_requests": 1000, "max_storage_gib": 20},
  "checkpoints": {"keep_last": 3},
  "evaluation": {"rubric": "./rubric.json", "baseline_required": true},
  "output": {"directory": "./runs/german-001", "format": "safetensors"}
}
نموونە · python
import os
from fusionpointai_training import TrainingProject

project = TrainingProject.from_file(
    "./support-project/training.json",
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
)
plan = project.plan(dry_run=True)
print("Topics:", plan["topics"], "Budgets:", plan["budgets"])
result = project.run()
print("Run:", result["run_id"], result["status"], result["stop_reason"])
evaluation = project.evaluate(split="test")
print("Accepted:", evaluation["accepted"], evaluation["report_path"])
artifact = project.export(format="safetensors")
print("Artifact:", artifact["artifact_path"], artifact["sha256"])

هەڵسەنگاندن و بەرهەمی ناوخۆ بپشکنە

ڕاهێنان بنەمای مۆدێلی دەست‌نەخوراو و هەڵسەنگاندنی کۆتایی لەسەر ڕیزە ناوخۆییەکانی لادراو ئەنجام دەدات. ڕاپۆرت پێوەری پێوانەکراو، دواگەڕانەوە، fingerprint، بودجە و پێداویستیی جێبەجێنەکراو تۆمار دەکات. هەناردە مۆدێل یان پاکێجی ئادا‌پتەری ناوخۆی safetensors پشتڕاست دەکاتەوە و manifest دەنووسێت. ئادا‌پتەر هێشتا مۆدێلی بنەڕەت و tokenizerی دیاریکراوی پێویستە. ڕاکردنی سەرکەوتوو کوالێتیی ئەرکێک لە دەرەوەی پێوەری پێوانەکراو دڵنیایی ناکات.

  • پەڕگەی بنەما و تاقیکردنەوەی کۆتایی لە داتای ڕاهێنان و مامۆستا جیا بپارێزە.
  • پێش بەکارهێنان evaluation-report.json و artifact-manifest.json بپشکنە.
  • هەناردە مۆدێل بارناکات و inferenceی بەرهەمهێنان دانانێت.
نموونە · bash
cat ./support-project/runs/support-001/training-report.json
cat ./support-project/runs/support-001/evaluation-report.json
cat ./support-project/runs/support-001/artifact-manifest.json
sha256sum ./support-project/runs/support-001/exports/safetensors/artifact-manifest.json
# Compare the digest with the value returned by project.export().
# Adapter exports also require the matching base model and tokenizer.