Python एजेंटों का निर्माण: अंतर्ज्ञान से साक्ष्य तक
एजेंट इंजीनियरिंग Python डेवलपर्स को सीमित कार्यों, दो लूप्स, साक्ष्य जांच, RECAP समीक्षा और स्वीकृति के माध्यम से AI कोडिंग एजेंटों का सुरक्षित रूप से उपयोग करने में मदद करता है।
मुख्य जानकारी
- एजेंटिक इंजीनियरिंग AI कोडिंग एजेंटों को Python कार्यों पर श्रमिकों के रूप में व्यवहार करती है, जबकि मनुष्य इरादे, बाधाओं, समीक्षा और रिहाई निर्णयों पर नियंत्रण बनाए रखते हैं।
- कार्यप्रवाह दो लूपों को जोड़ती हैः एक एजेंट निष्पादन लूप जो योजना, संपादन और चेक चलाता है, और एक मानव स्वीकृति लूप पूरी तरह से भिन्न की समीक्षा करता है और निर्णय लेता है कि क्या स्वीकार करना है या फिर से चलाना है।
- vibe coding के विपरीत, जो विश्वसनीय दिखने वाले कोड को स्वीकार करता है, एजेंटिक इंजीनियरिंग को जांच योग्य साक्ष्य की आवश्यकता होती है जैसे कि परीक्षण, प्रकार संकेत, लिंटिंग, अनुबंध और जोखिम-जागरूक समीक्षा।
- RECAP समीक्षा विधि एक साझा कोडबेस में पैच को स्वीकार करने से पहले भूमिका, किनारों, अनुबंधों, मान्यताओं और सबूत की जांच करके एजेंट-जनित परिवर्तनों का मूल्यांकन करने में मदद करती है।
मेटा विवरणः Python में एजेंटिक इंजीनियरिंग सीखें: बाउंड टास्क, दो लूप, साक्ष्य सीढ़ी, आरईसीएपी समीक्षा और सुरक्षित एआई-जनित कोड के लिए स्वीकृति चेकपॉइंट।
टैगः कोडिंग एजेंट, कोड की समीक्षा, डेवलपर कार्यप्रवाह
विशेष रुप से प्रदर्शित छवि: (अंग्रेज़ी में) ">"</string> अमूर्त, मैत्रीपूर्ण चित्रण शैली दो लिंक्ड लूप दिखाती हैः एक लूप जिसमें कोडिंग एजेंट फ़ाइलों का संपादन करता है, दूसरा मानव समीक्षक और चेकलिस्ट के साथ, कोई वास्तविक लोग नहीं हैं, कोई लोगो नहीं है, कोई पाठ नहीं है।
एक Real Python ट्यूटोरियल अब Python डेवलपर्स के लिए एजेंटिक इंजीनियरिंग की रूपरेखा तैयार करता है जो साझा कोडबेस में AI कोडिंग एजेंटों का उपयोग करते हैं और यह तय करने के लिए दोहराए जाने योग्य तरीके की आवश्यकता होती है कि क्या उत्पन्न कोड को रखा जाना चाहिए। गाइड विधि को अनुशासित दृष्टिकोण के रूप में बाउंड software कार्यों को AI कोडिंग एजेंट्स को सौंपने के लिए फ्रेम करता है जबकि मानव इरादे, बाधाओं, समीक्षा और रिलीज़ निर्णयों पर नियंत्रण बनाए रखता है। इसका व्यावहारिक मूल्य एक वर्कफ़्लो है जो तेजी से एजेंट-जनित पैच को परीक्षणों, प्रकार संकेतों, जांच और एक मानवीय स्वीकृति चरण द्वारा समर्थित परिवर्तन में बदल देता है।
दो लूप जो कार्यप्रवाह को काम करते हैं
केंद्रीय विचार यह है कि दो अलग-अलग प्रक्रियाएं जुड़ी हुई हैं। पहला एजेंट निष्पादन लूप है। इस लूप में, एजेंट रिपॉजिटरी का निरीक्षण करता है, काम की योजना बनाता है, फ़ाइलों को संपादित कर रहा है, टूल चलाता है, परिणाम देखता है और तब तक दोहराता है जब तक कि वह एक रोक स्थिति से नहीं मिलता है। दूसरा मानव स्वीकृति चक्र है। इसमें डेवलपर उम्मीदवार के अंतर की समीक्षा करते हैं, निर्णय लेते हैं कि क्या परिवर्तन कोडबेस में आता है, और या तो इसे मंजूरी देता है, स्पष्टीकरण मांगता है या फिर से चलाने के लिए एजेंट वापस भेजता है।
ट्यूटोरियल इसे vibe coding के साथ विपरीत करता है. vibe coding पूछता है कि क्या परिणाम प्रशंसनीय लगता है। एजेंटिक इंजीनियरिंग पूछती है कि परिवर्तन का समर्थन करने वाले कौन से सबूत हैं। यह अंतर साझा रिपॉजिटरी और उत्पादन-बाधित कार्य में मायने रखता है, जहां विश्वसनीय कोड अभी भी टूटे हुए अनुबंधों, लापता किनारे मामलों या वास्तुशिल्प बहाव को छिपा सकता है।
मार्गदर्शिका यह भी कहती है कि एजेंटिक इंजीनियरिंग एक पूरी तरह से नया आविष्कार नहीं है. यह उन प्रथाओं पर निर्माण करता है जो Python डेवलपर्स पहले से ही उपयोग करते हैंः परीक्षण लिखना, टाइप संकेत जोड़ना, सादगी के लिए रीफैक्टरिंग करना और उन्हें मर्ज करने से पहले परिवर्तनों की समीक्षा करना। नया हिस्सा संयोजन हैः किसी एजेंट के पैच को स्वीकारने से पहले जाँच योग्य साक्ष्य का उत्पादन करने के लिए उन अभ्यासों का उपयोग करना।
एजेंटिक इंजीनियरिंग की एक चरण-दर-चरण समीक्षा
एक विशिष्ट कार्यप्रवाह को इन चरणों में विभाजित किया जा सकता हैः
- इरादे को परिभाषित करें. Claude Code के प्लान मोड या ओपनकोड के प्लान एजेंट में एक योजना पास से शुरू करें. large language model , या LLM का इलाज करना, या किसी एजेंट को ब्रेनस्टॉर्मिंग टूल के रूप में व्यवहार करने से फीचर या प्रोजेक्ट लक्ष्य को आकार देने के लिए आवश्यक समय कम हो सकता है। प्लान आर्टिफैक्ट को सहेजना भी बाद में ऑडिटिंग और समीक्षा में मदद करता है।
- कार्य को बाउंड करें और एक स्टॉप कंडीशन चुनें। एजेंट को बताएं कि क्या किया गया के रूप में गिना जाता है. एक सामान्य उदाहरण हैः जब कार्यान्वयन परीक्षणों में परीक्षण पास करता है तो ही कार्य पूरा होता है/
- एजेंट निष्पादन लूप चलाएँ. संदर्भ के रूप में इरादे के साथ, एजेंट उपलब्ध फ़ाइलों और निर्देशिकाओं का निरीक्षण करता है, किसी भी अतिरिक्त योजना की आवश्यकता होती है, कोड लिखता है, और स्वचालित जांच जैसे कि लिंटिंग, यूनिट टेस्ट और टाइप चेकिंग चलाता है। यदि कोई चेक विफल हो जाता है, तो एजेंट नियोजन पर लौटता है और पुनरावृत्त होता है।
- एक पूर्ण भिन्नता पर विराम दें. प्रत्येक एजेंट क्रिया को अलग मैनुअल समीक्षा जांच बिंदु के रूप में न मानें। स्वचालित जाँच वह है जो एजेंट निष्पादन लूप को तेज रखती है। मानव समीक्षा स्वीकृति चरण बनी रहती है, और यह सार्थक चेकपॉइंट्स पर होती है, जैसे कि समाप्त उम्मीदवार अंतर।
- RECAP समीक्षा लागू करें। भूमिका, किनारों, अनुबंधों, मान्यताओं और प्रमाण द्वारा अंतर की जांच करें। पूछें कि नए कोड के पास कौन सी जिम्मेदारी है, क्या सीमा और त्रुटि मामलों को कवर किया गया है, चाहे इनपुट और आउटपुट मौजूदा अपेक्षाओं से मेल खाते हों, परिवर्तन किस धारणा पर निर्भर करता है, और परिणाम को साबित करने वाले परीक्षण या अन्य कलाकृतियां हैं।
- स्वीकार करें या फिर से चलाएँ. यदि diff को अनुमोदन नहीं मिलता है, तो इरादे को स्पष्ट करें और एजेंट को एक अन्य निष्पादन लूप चलाने दें। अगर यह अनुमोदित होता है, परिवर्तन निरंतर एकीकरण के माध्यम से आगे बढ़ सकता है, जिसे अक्सर CI में संक्षिप्त किया जाता है, इसका समर्थन करने वाले साक्ष्य के साथ।
साक्ष्य, RECAP और Workflow Types
ट्यूटोरियल दो समीक्षा एड्स का नाम देता है। Engineering Evidence Ladder पहले से एकत्र किए गए साक्ष्य और अभी भी आवश्यक सबूत की पहचान करता है। RECAP विधि समीक्षकों को प्रश्नों के एक मानक सेट देती हैः भूमिका, किनारों, अनुबंधों, धारणाओं और प्रमाण। साथ में, वे कोड सही दिखने वाले अस्पष्ट भावना पर भरोसा करने के बजाय स्वीकृति लूप को दोहराए जाने योग्य बनाते हैं।
स्वचालित जांच दोहराए जाने वाले साक्ष्य का उत्पादन करती है, लेकिन अंतर को स्वीकार करना मानव निर्णय रहता है। जैसे-जैसे एजेंट बड़े कार्यों पर लेते हैं और बड़े मतभेद पैदा करते हैं, समीक्षा फोकस बदल जाता है। कोड की हर पंक्ति पढ़ने के बजाय, समीक्षक परिवर्तन के पीछे सबूतों का वजन करता हैः व्यवहार, सीमाएं, परीक्षण, वास्तुकला फिट और जोखिम।
AI के साथ कोडिंग के आसपास की शब्दावली अभी भी तेजी से बदल रही है। अब तक, गाइड कई संबंधित शब्दों में अंतर करता हैः
| कार्यप्रवाह | यह क्या है | जहां यह फिट बैठता है |
|---|---|---|
| vibe coding | आप बारीकी से उत्पन्न कोड की समीक्षा के बिना एक काम परिणाम की ओर स्टीयरिंग | अन्वेषण, प्रोटोटाइप, व्यक्तिगत स्क्रिप्ट |
| एआई-समर्थित programming | आप नियंत्रण में रहते हुए एक सहायक के रूप AI का उपयोग करें | रोजमर्रा के कोडिंग, रीफैक्टरिंग, परीक्षण, प्रलेखन |
| एजेंट इंजीनियरिंग | आप एक एजेंट को बाउंड रिपॉजिटरी कार्य सौंपते हैं और स्वीकृति से पहले सबूत की आवश्यकता होती है | साझा कोडबेस, उत्पादन-बाधित कार्य |
Real Python एक इंटरैक्टिव प्रश्नोत्तरी शीर्षक के लिए भी लिंक करता है Python में Agentic Engineering: वाइब्स से साक्ष्य तक, साथ ही Engineering Evidence Ladder, RECAP समीक्षा चेकलिस्ट को कवर करने वाली एक मुफ्त PDF चीट शीट और एजेंट-जनित Python , सबूत द्वारा समर्थित कोड में बदलने के लिए उपयोग किए जाने वाले दो लूप। पूरा लेख https://realpython.com/agentic-engineering/ पर उपलब्ध है।
आम गलतियाँ
- एक पैच को स्वीकार करना क्योंकि यह विश्वसनीय प्रतीत होता है बजाय इसके कि उसके पास जांच योग्य सबूत हैं।
- किसी एजेंट को बिना रोक की शर्त के एक खुला कार्य देना, जैसे कि उत्तीर्ण परीक्षण सूट या जाँचों का परिभाषित सेट।
- प्रत्येक छोटी एजेंट क्रिया के बाद मैनुअल समीक्षा चलाना, जो कार्यप्रवाह को धीमा कर देता है और अंतिम अंतर से ध्यान कम करता है।
- लिंटिंग, यूनिट टेस्ट या टाइप चेकिंग को साक्ष्य के रूप में मानने की बजाय अंतिम निर्णय मानते हुए जो अभी भी मानव स्वीकृति की आवश्यकता है।
- योजना कृत्रिम वस्तु को छोड़ना, जो बाद में लेखा परीक्षा और समीक्षा के लिए संदर्भ को हटा देता है.
- एक अस्वीकृत diff के बाद इरादे को स्पष्ट करने में विफलता, जो एजेंट को उसी अस्पष्टता के साथ दूसरे निष्पादन लूप में भेजती है।
- व्यवहार, सीमाओं, परीक्षणों, वास्तुकला फिट और जोखिम की जांच के बिना केवल कोड पढ़ने से बड़े एजेंट-जनित अंतर की समीक्षा करना।
Comments (0)