सीमित AI एजेंट लूप: जाँच, पुनः प्रयास और रुकने के नियम

Table of Contents
व्यावहारिक AI कार्यप्रवाह पाठ्यक्रम पर लौटें
लक्ष्य लूप काम दोहराता है, जब तक तय परिणाम जाँच में सफल न हो जाए या रुकने का नियम लागू न हो। उपयोगी लूप वर्तमान स्थिति पढ़ता है, एक सीमित कार्रवाई करता है, परिणाम जाँचता है और दर्ज करता है कि क्या हुआ। “कोशिश करते रहो” जैसा खुला निर्देश पूरा होने का भरोसेमंद नियम नहीं देता।
सीखने का लक्ष्य: आप पहले से ज्ञात विफल जाँच के साथ सीमित लैब लूप चलाएँगे और रुकने का निर्णय दर्ज करेंगे।
मुख्य बातें
- लक्ष्य: देखने योग्य शब्दों में बताया गया परिणाम।
- स्थिति: मौजूदा फ़ाइलें, आउटपुट, त्रुटियाँ और स्रोत संशोधन।
- जाँच: लक्ष्य से जुड़ा परीक्षण या समीक्षा।
- पुनः प्रयास सीमा: एक विफलता के लिए अधिकतम प्रयासों की संख्या।
- रुकने का नियम: ऐसी शर्त जिसमें काम खत्म करना या किसी व्यक्ति से निर्णय लेना जरूरी हो।
शुरू करने से पहले
जरूरी सामग्री: कार्य पैकेट , सत्यापन रिकॉर्ड और प्रतिनिधिमंडल पाठ . 45 मिनट रखें। कठिनाई मध्यम है। सिंथेटिक लैब की नई प्रति इस्तेमाल करें ताकि पहली विफल जाँच पहले से ज्ञात हो।
लूप अनुबंध लिखें
स्टेटस फ़िल्टर अनुरोध के लिए, किसी भी पुनः प्रयास से पहले अनुबंध तय करें:
लक्ष्य: डिफ़ॉल्ट आउटपुट बदले बिना --status open|done का समर्थन करें।
स्रोत: docs/requirements.md, संशोधन 1।
अनुमत फ़ाइलें: task_report.py और लक्षित परीक्षण।
जाँच: यूनिट परीक्षण, गणना 4/2/2, अमान्य मान पर शून्य से अलग एग्ज़िट कोड।
पुनः प्रयास सीमा: पहले प्रयास के बाद अधिकतम दो संपादन।
तुरंत रुकें: स्रोत में टकराव, फ़ाइल में अनपेक्षित बदलाव, गोपनीय जानकारी उजागर होना,
या इस अनुरोध से असंबंधित आधारभूत परीक्षण की विफलता।
हस्तांतरण: अंतिम diff, कमांड, आउटपुट, प्रयास और अनसुलझी समस्या की रिपोर्ट दें।
यह सीमा कार्य नीति है, उत्पाद की डिफ़ॉल्ट सेटिंग नहीं। छोटी लैब समस्या का निदान करने और बार-बार की विफलता छिपने से रोकने के लिए दो पुनः प्रयास पर्याप्त हैं। उत्पादन कार्य के लिए जोखिम और समीक्षा का अलग निर्णय चाहिए।
स्थिति तालिका का उपयोग करें
| चरण | दर्ज करने की स्थिति | निर्णय |
|---|---|---|
| पढ़ें | स्रोत संशोधन और शुरुआती परिणाम | शुरुआती स्थिति अलग हो तो रुकें |
| कार्रवाई करें | बदली गई फ़ाइलें और की गई कार्रवाई | दायरे से बाहर के बदलाव अस्वीकार करें |
| जाँचें | सटीक परीक्षण और मैन्युअल परिणाम | स्वीकारें या कारण जाँचें |
| पुनः प्रयास करें | विफलता का कारण और नई परिकल्पना | सीमा के भीतर ही आगे बढ़ें |
| हस्तांतरित करें | अंतिम स्थिति और अगला जिम्मेदार व्यक्ति | पास या अवरोध के बाद रुकें |
सिर्फ़ आखिरी संदेश नहीं, हर प्रयास दर्ज करें। तीन छिपे संपादनों के बाद पास हुआ परीक्षण यह नहीं बताता कि क्या बदला। विफलता, संशोधित परिकल्पना और नए प्रमाण का संक्षिप्त लॉग रखें।
विफलता को समझें
पहले प्रयास का उदाहरण: एजेंट फ़िल्टर और परीक्षण जोड़ता है। open से 2 आता है, लेकिन --status invalid से 0 आता है और कमांड सफलतापूर्वक समाप्त होती है। आवश्यकता के अनुसार अमान्य मान पर गैर-शून्य निकास कोड चाहिए। जाँच को विफल चिह्नित करें।
निदान: तर्कों की जाँच देखें। एजेंट ने अज्ञात मान को त्रुटि के बजाय खाली परिणाम माना। गिनती से पहले स्वीकृत मान जाँचने वाला सीमित सुधार माँगें। अमान्य मामले और सभी पिछली जाँच फिर चलाएँ।
प्रयास 1: अमान्य स्थिति सफल रही, इसलिए स्वीकृति जाँच विफल हुई।
कारण मिला: स्वीकृत मानों की जाँच नहीं हुई।
प्रयास 2 का अनुरोध: असमर्थित मान अस्वीकार करें और 4/2/2 गणना बनाए रखें।
आवश्यक प्रमाण: पूरा परीक्षण रन और अमान्य कमांड का एग्ज़िट स्टेटस।
दूसरे प्रयास का अपेक्षित परिणाम: invalid के लिए साफ त्रुटि और गैर-शून्य निकास कोड, जबकि मान्य गिनतियाँ अपरिवर्तित रहें। दूसरा प्रयास भी विफल हो तो आखिरी प्रयास से पहले नया कारण पहचानें। वही अनुरोध दोहराना निदान नहीं है।
अस्पष्ट परिणाम संभालें
परिणाम के बिना रुकी प्रक्रिया सफल नहीं होती। संभावित फ़ाइल लेखन के बाद किसी टूल का समय समाप्त हो जाए तो उसे फिर चलाने से पहले फ़ाइलें और Git स्थिति देखें। जुड़ी सेवा अज्ञात नतीजा बताए तो बाहरी कार्रवाई दोहराने से पहले उसकी वर्तमान स्थिति पढ़ें। लैब के बाहर दोहरी भेज, पोस्ट या लेखन वास्तविक जोखिम है।
मानवीय समीक्षा के लिए रुकें यदि आवश्यकता किसी अन्य स्वीकृत स्रोत से टकराए, अनुमति कार्रवाई रोके, पुनः प्रयास सीमा समाप्त हो या अनुरोधित कार्रवाई प्रकाशन की सीमा पार करे। हस्तांतरण में सही स्थिति और लंबित निर्णय बताएँ।
लूप और मॉनिटर अलग रखें
संपादन लूप सीमित कार्य के भीतर चलता है और हर कार्रवाई के बाद परिणाम जाँचता है। अनुसूचित मॉनिटर बाद में जागकर किसी शर्त की जाँच करता है। मॉनिटर को अपनी आवृत्ति, बदलाव सीमा, सूचना नियम और रुकने की शर्त चाहिए। लैब संपादन लूप को आवर्ती कार्य न बनाएँ। अगला पाठ स्थायी सिस्टम सक्रिय करने से पहले उनका मूल्यांकन करता है।
नियंत्रित लूप चलाएँ
बिना बदलाव वाली लैब से शुरू करें। उसके दो शुरुआती परीक्षण पास होते हैं। नई निकाली गई प्रति में नीचे की जाँच के साथ tests/test_loop_contract.py बनाएँ। यह फ़ाइल ऐसी सुविधा बताती है जो शुरुआती प्रोजेक्ट में नहीं है। यह बनाए रखे जाने वाले शुरुआती ZIP का हिस्सा नहीं है।
"""One controlled failing check for the status-filter exercise."""
import subprocess
import sys
import unittest
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
class LoopContractTests(unittest.TestCase):
def test_open_status_count(self):
result = subprocess.run(
[sys.executable, str(ROOT / "task_report.py"),
str(ROOT / "tasks.json"), "--status", "open"],
capture_output=True, text=True, check=False,
)
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout.strip(), "Total tasks: 2")
if __name__ == "__main__":
unittest.main()
python3 -m unittest discover -s tests -v चलाएँ। मूल दो परीक्षण पास होने चाहिए और नया अनुबंध परीक्षण विफल होना चाहिए, क्योंकि शुरुआती प्रोजेक्ट में --status नहीं है। वास्तविक विफलता दर्ज करें। अगर आपने पाठ 0 के अनुसार Git शुरू किया है तो git status --short भी दर्ज करें। वरना बदली गई फ़ाइलों की तुलना बिना बदलाव वाली प्रति से करें। Windows पर, अगर आपका सेटअप launcher इस्तेमाल करता है तो py -3 चलाएँ।
तीन प्रयासों की सीमा तय करें: पहला संपादन और अधिकतम दो सुधार। एजेंट को ऊपर का लूप अनुबंध दें और एक सीमित संपादन माँगें। हर प्रयास के बाद बदली फ़ाइलें देखें, सभी परीक्षण फिर चलाएँ, और डिफ़ॉल्ट, open, done तथा अमान्य मान वाले कमांड चलाएँ। दूसरे प्रयास से पहले विफलता का कारण लिखें। परीक्षण पास होने, असंबंधित आधार विफल होने, दायरे से बाहर बदलाव होने या तीसरा प्रयास विफल होने पर रुकें।
अध्ययन मार्ग: लाल परीक्षण दर्ज करने के बाद इस नई प्रति में पाठ 5 का पूरा उत्तर लागू करें। वही जाँच फिर चलाएँ और दर्ज करें कि एजेंट संपादन नहीं चलाया गया। नियंत्रित अनुबंध परीक्षण रखें। पास कराने के लिए उसे कमजोर या हटाएँ नहीं।
| प्रयास | स्थिति और अवलोकन | निर्णय |
|---|---|---|
| संपादन से पहले | दो शुरुआती परीक्षण पास, नई open जाँच विफल | एक सीमित संपादन से आगे बढ़ें |
| हर संपादन के बाद | सटीक परीक्षण, गिनतियाँ, अमान्य मान का गैर-शून्य कोड और बदली फ़ाइलें दर्ज करें | स्वीकारें, निदान करें या रुकें |
| सीमा पूरी होने पर | बची विफलता और वर्तमान अंतर दर्ज करें | एक और प्रयास किए बिना हस्तांतरित करें |
अभ्यास और जाँच
आपका परिणाम: नियंत्रित विफल परीक्षण, पहले और बाद के देखे गए आउटपुट, प्रयास लॉग और अंतिम स्वीकृति या रुकने का निर्णय। पहला संपादन पास हो तो एक ही प्रयास दर्ज करें। लॉग भरने के लिए दूसरी विफलता न गढ़ें।
समापन जाँच: अनुबंध में स्रोत, फ़ाइल दायरा, देखने योग्य जाँच, पुनः प्रयास सीमा, कम से कम एक तुरंत रुकने की शर्त और हस्तांतरण शामिल हैं। रिकॉर्ड में वास्तविक लाल परीक्षण, बाद के परिणाम और पास या सीमा के कारण रुकना दर्ज है। दूसरा प्रयास नया कारण बताता है और पहले से अलग है।
अपनी समझ जाँचें
- प्रश्न: पहला लाल अनुबंध परीक्षण क्या साबित करता है? उत्तर: शुरुआती प्रोजेक्ट में माँगा गया स्थिति फ़िल्टर नहीं है, जैसा संपादन से पहले लिखे परीक्षण से पता चलता है।
- प्रश्न: प्रयास बाकी होने पर भी लूप को कब रुकना चाहिए? उत्तर: दायरे से बाहर बदलाव, अस्पष्ट अनुमति या टकराती आवश्यकता पर।
समस्या निवारण
- लूप वही विफलता दोहराता है: रुकें और कारण की नई परिकल्पना बनाएँ।
- जाँच कमजोर होती है: मूल स्वीकृति मानदंड वापस रखें।
- बाहरी नतीजा अनिश्चित है: अगली कोशिश से पहले वर्तमान स्थिति देखें।
- सीमा समाप्त है: विफलताओं का लॉग छिपाने के बजाय हस्तांतरित करें।
अगले कदम
वैकल्पिक विशेष एजेंट मूल्यांकन जारी रखें या सीधे AI कार्यप्रवाह पाठ्यक्रम की अंतिम परियोजना पर जाएँ। रनटाइम विकल्पों के लिए एजेंट वातावरण मार्गदर्शिका पढ़ें।
पाठ्यक्रम नेविगेशन: पिछला: एजेंट प्रतिनिधिमंडल , पाठ्यक्रम रूपरेखा .

