सोफी हार्नेस स्थैतिक फ़ाइलों को स्व-उत्पादक कौशल में परिवर्तित करना: AI एजेंट की कौशल प्रणाली का विकास
Static Markdown कौशल केवल तब उपयोगी हो गए जब SkillTool, /skill और ADR-030 ने एक कोटलिन एजेंट हार्नेस में पुनर्प्राप्ति, पदानुक्रम और स्व-लेखन जोड़ा।
मुख्य जानकारी
- SoPhi कौशल निष्क्रिय मार्कडाउन फ़ाइलों के रूप में शुरू हुआ: वे जल्दी लोड किए गए थे, लेकिन स्किलटूल और /स्किल जैसे उपभोक्ताओं तक कोई रनटाइम मूल्य नहीं था।
- कौशल मॉड्यूल को जानबूझकर एजेंट मशीनरी से अलग कर दिया गया था, जो केवल Kotlin, YAML पार्सिंग और संस्करण पर निर्भर करता है, न कि उपकरण, कोरोटीन या एजेंट कोर पर।
- स्किलटूल और /स्किल ने कौशल निर्देशों को मॉडल संदर्भ में लोड करके या उन्हें सीधे एक सत्र में इंजेक्ट कर, वैश्विक लोगों के ऊपर परियोजना कौशल के साथ उपयोग करने योग्य बना दिया।
- बाद में जोड़े गए स्वयं-लेखन कौशल ने एजेंटों को नए कौशल कार्ड बनाने या स्थापित करने में सक्षम बनाया, लेकिन एडीआर -030 के लिए सुरक्षा द्वार की आवश्यकता थी, जिसमें रहस्यों और त्वरित इंजेक्शन के लिए स्थिर जांच शामिल थी।
- स्किल राइटिंग और स्किल वेरिफिकेशन अलग-अलग, चरणबद्ध प्रक्रियाएं हैं: नए कार्ड तब तक परीक्षण संस्करण होते हैं जब तक कि 'सॉफी स्किल वैरीफाई' पुष्टि नहीं करता है कि वे वास्तव में बाद में मदद करते हैं।
मेटा विवरण: SoPhi कौशल प्रणाली को एजेंटों द्वारा इसे पढ़ने से पहले निष्क्रिय मार्कडाउन के रूप में भेज दिया गया था। लेख 07 बताता है कि कैसे स्किलटूल, /स्किल और एडीआर -030 ने इसे उपयोगी बनाया।
टैगः सोफी कौशल, कोटलिन एजेंट हार्नेस, AI एजेंट निर्देश, ADR-030, कौशल सत्यापन
विशेष रुप से प्रदर्शित छवि: एक खाली नुस्खा बॉक्स का अमूर्त मैत्रीपूर्ण चित्रण जो AI एजेंट के लिए लेबल किए गए निर्देश कार्ड बन जाता है, कोई वास्तविक लोग नहीं हैं, कोई लोगो नहीं, कोई पाठ नहीं।
Building SoPhi-Kotlin Agent Harness श्रृंखला में यह अनुच्छेद 07 जेवीएम पर एजेंट रनटाइम बनाने वाले इंजीनियरों के लिए है। इसमें दिखाया गया है कि कैसे सोफी कौशल को निष्क्रिय मार्कडाउन निर्देश फ़ाइलों के रूप में जल्दी भेज दिया गया था, फिर स्किलटूल, एक /स्किल कमांड और स्व-लेखन कौशल महीनों बाद आने के बाद ही उपयोगी हो गए थे।
उपभोक्ताओं के आगमन तक प्रारंभिक कार्य निष्क्रिय रहा
सोफी-कौशल कंकाल निर्माण के दौरान रफ-इन काम के रूप में उतरा। मॉड्यूल को शिप किए जाने वाले दिन कोई उपयोगी रनटाइम नौकरी नहीं थी। इसने निर्देशों को संग्रहीत किया जो अभी तक कोई नहीं पढ़ रहा था, और इसका वास्तविक मूल्य बाद में दिखाई दिया जब सिस्टम के किसी अन्य हिस्से को उन्हें खींचने के लिए एक जगह की आवश्यकता थी।
SoPhi में एक कौशल एकल मार्कडाउन फ़ाइल है जिसमें YAML फ्रंटमैटर, फाइल के शीर्ष पर मेटाडेटा ब्लॉक होता है। एक उदाहरण कार्ड का शीर्षक "डिप्लॉय रनबुक" है, जिसे "इस सेवा को सुरक्षित रूप से कैसे तैनात किया जाए", और [ops, deploy] के साथ टैग किया गया है। आंतरिक रूप से, वह फ़ाइल स्किल नामक डेटा क्लास के लिए मैप करती है, जिसमें स्किलमेटाडाटा, एक शरीर और एक स्रोत हैः पथ.
स्किललोडर एक पूरी निर्देशिका को उत्सुकता से पढ़ता है। प्रत्येक फ़ाइल, हर बाइट startup पर पार्स की जाती है और शीर्षक द्वारा सॉर्ट किया जाता है। स्किलरेजिस्ट्री तब प्रोजेक्ट डायरेक्टरी के नीचे एक वैश्विक निर्देशिका लेयर करती है, जिसमें आईडी टकराव पर जीतने वाली परियोजना प्रविष्टियां होती हैं। लोडर रनकैचिंग {loader.loadFile(file) }.getOrNull} के माध्यम से एक दोषपूर्ण कार्ड के लिए सहिष्णु होता है, इसलिए एक खराब फाइल पूरे बॉक्स को बर्बाद नहीं करती है।
आलसी हिस्सा लोड नहीं है. यह क्या लोड करने के बाद होता हैः एक कौशल शरीर मानचित्र में पार्क बैठता है<स्ट्रिंग, कौशल> और तब तक कुछ नहीं करता जब तक कि कोई विशेष रूप से इसके लिए न कहे।
कौशल ने मॉड्यूल को एजेंट मशीनरी से मुक्त रखा
निर्भरता सूची ने पृथक्करण को दृश्यमान बना दिया। सोफी-कौशलों का पोम XML kotlin-stdlib, एक YAML पार्सर और sophi-versioning पर निर्भर करता है. सोफ़ी-वर्शनिंग स्वयं केवल कोटलिन-स्टडलिब प्लस स्टोरेज अमूर्त है। कौशल मॉड्यूल में कोई सोफी कोर निर्भरता नहीं है, कोई टूल इंटरफ़ेस नहीं है और उस श्रृंखला में कहीं भी कोई कोरोटीन नहीं है।
उस डिजाइन का मतलब है कि एक कौशल कार्ड एजेंट रनटाइम के बिना मौजूद हो सकता है, जितना कि लिखित नुस्खा को अस्तित्व में रहने के लिए स्टोव की आवश्यकता नहीं होती है। हालांकि, कुछ समय के लिए इसका मतलब यह भी था कि स्किल शेल्फ रसोईघर में कोई मार्ग नहीं था। SkillLoader और SkillRegistry शिप किए गए थे, काम करते थे, और परीक्षण होते थे, लेकिन हफ्तों तक कहीं भी कॉल करने वाला नहीं था.
SkillTool और / कौशल शेल्फ खोला
पहला उपभोक्ता स्किलटूल था, एक सादा उपकरण जो मॉडल को कौशल के निर्देशों को संदर्भ में लोड करने देता है। इसका नाम "कौशल" है। इसके विवरण की शुरुआत "संदर्भ में कौशल के आदेश लोड करें. उपलब्ध कौशल:" और रजिस्ट्री से आईडी और वर्णन सूचीबद्ध करता है। इसकी जोखिम स्तर RiskLevel.SAFE लौटाता है।
उपकरण एक नाम तर्क लेता है। यदि वह तर्क अनुपलब्ध है, तो यह "त्रुटिः 'नाम' तर्क गायब है" लौटाता है। अगर कौशल अज्ञात है, यह वापस आ जाता है "त्रूटी: कौशल नहीं मिला हैः $skillName". यदि अनुरोधित कार्ड में बच्चे हैं, तो परिणाम में कार्ड का शरीर प्लस "इस डोमेन में उपलब्ध:" और भाई-बहन विवरण शामिल हैं.
SkillTool सोफी-कोर के टूल को लागू करता है और एक सोफी कौशल स्किल रजिस्ट्री रखता है। वह संयोजन केवल sophi- SDK में संकलित किया जा सकता था, जो दोनों पक्षों पर किनारे वाला एकमात्र मॉड्यूल था। यह सोफ़ी-कौशल में नहीं रह सकता था क्योंकि कौशल मोड्यूल को जानबूझकर अज्ञानी रखा गया था कि एक उपकरण भी क्या है। यह हमेशा के लिए सोफ़ी-क्ली में पार्क नहीं हो सका। ADR-028, दिनांक 25 अगस्त, ने सोफि-कॉम्पेनियन को टर्मिनल के समान टूल सेट दिया, इसलिए एक एकल वर्ग जिसे सोफी क्लाइ देख सकती थी वह दूसरे होस्ट की सेवा नहीं कर सकी।
पंजीकरण सशर्त है। यदि skillRegistry.topLevel (().isNotEmpty ((), तो हार्नेस SkillTool ((skillRegistry, topK = harnessConfig?topKSkills) को रजिस्टर करता है। एक दूसरा फ्रंट डोर, /skill <पहचान>, मॉडल निर्णय को पूरी तरह से छोड़ देता है। यह कार्ड को session.append ((EntryRole.TOOL_RESULT, skill.body) के साथ इंजेक्ट करता है और आउटपुट "इंजेक्टेड स्किलः $sub".
शेल्फ का संगठन भी बढ़ गया। स्किल रजिस्ट्री अब एक डोमेन के रूट कार्ड को topLevel () द्वारा अपने सदस्यों से childrenOf ((domainId) के माध्यम से अलग करती है। साइट- GitHub -com के लिए Asking SkillTool आज उस कार्ड और इसके तहत दायर किए गए भाई-बहनों की सूची देता है, जिससे एक फ्लैट स्टैक को बाइंडर में बदल दिया जाता है।
स्व-लिखित कार्ड सुरक्षा द्वारों के साथ पहुंचे
कार्ड पढ़ना पहले मील का पत्थर था। बाद में, बॉक्स ने खुद को भरने का एक तरीका प्राप्त किया. write_skill एजेंट को एक नई साइट-विशिष्ट कार्ड रिकॉर्ड करने की अनुमति देता है जब यह काम करता है कि वेबसाइट कैसे व्यवहार करती है, जिसमें नाम जैसे site- GitHub -com या डोमेन सदस्य जैसे site-maidplus-de/companies शामिल हैं। install_skills Claude -कोड के आकार वाले SKILL.mdin को स्थानीय पथ या git URL से खींचता है और इसके फ्रंटमैटर को मेल खाने के लिए सामान्य बनाता है।
ADR-030, दिनांक 27 अगस्त, वह है जिसने उस लिखने योग्य स्थिति को चलाने के लिए पर्याप्त सुरक्षित बना दिया। स्थैतिक सामग्री की जांच एक बाइट लैंडिंग से पहले लेखन को अवरुद्ध करती है। वे रहस्यों और क्रेडेंशियल्स के लिए स्कैन करते हैं, और कोडबेस के बाहर आने वाली किसी भी चीज़ में प्रॉम्प्ट-इंजेक्शन वाक्यांशों के लिए स्क्रीन करते हैं।
दोनों उपकरण article-06 में निर्मित दरवाजे का भी उपयोग करते हैंः riskLevel RiskLevel.DESTRUCTIVE देता है। एक कार्ड जो बदल सकता है कि भविष्य की दुनिया के बारे में क्या विश्वास करता है, वह SAFE JUST नहीं हो सकता क्योंकि भंडारण प्रारूप निष्क्रिय शुरू हुआ था। install_skill एक कदम आगे जाता है। इसका नियम Verdict बिना शर्त HIGH_RISK लौटाता है, इसलिए गिट URL से आने वाली सामग्री हमेशा किसी इंसान की आंखों को प्राप्त करती है, जिसमें कोई अपवाद वर्गीकरणकर्ता प्रदान करने के लिए मिलता है।
एक कार्ड लिखना और यह न्याय करना कि क्या इसने अलग-अलग घड़ियों पर अलग क्षण हैं। कोई eval सूट write_skill के अपने निष्पादन के अंदर नहीं चलता है) । एक लिखित कार्ड परीक्षण संस्करण के रूप में लैंड करता है, न कि पदोन्नत. इसे वापस पढ़ने के लिए जांचें कि क्या यह वास्तव में मदद की गई एक अलग कमांड है, सोफी कौशल सत्यापित करें, एक अलग दिन चलाएं। यह जानबूझकर है। टूल कॉल के भीतर एक इवैल सुइट चलाना मिनटों तक रुकावट को रोक देगा जबकि किसी ने भी निर्णय का इंतजार नहीं किया।
सत्यापन-और-पदोन्नति मशीनरी अपनी बाद की कहानी हैः eval सूट क्या स्कोर करता है, यह दो बार क्यों चलता है, और कैसे कवरेज चेतावनी एक सूट को पकड़ती है जिसने वास्तव में कभी भी नए कौशल का अभ्यास नहीं किया।
किसको इसका उपयोग करना चाहिए/कौन इसे छोड़ना चाहिए
यह पैटर्न उन इंजीनियरों के लिए महत्वपूर्ण है जो एक कौशल प्रणाली चाहते हैं जो मेजबान परिवर्तन से बच सकते हैं। इसने दो बार भुगतान किया। महीनों बाद, टूल और स्लैश कमांड को सोफी-कौशल से कुछ भी नहीं चाहिए था। फिर, इसके लगभग एक साल बाद, उपभोग करने वाले पक्ष ने इमारतों को पूरी तरह से स्थानांतरित कर दिया, सोफ़ी-क्ली से सोफी- SDK तक, और इसे दूसरे होस्ट APP द्वारा अपरिवर्तित रूप से पुनः उपयोग किया गया, जो कंकाल भेजते समय मौजूद नहीं था। सोफी स्किल्स का अपना कोड कभी नोटिस नहीं हुआ, क्योंकि इससे अधिक किसी चीज पर निर्भरता नहीं थी।
अनुच्छेद-06 से riskLevel के उबाऊ SAFE डिफ़ॉल्ट के समान ही वृत्ति हैः ऊब, सामान्य-उद्देश्य वाली चीज़ का निर्माण करें, कमरे को छोड़ दें और जो भी अगला कदम उठाता है उसे यह तय करने दें कि कमरे में क्या जाता है। यहां तक कि जब वह कोई भी एक मॉड्यूल और APP मेजबान होता है जिसे अभी तक डिज़ाइन नहीं किया गया था।
sophi-extensions, पिछले मील का पत्थर के दूसरे आधे है एक अलग तरह की मोटाई में यह एजेंट लूप में पर्यवेक्षकों तार बजाय इसके लिए निर्देशों को संग्रहीत करने की, और यह भविष्य कहानी बनी हुई है।
एजेंट हार्नेस बनाने वाले इंजीनियरों को इसका अध्ययन करना चाहिए जब उन्हें मार्कडाउन-परिभाषित निर्देश, टूल लोडिंग और सुरक्षित स्व-संशोधन कौशल की आवश्यकता होती है। पाठक जो केवल एक तैयार प्रॉम्प्ट लाइब्रेरी चाहते हैं वे वास्तुकला विवरण छोड़ सकते हैं।
अगला लेख निर्माण उप-एजेंटों को कवर करता है, जिसे श्रृंखला में वर्णित किया गया है एक उपठेकेदार में कॉल करना: JUST के रूप में अन्य उपकरण। लेखक एजेंट आधारित प्रणालियों और जेवीएम पारिस्थितिकी तंत्र में बिल्ड बनाम खरीद विभाजन पर काम करने वाले लोगों से टिप्पणियां आमंत्रित करता है। मूल कहानी मध्यम पर Towards AI में प्रकाशित की गई थी, और पूर्ण स्रोत LinkedIn कनेक्शन के साथ GitHub पर उपलब्ध है।

Comments (0)