Table of Contents

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

AI परिणाम तभी स्वीकार करें जब आप कार्य के अनुरूप प्रमाण जाँच लें। सुस्पष्ट व्याख्या, कॉन्फ़िगर किया गया टूल और हरे टेस्ट संकेतक अलग-अलग सवालों के जवाब देते हैं। यह पाठ कार्यशाला लैब के लिए एक साझा समीक्षा रिकॉर्ड बनाता है।

सीखने का लक्ष्य: आप स्रोत, फ़ाइल दायरा, टेस्ट, गोपनीयता और उपयोग के लिए स्वीकृति रिकॉर्ड तैयार करेंगे।

मुख्य बातें

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

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

आवश्यकताएँ: पाठ्यक्रम लैब, docs/requirements.md, स्थानीय Git स्नैपशॉट और MCP पाठ या उसका ब्राउज़र विकल्प। 40 मिनट रखें। कठिनाई मध्यम है। पहली कोडिंग-एजेंट गतिविधि में संपादित लैब का उपयोग करें। यदि आपने संपादन छोड़ दिया था, तो नया निष्कर्षण लें और फीचर जाँच को लागू नहीं के रूप में चिह्नित करें। बिना बदलाव वाली आधार प्रति अब भी अपने दो मूल टेस्ट पास करती है।

तथ्यात्मक दावे की जाँच

दावा: “स्वीकृत स्थिति मान open और pending हैं।” docs/requirements.md, संशोधन 1 खोलें। उसमें open और done हैं। दावा गलत है। आत्मविश्वासी भाषा आवश्यकता नहीं बदलती।

उत्पाद संबंधी दावों के लिए, वर्तमान आधिकारिक दस्तावेज़ देखें और पृष्ठ का शीर्षक तथा समीक्षा तिथि दर्ज करें। मेनू, योजना, कमांड या संदर्भ सीमा से जुड़ा दावा सामान्य कार्यप्रवाह सिद्धांत से जल्दी पुराना पड़ता है। Codex दस्तावेज़ , Claude Code दस्तावेज़ और OpenCode दस्तावेज़ अपने वर्तमान इंटरफ़ेस बताते हैं।

दावास्रोतनिर्णय
open और pendingलैब आवश्यकता, संशोधन 1अस्वीकार करें, pending को done से बदलें
बिना फ़िल्टर कुल संख्या 4 हैआधार प्रोग्राम और चार JSON प्रविष्टियाँप्रोग्राम चलाकर जाँचें
MCP रीड हुआसत्र टूल ट्रांसक्रिप्टतभी स्वीकारें जब टूल कॉल दिखाई दे

बदलाव की जाँच

कोडिंग कार्य में, बदली फ़ाइलों की सूची देखने और वास्तविक diff पढ़ने के लिए Git का उपयोग करें। नई untracked फ़ाइल status में आती है, भले ही सामान्य diff में न दिखे। इसलिए दोनों देखें।

git status --short
git diff -- task_report.py tests

अपेक्षित दायरा: फ़िल्टर कार्य के बाद केवल task_report.py और लक्षित टेस्ट बदलते हैं। tasks.json, docs/requirements.md या छिपी कॉन्फ़िगरेशन फ़ाइल में बदलाव के लिए स्पष्टीकरण और अलग समीक्षा चाहिए। यदि आपने संपादन नहीं किया, तो कोई बदलाव अपेक्षित नहीं है।

व्यवहार का परीक्षण

लैब के निकाले गए फ़ोल्डर से वही आधार और फीचर जाँचें चलाएँ। एजेंट की पूर्णता रिपोर्ट में इन जाँचों के देखे गए परिणाम लिखे होने चाहिए।

python3 -m unittest discover -s tests -v
python3 task_report.py tasks.json
python3 task_report.py tasks.json --status open
python3 task_report.py tasks.json --status done
python3 task_report.py tasks.json --status invalid

संपादित प्रति में, टेस्ट नए मामलों को कवर करते हैं, कुल 4, 2 और 2 हैं, और अमान्य मान स्पष्ट त्रुटि तथा गैर-शून्य निकास कोड देता है। नई आरंभिक प्रति में केवल दो आधार टेस्ट पास होते हैं और कुल संख्या 4 होती है। उस शुरुआती स्थिति को अलग दर्ज करें।

फीचर टेस्ट विफल हो तो कारण खोजें। यदि open 4 दिखाता है, तो जाँचें कि फ़िल्टर तर्क गिनती फ़ंक्शन तक पहुँचता है और प्रोग्राम कार्य के status फ़ील्ड की तुलना करता है। केवल एजेंट के यह कहने पर कि कार्यान्वयन पूरा है, विफल टेस्ट को सफल न बताएं।

गोपनीयता और पहुँच की जाँच

