मुख्य सामग्री पर जाएं
प्रशिक्षण मार्गदर्शिका के अध्याय सभी दस्तावेज़

ट्रेनिंग की समस्याएँ सुलझाएँ और त्रुटियों से उबरें

पहुँच, डेटा, GPU, चेकपॉइंट, रिपोर्ट, एक्सपोर्ट और गुणवत्ता की समस्याएँ महँगा काम अंधाधुंध दोहराए बिना सुलझाएँ।

प्रशिक्षण मार्गदर्शिका के अध्याय

हर भाषा में कमांड और कोड अंग्रेज़ी में ही रहेंगे। बड़े अक्षरों वाले प्लेसहोल्डर को अपने खाते और भुगतान किए गए कार्य के मानों से बदलें; साझा नोटबुक या लॉग में असली कुंजियाँ न डालें।

दोबारा कोशिश से पहले समस्या पहचानें

फिर शुरू करने से पहले मौजूदा स्टेटस पढ़ें और सही काम सुरक्षित रखें।
  1. पता लगाएँ एक्सेस, डेटा, कंप्यूट या आउटपुट
  2. जाँचें स्टेटस और संवेदनशील जानकारी हटाए डायग्नॉस्टिक्स
  3. सुधारें असल समस्या ठीक करें
  4. रिकवर करें सुरक्षित रिज़्यूम या नया रिव्यू किया रन

पता लगाएँ: एक्सेस, डेटा, कंप्यूट या आउटपुट. जाँचें: स्टेटस और संवेदनशील जानकारी हटाए डायग्नॉस्टिक्स. सुधारें: असल समस्या ठीक करें. रिकवर करें: सुरक्षित रिज़्यूम या नया रिव्यू किया रन

पहुँच और रनटाइम की विफलताएँ अलग करें

HTTP स्थिति, अपने काम या रन की ID, खाते का दायरा और सशुल्क संदर्भ मॉडल तक पहुँच देखें। स्थानीय रन शुरू करने से पहले अडैप्टर की अनुकूलता और जाँची हुई योजना देखें। API key से GPU मेमोरी नहीं मिलती और न ही दूसरे खाते के संसाधनों तक पहुँच मिलती है। मदद माँगते समय संवेदनशील जानकारी हटाकर जाँच-सूचना साझा करें।

  • पैकेज का संस्करण, रनटाइम, सत्र या रन की ID, त्रुटि कोड और आखिरी सफल कार्रवाई लिख लें।
  • कनेक्शन टूटने पर हर POST दोबारा न भेजें; सर्वर अनुरोध पहले ही स्वीकार कर चुका हो सकता है।
  • जाँच के कमांड स्थानीय जानकारी पढ़ते हैं और लॉगिन की जानकारी उजागर नहीं करते।
HTTP त्रुटियाँ
फ़ील्ड या इंटरफ़ेसप्रकार या परिणामडिफ़ॉल्ट या एग्ज़िट कोडव्यवहार और सत्यापन
401 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं कुंजी दिखाए बिना उसकी वैधता जाँचें; खाते की स्वीकृत क्रेडेंशियल प्रक्रिया अपनाएँ।
403 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं ai:training अधिकार, सशुल्क पहुँच, स्वामित्व और पात्रता जाँचें; पहुँच-नियंत्रण न तोड़ें।
404 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं आपके सही UUID और एंडपॉइंट की जाँच करें; दूसरे खाते की सामग्री पहुँच से बाहर रहनी चाहिए।
409 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं दूसरा बदलाव करने से पहले मौजूदा सत्र की स्थिति पढ़ें। तैयारी के दौरान संदर्भ लॉक हुआ हो सकता है।
422 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं लौटाई गई फ़ील्ड-जाँच की त्रुटियाँ ठीक करें; कीमतें या अस्वीकृत कॉन्फ़िगरेशन न भेजें।
429 HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं सुरक्षित पढ़ने वाले अनुरोधों में दर-सीमा और प्रतीक्षा-अवधि मानें; बार-बार कोशिश की अनंत कड़ी न बनाएँ।
5xx / timeout HTTP अनिवार्य / कोई डिफ़ॉल्ट नहीं लिखने वाला अनुरोध दोहराने से पहले मौजूदा स्थिति पढ़ें। सीमित GET दोबारा कोशिशें तैयारी या ट्रेनिंग दोहराने की अनुमति नहीं हैं।
उदाहरण · bash
# Inspect package metadata, not credentials or private dataset contents.
python -m pip show fusionpointai-training
python -m pip check
# On NVIDIA hosts where nvidia-smi is installed:
nvidia-smi
# Keep the local report; never dump env, auth headers or provider responses.
# The documentation does not launch these commands for you.

कंप्यूट, डेटा और रिपोर्ट की समस्याएँ सुलझाएँ

