पाई एजेंट के लिए कस्टम TypeScript एक्सटेंशन और लाइफसाइकिल हुक बनाएँ.
TypeScript हुक फ़ाइल पथों को सत्यापित करके, राज्य बनाए रखने और बिना ब्लोइंग प्रॉम्प्ट के token लागत को नियंत्रित करने से मोनोरेपो में Pi Agent की सुरक्षा करते हैं।
मुख्य जानकारी
- Custom TypeScript एक्सटेंशन और लाइफसाइकल हुक टीमों को प्रोम्प्ट tokens बढ़ाए बिना Pi Agent में निर्धारात्मक सुरक्षा और पथ नियंत्रण जोड़ने की अनुमति देते हैं।
- वे टूल तर्क और आउटपुट को मान्य करने के लिए जीवनचक्र बिंदुओं जैसे कि beforeToolCall और afterToolExecution पर DAG निष्पादन लूप का अवरोधन करके काम करते हैं।
- अतुल्यकालिक रुकावटों से बचने और समवर्ती टूल निष्पादन में दौड़ की स्थितियों से बचना के लिए मजबूत एक्सटेंशन को प्रकार-सुरक्षित, स्टेटफुल और सीरियलाइजेशन-जागरूक होना चाहिए।
- लाइटवेट, बैचेड टेलीमेट्री और रद्दीकरण पर सख्त सफाई Pi Agent की कम-विलंबता, कम token उत्पादन व्यवहार को संरक्षित करती है।
- उत्पादन उपयोग के लिए निष्पादन से पहले दुर्भावनापूर्ण या विकृत एजेंट आउटपुट को पकड़ने के लिए एकीकरण परीक्षण और मॉक हुक टेस्ट की आवश्यकता होती है।
मेटा विवरणः Custom TypeScript एक्सटेंशन और लाइफसाइकल हुक टीमों को विरासत में मिले मोनोरेपोस, नियंत्रण फ़ाइल पथों में Pi Agent सुरक्षित करने और उत्पादन में token लागत स्थिर रखने में मदद करते हैं।
टैगः Pi Agent, TypeScript , AI इंजीनियरिंग, डेवलपर टूलिंग, जीवन चक्र हुक
विशेष रुप से प्रदर्शित छवि: (अंग्रेज़ी में) ">"</string> हुक, फ़ाइल गार्ड और टेलीमेट्री बफर के साथ एक सुरक्षित कोड पाइपलाइन की अमूर्त मैत्रीपूर्ण चित्रण शैली; कोई वास्तविक लोग नहीं हैं, कोई लोगो नहीं है, कोई पाठ नहीं है।
Custom TypeScript एक्सटेंशन और लाइफसाइकल हुक Pi Agent के लिए इंजीनियरिंग टीमों को सिस्टम प्रॉम्प्ट को फुलाए बिना एजेंट रनटाइम में निर्णायक सुरक्षा जांच जोड़ने का एक व्यावहारिक तरीका देते हैं। यह दृष्टिकोण विरासत वाले मोनोरेपोस के अंदर न्यूनतम कोडिंग लूप चलाने वाली टीमों के लिए सबसे उपयोगी है, जहां मानक हार्नेस अभी भी चार कोर टूल्स और फ्लैट डायरेक्टरी लेआउट के अपरिवर्तनीय सेट को मानता है। मूल रूप से मीडियम पर Towards AI में प्रकाशित एक गाइड में, डेवलपर्स वर्णन करते हैं कि टूल कॉल कैसे इंटरसेप्ट करें, एसिंक्रोनस रुकावटों में राज्य की रक्षा करें, और उत्पादन में token लागत स्थिर रखें।
क्यों ऑफ-द-शेल्फ पी एजेंट हार्नेस मोनोरेपोस में संघर्ष करते हैं
डेवलपर टीमें जो न्यूनतम कोडिंग लूप अपनाती हैं, अक्सर पाते हैं कि जब यह विरासत मोनोरेपोस का सामना करती है तो एक तैयार हार्नेस टूट जाता है। अंतर्निहित रनटाइम चार कोर टूल और सरल फ़ोल्डर लेआउट के एक निश्चित सेट की उम्मीद करता है, इसलिए इंजीनियरों को कस्टम सुरक्षा सीमाओं या पूर्व-प्रतिबद्धता सत्यापन के बिना छोड़ दिया जा सकता है। यही वह जगह है जहां कस्टम TypeScript एक्सटेंशन मूल्यवान हो जाते हैंः वे टीमों को एजेंट रनिंग टाइम के अंदर निर्धारक जांच करने देते हैं, जबकि प्रॉम्प्ट बजट को अछूत छोड़ते हैं।
प्रमुख तंत्र निर्देशित एसाइक्लिक ग्राफ निष्पादन लूप में हुक करना है, जो एजेंट कार्यों की रनटाइम श्रृंखला को मॉडल करता है। वहां से, एक्सटेंशन टूल तर्कों का निरीक्षण कर सकते हैं, राज्य दृढ़ता का प्रबंधन कर सकता है और आउटपुट को मान्य कर सकता हैं। उत्पादन उपयोग भी एक चेतावनी दिखाता हैः मानक घटना उत्सर्जकों पर भरोसा करने से मल्टी-फाइल रीफ़ैक्टरिंग कार्यों के दौरान दौड़ की स्थिति पैदा हो सकती है। इसलिए एक मजबूत विस्तार को स्टेटफुल, टाइप-सेफ होने की आवश्यकता होती है, और सख्त निष्पादन गारंटी बनाए रखते हुए अतुल्यकालिक रुकावटों से बचने में सक्षम होना चाहिए।
सुरक्षित रनटाइम नियंत्रण के लिए एक चरण-दर-चरण विस्तार पैटर्न
- रनटाइम निर्भरता और प्रकार नियमों को पिन करें. ∀@earendil-works/pi-agent-core` से सटीक टाइपिंग के साथ शुरू करें, जिसमें ≠AgentRuntime∂, ∆HookContext∂ और ∫ToolExecutionEvent∂ शामिल हैं, इसके अलावा ∞node:fs∂ तथा ∞Node:path∂। सटीक टाइपिंग यह सुनिश्चित करती है कि कस्टम हुक हस्ताक्षर रनटाइम. के आंतरिक डिस्पैचर के साथ संरेखित हों। चूंकि एक्सटेंशन एजेंट के मुख्य ईवेंट लूप के अंदर चलते हैं, इसलिए ढीली टाइपिंग या एक अप्रबंधित वादा अस्वीकार पूरे सत्र स्थिति पेड़ को क्रैश कर सकता है। हुक पेलोड पर किसी भी ∂̅ से बचें, क्योंकि घटना संदर्भ ऑब्जेक्ट स्टेटफुल रेफरेंस ले जाते हैं जो टूल निष्पादन चरणों में उत्परिवर्तन करते हैं।
- पहले टूल कॉल से पूर्व लोड विन्यास. एक एंटरप्राइज़ रिपॉजिटरी में, ∀allowedPaths` और ≠blocklistPatterns` के साथ एक सुरक्षा कॉन्फ़िगरेशन को परिभाषित करें, फिर रनटाइम अपने पहले टूल कॉल को आरंभ करने से पहले पथ सीमाओं को मान्य करने के लिए स्पष्ट लोडर का उपयोग करें। इस चरण को छोड़ना अनियंत्रित बैकग्राउंड रीफैक्टरिंग रनों के दौरान मनमाने फ़ाइल संशोधनों को आमंत्रित कर सकता है.
- इंटरसेप्शन बिंदुओं पर लाइफसाइकल मिडलवेयर को रजिस्टर करें। रनटाइम ∀beforeToolCall`, ∀afterToolExecution` और ≠agentStart` को उजागर करता है, प्रत्येक का उद्देश्य समवर्ती या विषमकालिक रूप से रन टाइम मापदंडों का निरीक्षण या उत्परिवर्तित करना है। एक फ़ाइल-संशोधन गार्ड के लिए, डिस्क तक पहुंचने से पहले ゙write⌒ और ̅edit⌒ इंटरसेप्ट करें। आने वाले तर्कों की जांच करें और अनधिकृत पथ पारगमन प्रयासों को हटा दें। ∂path.resolve` पर ∂context.args.path□ का उपयोग करें, अनुमति प्राप्त मार्गों के साथ परिणाम की तुलना करें, और जब लक्ष्य अनुमत न हो तो सुरक्षा उल्लंघन उठाएं।
- सत्र निर्देशित एसाइक्लिक ग्राफ के माध्यम से स्टोर स्थिति। एकाधिक उपकरण पुनरावृत्तियों के लिए, सत्र निर्देशित एसाइक्लिक ग्राफ और टेलीमेट्री संदर्भ ऑब्जेक्ट से जुड़े संदर्भ स्टोर का उपयोग करें। मॉड्यूल-स्कोप वाले वैश्विक चर समवर्ती कार्यकर्ता धागे में विफल हो जाते हैं, इसलिए एक्सटेंशन को ग्लोबल पर भरोसा करने के बजाय प्रदान की गई टेलीमेट्रिक संदर्भ वस्तु के माध्यम से राज्य पढ़ना और लिखना चाहिए।
- अतुल्यकालिक हुक कार्य को क्रमबद्ध करें. अतुल्यकालिक स्टीयरिंग संदेश और समवर्ती टूल डिस्पैच निष्क्रिय कार्यान्वयन को तोड़ सकते हैं। यदि कई समानांतर रीड ऑपरेशन एक विघटनकारी लेखन हुक के बगल में चलते हैं, तो वादा संकल्प आदेश राज्य desynchronize कर सकता है। एक्सटेंशन स्टेट स्टोर के भीतर स्पष्ट सीरियलाइजेशन ब्लॉकों या परमाणु लॉक तंत्र का उपयोग करें। एक सरल पैटर्न ∀activeOperations∂ मानचित्र का उपयोग करता है जिसे `sessionId∂ और ≠toolName∂ द्वारा कुंजीकृत किया जाता है; अगर कोई कार्य पहले से चल रहा है, तो इसके लिए प्रतीक्षा करें, फिर ̅performTelemetryFushl∂ चलाएं और अंततः ब्लॉक में प्रविष्टि हटा दें ।
- रद्द करने के बाद सफाई करना। जब उपयोगकर्ता रद्द सिग्नल निष्पादन को बाधित करता है, तो क्लीनअप हैंडलरों को तुरंत फ़ाइल डिस्क्रिप्टर्स जारी करने और लंबित टाइमर साफ़ करना चाहिए। अन्यथा, समवर्तीता की बाधाओं से सत्र लेजर के अंदर मूक डेटा भ्रष्टाचार हो सकता है, एजेंट कार्यक्षेत्र का हार्ड रीसेट मजबूर कर सकता है और संचित संदर्भ स्थिति के घंटे खो सकते हैं।
- लॉग और टेलीमेट्री को हल्का रखें। मिनिमलिस्ट रनटाइम सिस्टम प्रॉम्प्ट token को एक हजार tokens से नीचे रखने और उप-मिलिसेकंड लूप विलंबता बनाए रखने के द्वारा अपना मुख्य लाभ प्राप्त करते हैं। भारी टेलीमेट्री लाइब्रेरी या सिंक्रोनस ब्लॉकिंग इनपुट / आउटपुट उस लाभ को मिटा सकते हैं। एक व्यावहारिक पैटर्न बफर लॉग प्रविष्टियों में ∀telemetryBuffer`, 50 का उपयोग करता है, घटनाओं को क्रमबद्ध करता है .stringify , और flushes to डिस्क के साथ । कैश कॉन्फ़िगरेशन लुकअप, अनावश्यक निर्भरता पेड़ स्ट्रिप करें, और श्रमिक थ्रेड पर भारी सीरियलाइजेशन बैकग्राउंड लॉग ले जाएं। फ्लैट मेमोरी रखते हुए लंबे समय तक चलने वाले पृष्ठभूमि सत्रों को गार्बेज संग्रह ठहराव से बचने में मदद मिलती है जो सक्रिय कोड पीढ़ी को बाधित करती है।
सत्यापन, सुरक्षा और उत्पादन टीमों के लिए क्या परिवर्तन हैं
कस्टम एक्सटेंशन को केवल आकार पर भरोसा नहीं किया जाना चाहिए। उत्पादन पाइपलाइनों को कठोर एकीकरण परीक्षण की आवश्यकता होती है ताकि यह साबित हो सके कि निष्पादन से पहले दुर्भावनापूर्ण या खराब एजेंट आउटपुट पकड़े जाते हैं। व्यक्तिगत हुक के लिए यूनिट टेस्ट में `HookContext` का मजाक उड़ाना और अमान्य JavaScript Object Notation पेलोड और लापता तर्क संरचनाओं जैसे किनारे के मामलों का अनुकरण करना आवश्यक होता है।
एक प्रतिनिधि परीक्षण ∀MockAgentRuntime` बना सकता है, कॉल कर सकते हैं ≠registerSecurityExtension□ के साथ △allowedPaths: ['/ APP /src']□ और एक खाली ब्लॉकलिस्टPatterns□ सरणी, फिर ट्रिगर करें ToolCall□ के पहले ∞ लिखें□ प्रयास करने के लिए ∆/etc/passwd□, सामग्री ∂hack□, और सत्रId: 'test-1'□. अपेक्षित परिणाम सुरक्षा उल्लंघन युक्त अस्वीकृति है। इन जांचों को लागू करना यह सुनिश्चित करने में मदद करता है कि रनटाइम का विस्तार स्वचालित निरंतर एकीकरण और सतत वितरण वातावरण या डेवलपर वर्कस्टेशन में नए हमले की सतहों को पेश नहीं करेगा।
पाठकों के लिए, मूल्य JUST एक मजबूत गार्डरेल नहीं है। यह सख्त प्रदर्शन और सुरक्षा सीमाओं के साथ गहरा रनटाइम एक्सेस को संतुलित करने का एक तरीका है, फिर लूप की गति से समझौता किए बिना एंटरप्राइज़ मानकों के अनुसार एजेंट निष्पादन वातावरण को दर्जी करता है। कार्रवाई योग्य टेकवे सीधे हैंः पिन कोर रन टाइम आयात, डिस्क लिखने से पहले सभी फ़ाइल संशोधन पथों को मान्य करें, दौड़ की स्थितियों को रोकने के लिए अतुल्यकालिक हुक संचालन को क्रमबद्ध करें, और प्रॉम्प्ट बजट की रक्षा के लिए एक फ्लैट मेमोरी प्रोफाइल बनाए रखें। स्रोत सामग्री, जिसका शीर्षक Building Custom TypeScript Extensions और Lifecycle Hooks Pi Agent के लिए था, मूल रूप से मध्यम पर Towards AI में प्रकाशित किया गया था, जहां पाठक कहानी को हाइलाइट करके और प्रतिक्रिया देकर चर्चा जारी रखते हैं।
बचने के लिए आम गलतियाँ
- बहु-फाइल रिफैक्टरिंग के लिए मानक घटना उत्सर्जकों को पर्याप्त मानते हुए; सीरियलाइजेशन के बिना, दौड़ की स्थिति सत्र राज्य को भ्रष्ट कर सकती है।
- राज्य के लिए मॉड्यूल-स्कोप वाले ग्लोबल का उपयोग करना; वे समवर्ती कार्यकर्ता धागे के तहत विफल हो जाते हैं और हार्ड रीसेट को ट्रिगर कर सकते हैं जो संदर्भ के घंटों खो देते हैं।
- पहले टूल कॉल से पहले पथ सत्यापन को छोड़ना; यह अनियंत्रित पृष्ठभूमि रीफैक्टरिंग चलाता है जो मनमाने फ़ाइल संशोधनों के लिए खुला रहता है.
- हुक पेलोड को ∀any` के रूप में घोषित करना; ढीली टाइपिंग और अप्रबंधित वादा अस्वीकरण सत्र राज्य पेड़ को क्रैश कर सकते हैं।
- भारी टेलीमेट्री पुस्तकालयों या सिंक्रोनस अवरुद्ध इनपुट/आउटपुट को जोड़ना; वे उप-मिलिसेकंड लूप विलंबता और एक हजार token संकेत बजट के तहत तोड़ सकते हैं।
- हूक कॉन्टेक्स्ट का मजाक उड़ाने और अमान्य JavaScript Object Notation पेलोड या गायब तर्क संरचनाओं का परीक्षण करने में विफलता; जो निरंतर एकीकरण और सतत वितरण पाइपलाइनों और डेवलपर वर्कस्टेशन में नई हमले की सतहों को छिपा सकता है।
Comments (0)