Table of Contents

व्यावहारिक AI कार्यप्रवाह पाठ्यक्रम पर लौटें

अच्छा निर्देश काम और उसके मूल्यांकन का तरीका बताता है। अधिक शब्द जोड़ने से अस्पष्ट दायरा स्पष्ट नहीं होता। यह पाठ इस पाठ्यक्रम की प्रयोगशाला के लिए अस्पष्ट अनुरोध को कार्य पैकेट में बदलता है।

सीखने का लक्ष्य: आप स्रोत, फ़ाइल दायरा, जाँच और रुकने की शर्त वाला सीमित कार्य पैकेट लिखेंगे।

मुख्य बातें

  • परिणाम इच्छित आर्टिफ़ैक्ट या व्यवहार बताता है।
  • दायरा अनुमत फ़ाइलें और निषिद्ध कार्रवाइयाँ बताता है।
  • स्रोत स्वीकृत आवश्यकता की पहचान करता है।
  • स्वीकृति जाँच सफलता को देखने योग्य बनाती हैं।
  • रुकने की शर्तें अनुमान और अनधिकृत अगला काम रोकती हैं।

शुरू करने से पहले

आवश्यक सामग्री: निकाली हुई प्रयोगशाला, उसकी docs/requirements.md फ़ाइल, और रिपॉज़िटरी संदर्भ पाठ . 30 मिनट रखें। कठिनाई शुरुआती स्तर की है। यह अभ्यास लिखित पैकेट के साथ समाप्त होगा। अभी कोड बदलने की ज़रूरत नहीं है।

दो अनुरोधों की तुलना करें

अस्पष्ट अनुरोध: “कार्य स्क्रिप्ट में सुधार करें।” एजेंट आउटपुट फिर से लिख सकता है, निर्भरताएँ जोड़ सकता है, नमूना डेटा बदल सकता है या परीक्षण छोड़ सकता है। अनुरोध इनमें से किसी विकल्प को तय नहीं करता।

सीमित अनुरोध: “task_report.py में वैकल्पिक स्थिति फ़िल्टर जोड़ें, docs/requirements.md के संशोधन 1 के आधार पर। डिफ़ॉल्ट आउटपुट बनाए रखें। परीक्षण जोड़ें। नमूना डेटा न बदलें। कमिट से पहले रुकें।” कार्यान्वयन के विवरण एजेंट चुनता है, जबकि कार्य सफलता का अर्थ तय करता है।

पैकेट का भागप्रयोगशाला का उदाहरणजाँच
परिणामरिपोर्ट में --status जोड़ेंदोनों स्वीकृत मान काम करते हैं
स्रोतdocs/requirements.md, संशोधन 1कोड स्वीकृत मानों से मेल खाता है
दायराकेवल प्रोग्राम और परीक्षणdiff में कोई अन्य फ़ाइल नहीं है
सीमाएँडिफ़ॉल्ट आउटपुट और नमूना डेटा बनाए रखेंआधार आउटपुट Total tasks: 4 ही रहता है
साक्ष्यपरीक्षण कमांड और मैन्युअल रनआउटपुट अपेक्षित गणना से मेल खाते हैं
रुकेंकमिट या पुश न करेंGit इतिहास और रिमोट में बदलाव नहीं होता

दोबारा उपयोग योग्य प्रारूप अपनाएँ

छोटे कोडिंग या शोध कार्य के लिए यह प्रारूप कॉपी करें। अप्रासंगिक फ़ील्ड को अस्पष्ट पाठ से भरने की बजाय हटा दें।

Outcome:
Authoritative source and revision:
Relevant files or records:
Allowed changes:
Excluded changes and actions:
Examples of desired behavior:
Completion checks:
Stop or ask when:
Report back with:

प्रयोगशाला के लिए पूरा पैकेट इस तरह दिखता है:

Outcome: Add an optional --status filter to task_report.py.
Source: docs/requirements.md, revision 1.
Relevant files: task_report.py, tasks.json, tests/.
Allowed changes: task_report.py and focused tests.
Excluded: tasks.json, new dependencies, commits, pushes.
Examples: no filter prints Total tasks: 4. Open and done each print 2.
Checks: run unit tests and four manual commands: no filter, open, done, and invalid.
The invalid value must exit nonzero with a clear error.
Stop or ask: source conflict, missing file, unrelated failing baseline.
Report: changed files, commands, observed outputs, unresolved issues.

