AI एजेंट का हार्नेस: यह क्या है और इसके हिस्से कौन-से हैं

परिभाषा

AI एजेंट का हार्नेस (agent harness) भाषा मॉडल के चारों ओर का सॉफ़्टवेयर ढाँचा है: वह सब कुछ जो मॉडल नहीं है, फिर भी एजेंट के काम करने के तरीक़े को प्रभावित करता है। सूत्र है: एजेंट = मॉडल + हार्नेस। मॉडल तर्क करना और कोड लिखना जानता है, लेकिन हार्नेस तय करता है कि वह क्या देखता है, किससे काम करता है, कमांड कहाँ चलती हैं, सत्रों के बीच क्या बचता है और उसे अपनी गलतियों का पता कैसे चलता है।

हार्नेस के पाँच हिस्से

• निर्देश — सिस्टम prompt और प्रोजेक्ट की फ़ाइलें जैसे CLAUDE.md और AGENTS.md, विषयगत दस्तावेज़ और skills।
• उपकरण — shell में कमांड चलाना, फ़ाइल संपादन, ब्राउज़र, MCP से जुड़ाव।
• वातावरण — sandbox या container, जहाँ एजेंट production को जोखिम में डाले बिना कोड चलाता है।
• स्थिति — योजना और प्रगति की फ़ाइलें, git इतिहास: वह याददाश्त जो सत्र बंद होने के बाद भी रहती है।
• फ़ीडबैक — टेस्ट, linter, type checking, hooks जो एजेंट को गलती का संकेत लौटाते हैं।

हार्नेस केवल prompt वाली एक फ़ाइल नहीं है। लंबी AGENTS.md तब भी मदद नहीं करेगी, अगर एजेंट के पास टेस्ट तक पहुँच नहीं है या वातावरण चलता ही नहीं। भरोसेमंदी पाँच में से सबसे कमज़ोर हिस्सा तय करता है।

उदाहरण

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

## बग: अनुरोध दोहराने पर दोहरा भुगतान कटना
जाँचा और ख़ारिज किया:
- HTTP client का timeout — असर नहीं डालता
- webhook handler में race — दोबारा नहीं बन सका
अगला कदम: payments/service.py में idempotency key जाँचना

नया सत्र फ़ाइल पढ़ता है और ठीक उसी जगह से आगे बढ़ता है। मॉडल नहीं बदला, हार्नेस बदला।

सार

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