दर्ज करें कि एजेंट को कौन-सी फ़ाइलें मिलीं। लैब में सिंथेटिक डेटा है और कोई रहस्य नहीं। वास्तविक प्रोजेक्ट में क्रेडेंशियल, ग्राहक रिकॉर्ड या निजी दस्तावेज़ हो सकते हैं। आउटपुट साझा करने से पहले prompts, लॉग, स्क्रीनशॉट और diff में ऐसे मान देखें।

स्थानीय टेस्ट केवल स्थानीय व्यवहार सिद्ध करता है। इससे क्लाउड खाते की अनुमतियाँ, MCP सर्वर का दायरा या तैनात सेवा का व्यवहार सिद्ध नहीं होता। हर सीमा को संबंधित वातावरण में परखें।

उपयोग और लागत दर्ज करें

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

जिस खाते ने कार्य चलाया उसकी उपयोग स्क्रीन खोलें। दिखाए गए इनपुट और आउटपुट टोकन, मॉडल, बिलिंग अवधि और कैश किए गए इनपुट की कोई श्रेणी दर्ज करें। ChatGPT या Claude सदस्यता में उपयोग सीमा या आवंटन किसी कार्य के API बिल के समान नहीं होता। API या प्रदाता के ज़रिए OpenCode चलाने पर उसी प्रदाता का उपयोग या बिलिंग और वर्तमान दर देखें। यदि उत्पाद प्रति कार्य टोकन नहीं दिखाता, तो “उपलब्ध नहीं” लिखें और चैट की लंबाई से शुल्क न निकालें।

उदाहरण गणना, किसी प्रदाता की दर नहीं: दस लाख पर $1 की दर से 30,000 इनपुट टोकन का खर्च $0.03 है। दस लाख पर $5 की दर से 5,000 आउटपुट टोकन का खर्च $0.025 है। इस उदाहरण में टूल या होस्टिंग शुल्क से पहले मॉडल का कुल खर्च $0.055 है।

इनपुट लागत = इनपुट टोकन / 1,000,000 × इनपुट दर
आउटपुट लागत = आउटपुट टोकन / 1,000,000 × आउटपुट दर
कुल = इनपुट लागत + आउटपुट लागत + अलग टूल शुल्क

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

शुल्क श्रेणियाँ अलग रखें। कैश इनपुट, नया इनपुट, आउटपुट, टूल कॉल और होस्टेड निष्पादन की दरें अलग हो सकती हैं। यह उदाहरण केवल नए इनपुट और आउटपुट दरें इस्तेमाल करता है। इससे सदस्यता बिल या टूल शुल्क के बारे में कुछ नहीं पता चलता।

स्वीकृति रिकॉर्ड रखें

फ़ील्डसंपादन के बाद भरा उदाहरण
स्रोतdocs/requirements.md, संशोधन 1, पढ़ा
बदली फ़ाइलेंgit status --short में task_report.py और tests/test_task_report.py
टेस्टआधार और नए फ़िल्टर टेस्ट पास, देखी गई संख्या दर्ज करें
मैन्युअल आउटपुटTotal tasks: 4, 2 और 2 देखे, अमान्य मान अस्वीकार हुआ
फीचर स्थिति--status open और --status done लागू
गोपनीयताकेवल सिंथेटिक फ़ाइलें
उपयोगउपलब्ध हो तो अपने प्रदाता के आँकड़े दर्ज करें
निर्णयस्रोत, diff, टेस्ट और गोपनीयता जाँच पास होने पर ही स्वीकारें

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

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

  1. प्रश्न: क्या starter की आधार जाँच पास होना माँगी गई सुविधा के मौजूद होने का प्रमाण है? उत्तर: नहीं। संपादन के बाद नया स्वीकृति व्यवहार जाँचें।

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

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

  • दावे का कोई स्रोत नहीं: उसे असत्यापित चिह्नित करें और प्रामाणिक रिकॉर्ड खोजें।
  • टेस्ट पास हैं लेकिन आउटपुट अलग है: मैन्युअल मामला जोड़ें और डेटा देखें।
  • उपयोग नहीं दिखता: वास्तविक शुल्क का अनुमान लगाने के बजाय “उपलब्ध नहीं” लिखें।
  • Diff में निजी डेटा है: आउटपुट साझा करना रोकें और अभ्यास रिकॉर्ड से डेटा हटाएँ।

अगले कदम

एजेंट प्रतिनिधिमंडल से आगे बढ़ें। लागत और गोपनीयता के लिए प्रदाता रूटिंग और स्थानीय AI गोपनीयता सीमा पढ़ें।

पाठ्यक्रम नेविगेशन: पिछला: MCP सेटअप , पाठ्यक्रम रूपरेखा .