Windows पर, यदि आपका परिवेश Python launcher इस्तेमाल करता है, तो पैकेट के कमांड में py -3 लिखें।

पैकेट कोड की हर पंक्ति तय नहीं करता। एजेंट को छोटा कार्यान्वयन चुनने की जगह मिलती है और परिणाम जाँचने योग्य रहता है।

उदाहरण सोच-समझकर जोड़ें

सटीक उदाहरण अस्पष्टता घटाता है। open और done उदाहरण चार कार्यों वाली दी गई फ़ाइल के आउटपुट बताते हैं। वे हर फ़ाइल के लिए सामान्य नियम नहीं हैं। दूसरी फ़ाइल में गणनाएँ उसके रिकॉर्ड पर निर्भर होंगी।

अपेक्षित और देखे गए परिणाम अलग रखें। प्रोग्राम चलाने से पहले, हर स्थिति के लिए Total tasks: 2 अपेक्षित परिणाम है। चलाने के बाद टर्मिनल आउटपुट एक अवलोकन है। मान अलग हों, तो सफलता बताने से पहले डेटा और कार्यान्वयन देखें।

रुकने की शर्त तय करें

मान लें कि आवश्यकता फ़ाइल मौजूद नहीं है। पैकेट उसे स्वीकृत स्रोत बताता है। पुराने चैट या नमूना समस्या से स्वीकृत मान निकालने की बजाय रुकें और आवश्यकता माँगें।

मान लें कि संपादन से पहले आधार परीक्षण विफल होते हैं। विफलता दर्ज करें और पूछें कि क्या पहले शुरुआती स्थिति सुधारनी है। बाद में सफल रन से यह पता नहीं चलता कि फ़िल्टर ने अंतर पैदा किया या शुरुआती स्थिति ने।

मान लें कि एजेंट कमिट करना चाहता है। पैकेट कमिट को बाहर रखता है। उसे diff और परीक्षण के बाद रुकने को कहें। बाद में कमिट करना परियोजना प्रक्रिया के अनुकूल है या नहीं, यह आप तय करेंगे।

पैकेट जाँचें

हर उत्तर के लिए एक अंक दें: क्या परिणाम ठोस है? क्या नियंत्रक स्रोत बताया गया है? क्या फ़ाइल दायरा स्पष्ट है? क्या कम से कम दो देखने योग्य जाँच लिखी हैं? क्या रुकने की शर्त है? पाँच से कम अंक हों तो सौंपने से पहले पैकेट सुधारें।

आपका काम: अंतिम कार्य पैकेट और रुकने की एक शर्त की एक-पंक्ति व्याख्या सहेजें। इसे अगले व्यावहारिक पाठ में कोडिंग एजेंट को दें या अध्ययन मार्ग पर अपेक्षित परिणामों के उत्तर स्वयं लिखें।

अपनी समझ जाँचें

  1. प्रश्न: कार्य पैकेट को जाँचने योग्य क्या बनाता है? उत्तर: स्रोत, अनुमत फ़ाइलें, देखने योग्य जाँच और रुकने की शर्त।
  2. प्रश्न: स्रोत में आवश्यक विवरण न हो तो एजेंट को क्या करना चाहिए? उत्तर: विवरण गढ़ने के बजाय रुककर कमी बतानी चाहिए।

समस्या निवारण

  • एजेंट बहुत कुछ बदलता है: पैकेट में फ़ाइलें और निषिद्ध कार्रवाइयाँ बताएँ।
  • एजेंट कई प्रश्न पूछता है: अनुपलब्ध स्रोत या ठोस उदाहरण दें।
  • एजेंट जल्दी सफलता बताता है: कमांड के वास्तविक आउटपुट माँगें और फ़ाइलें देखें।
  • पैकेट बहुत लंबा हो जाता है: स्रोत की कॉपी की गई सामग्री को उसके पथ और संशोधन से बदलें।

अगले कदम

कोडिंग एजेंट के साथ अपना पहला कार्य जारी रखें। प्रयोगशाला में छोटे बदलाव का मार्गदर्शन करने के लिए पैकेट का उपयोग करें।

पाठ्यक्रम नेविगेशन: पिछला: रिपॉज़िटरी संदर्भ , पाठ्यक्रम रूपरेखा .