पहचानें कि समस्या अनुकूलन से पहले हुई, ट्रेनिंग के दौरान या सही आउटपुट बनने के बाद। TrainingProject जाँचे हुए प्रोजेक्ट चेकपॉइंट से रन फिर शुरू करता है; पुरानी सत्र-प्रक्रिया अलग है और प्रोजेक्ट की रिकवरी स्थिति इस्तेमाल नहीं करती। कोई लिखने वाली कार्रवाई दोहराने या नई आउटपुट डायरेक्टरी बनाने से पहले रन का सार और रिपोर्ट देखें।

  • डेटासेट के हैश, मॉडल फ़िंगरप्रिंट या स्वामित्व की जाँच कभी न छोड़ें।
  • बैच आकार, परिशुद्धता या बजट बदलने से योजना बदलती है; बेमेल रिकवरी थोपने के बजाय नया रन शुरू करें।
  • काम के मान्य आउटपुट रखें और केवल उसी रन की अस्थायी फ़ाइलें हटाएँ।
प्रशिक्षण और डिलीवरी की जाँच
फ़ील्ड या इंटरफ़ेसप्रकार या परिणामडिफ़ॉल्ट या एग्ज़िट कोडव्यवहार और सत्यापन
out_of_memory runtime अनिवार्य / कोई डिफ़ॉल्ट नहीं मॉडल का आकार, प्रिसिजन और हर डिवाइस का बैच साइज़ देखें। नई संगत योजना की समीक्षा करें; फिर शुरू किए रन को चुपचाप न बदलें।
dataset_integrity data अनिवार्य / कोई डिफ़ॉल्ट नहीं अपेक्षित बाइट, पंक्तियाँ और SHA-256 मिलाएँ। अंतर मिलने पर रुकें और सही, अपने स्वामित्व वाला डेटा लें।
checkpoint_mismatch recovery अनिवार्य / कोई डिफ़ॉल्ट नहीं उसी तय संस्करण वाले इनपुट को बहाल करें या नया प्रोजेक्ट रन शुरू करें। बेमेल चेकपॉइंट को ज़बरदस्ती न चलाएँ और सत्र का चेकपॉइंट आयात न करें।
budget_exhausted budget अनिवार्य / कोई डिफ़ॉल्ट नहीं सबसे नई मान्य स्थिति सुरक्षित रखें। बड़े बजट के लिए अलग से समीक्षित योजना चाहिए।
no_progress quality अनिवार्य / कोई डिफ़ॉल्ट नहीं डेटा की क्वालिटी और छूटी क्षमताएँ जाँचें, फिर तय साइकिल बजट के भीतर रुकें; अनिश्चित समय तक दोहराएँ नहीं।
regression quality अनिवार्य / कोई डिफ़ॉल्ट नहीं बची हुई आधार-मॉडल क्षमताओं और विफल मानदंडों की तुलना करें। हानिकारक प्रतिगमन को औसत में छिपाएँ नहीं।
report_failed service अनिवार्य / कोई डिफ़ॉल्ट नहीं मान्य स्थानीय आर्टिफ़ैक्ट रखें। दोबारा ट्रेनिंग के बजाय, अनुमति हो तो सेवा की स्थिति देखकर रिपोर्ट का मिलान करें।
export_invalid artifact अनिवार्य / कोई डिफ़ॉल्ट नहीं आधार मॉडल और टोकनाइज़र का मेल, फ़ाइल पथ और चेकसम जाँचें; फिर से लोड करना सफल होने तक प्रकाशित न करें।
उदाहरण · bash
# Recover an interrupted run without starting it twice.
fpai-training status --run ./german-project/runs/german-001
# paused + valid atomic checkpoint -> resume the same pinned plan.
fpai-training resume --run ./german-project/runs/german-001
# fingerprint mismatch -> restore matching data/config; NEVER force resume.
# budget change -> create a NEW run and reviewed plan, retaining prior reports.
# no valid checkpoint -> start a NEW output directory, not a fake resume.

अधूरे लक्ष्य को ईमानदारी से देखें

केवल सत्यापन-हानि कम होने से माँगी गई क्षमता साबित नहीं होती। अलग रखे गए कार्य, बेसलाइन, हर विषय का प्रदर्शन, बची हुई क्षमताएँ और डेटा-रिसाव जाँचें। सुधार रुकने या प्रतिगमन दिखने पर काम रोकें। उसी विफल व्यवस्था में बार-बार संसाधन लगाने के बजाय नई समीक्षित योजना में लक्ष्य या डेटा बदलें।

  • छूटे हुए विषय, गलत वर्ग-नाम, दोहराए गए परीक्षा-प्रश्न और टोकनाइज़र की असंगतियाँ देखें।
  • दर्ज करें कि कौन-से मानदंड विफल हुए और स्वीकृत बजट कितना खर्च हुआ।
  • स्वीकृति में विफल मॉडल की सामग्री रखी जा सकती है, लेकिन उसे स्वीकृत उत्पादन-मॉडल के रूप में पेश नहीं करना चाहिए।
उदाहरण · text
SDK 0.2.0 QUALITY DIAGNOSTICS
1. Compare untouched baseline and final model on identical held-out tasks.
2. Examine each criterion and retained capability, not an average alone.
3. Reject data overlap and examples leaked to the teacher.
4. Check label quality, topic coverage, class balance and tokenizer compatibility.
5. Use remaining approved cycles only; stop for no_progress or regression.
6. Preserve unmet_criteria and the latest valid artifact after a failed target.
7. Revise data/objective/budget in a NEW reviewed plan before a new run.
Never report accepted merely because loss decreased or a script exited normally.