स्किल की मदद से एजेंट मोड को बेहतर बनाना

स्किल की मदद से, एजेंट मोड की क्षमताओं को बेहतर बनाया जा सकता है. इसके लिए, खास विशेषज्ञता और कस्टम वर्कफ़्लो का इस्तेमाल किया जा सकता है. ये एजेंट स्किल के ओपन स्टैंडर्ड पर आधारित होती हैं.

AGENTS.md फ़ाइलों के उलट, स्किल ऑन-डिमांड विशेषज्ञता को दिखाती हैं. इस स्ट्रक्चर की मदद से, एजेंट मोड कई खास क्षमताओं को बनाए रख सकता है. जैसे, लाइब्रेरी के खास वर्शन के बीच माइग्रेट करना या अलग-अलग स्क्रीन साइज़ के हिसाब से कंपोज़ेबल को अडजस्ट करना. ऐसा करने से, मॉडल की मौजूदा कॉन्टेक्स्ट विंडो में कोई गड़बड़ी नहीं होती.

मॉडल, आपके अनुरोध और स्किल के ब्यौरे के आधार पर, यह अपने-आप तय करता है कि किसी स्किल का इस्तेमाल कब करना है. जब कोई काम की स्किल की पहचान हो जाती है, तो मॉडल उस टास्क को पूरा करने के लिए ज़रूरी सभी निर्देश और संसाधन डाइनैमिक तरीके से लोड करता है.

किसी स्किल को ऑन-डिमांड चालू करने के लिए, एजेंट से ऐसा टास्क करने के लिए कहें जो उस स्किल से जुड़ा हो. किसी खास स्किल को ट्रिगर करने के लिए, इनपुट बॉक्स में @ भी डाला जा सकता है.

खास फ़ायदे

  • शेयर की गई विशेषज्ञता: जटिल वर्कफ़्लो (जैसे, किसी खास टीम की पुल अनुरोध की समीक्षा करने की प्रोसेस) को एक खास फ़ोल्डर में पैकेज करें. इसका इस्तेमाल कोई भी कर सकता है.
  • दोहराए जा सकने वाले वर्कफ़्लो: स्टैंडर्ड निर्देश देकर, यह पक्का करें कि जटिल और कई चरणों वाले टास्क लगातार पूरे किए जाएं.
  • संसाधन बंडल करना: अपने निर्देशों के साथ स्क्रिप्ट, टेंप्लेट या सैंपल डेटा शामिल करें, ताकि एजेंट के पास एक ही जगह पर ज़रूरी सभी चीज़ें मौजूद हों.
  • कॉन्टेक्स्ट विंडो का बेहतर इस्तेमाल: कॉन्टेक्स्ट टोकन सेव करने के लिए, शुरुआत में सिर्फ़ स्किल का मेटाडेटा (नाम और ब्यौरा) लोड किया जाता है. SKILL.md फ़ाइल, चालू होने पर ही पूरी तरह से लोड होती है. references/, scripts/ या assets/ डायरेक्ट्री में मौजूद साथ वाली फ़ाइलें, कॉन्टेक्स्ट में सिर्फ़ तब लोड होती हैं, जब एजेंट को उनकी ज़रूरत होती है.

अपनी स्किल बनाना

एजेंट, आपके प्रोजेक्ट की रूट डायरेक्ट्री में मौजूद .skills/ या .agent/skills/ डायरेक्ट्री से स्किल ढूंढता है. कस्टम स्किल बनाने के लिए, यह तरीका अपनाएं:

  1. अपनी स्किल के लिए एक डायरेक्ट्री बनाएं (उदाहरण के लिए, my-new-skill/).
  2. नई डायरेक्ट्री में SKILL.md फ़ाइल बनाएं. ध्यान दें, इसमें केस-सेंसिटिविटी का ध्यान रखें.

स्किल के लिए इन नियमों का पालन करना ज़रूरी है:

  • हर स्किल के लिए एक डायरेक्ट्री: हर स्किल के लिए, उसकी अपनी यूनीक डायरेक्ट्री होनी चाहिए जिसमें एक SKILL.md फ़ाइल और कोई भी अन्य संसाधन शामिल होने चाहिए.
  • नेस्टिंग: सभी स्किल, प्रोजेक्ट की रूट डायरेक्ट्री में मौजूद .skills/ या .agent/skills/ डायरेक्ट्री में होनी चाहिए. हालांकि, बेहतर तरीके से व्यवस्थित करने के लिए सबडायरेक्ट्री का इस्तेमाल किया जा सकता है. उदाहरण के लिए, skills/ui-flows/<skill name>/SKILL.md या skills/testing/<skill name>/SKILL.md).
  • स्कोप: फ़िलहाल, सिर्फ़ प्रोजेक्ट के कोडबेस में मौजूद स्किल काम करती हैं.

SKILL.md फ़ाइल में, मेटाडेटा के लिए YAML ब्लॉक और निर्देशों के लिए स्टैंडर्ड मार्कडाउन का इस्तेमाल किया जाता है.

  • name: स्किल के लिए यूनीक आइडेंटिफ़ायर. यह डायरेक्ट्री के नाम से मेल खाना चाहिए.
  • description: स्किल क्या करती है और एजेंट को इसका इस्तेमाल कब करना चाहिए, इसकी साफ़ तौर पर जानकारी.
  • बॉडी: YAML ब्लॉक के नीचे मौजूद मार्कडाउन बॉडी में वे निर्देश शामिल होते हैं जो स्किल के चालू होने पर एजेंट के व्यवहार को गाइड करते हैं.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

फ़ॉर्मैट से जुड़े दिशा-निर्देश

  • नाम: ज़्यादा से ज़्यादा 64 वर्ण (सिर्फ़ अंग्रेज़ी के छोटे अक्षर, नंबर, और हाइफ़न).
  • ब्यौरा: ज़्यादा से ज़्यादा 1024 वर्ण.
  • बॉडी का कॉन्टेंट: 10 हज़ार से 20 हज़ार वर्ण (~2,500 से 5,000 टोकन) रखने की कोशिश करें. अगर आपके निर्देश इससे ज़्यादा हैं, तो विस्तृत दस्तावेज़ को किसी संसाधन फ़ाइल में ले जाने पर विचार करें. इसके बारे में, स्किल की वैकल्पिक डायरेक्ट्री में बताया गया है.

स्किल की वैकल्पिक डायरेक्ट्री

अपनी SKILL.md फ़ाइल को छोटा और मॉड्यूलर रखने के लिए, स्किल के फ़ोल्डर में मौजूद इन वैकल्पिक डायरेक्ट्री में अतिरिक्त संसाधन शामिल किए जा सकते हैं:

  • scripts/: इसमें एक्ज़ीक्यूट किया जा सकने वाला कोड (उदाहरण के लिए, Python या Bash) होता है, जिसे एजेंट चला सकता है.
  • references/: इसमें विस्तृत तकनीकी दस्तावेज़, एपीआई के रेफ़रंस या डोमेन के हिसाब से गाइड शामिल होती हैं.
  • assets/: इसमें स्टैटिक संसाधन शामिल होते हैं. जैसे, दस्तावेज़ के टेंप्लेट, यूआई डायग्राम या JSON स्कीमा.

SKILL.md के निर्देशों में इन फ़ाइलों का रेफ़रंस देते समय, स्किल की रूट डायरेक्ट्री से जुड़े पाथ का इस्तेमाल करें. उदाहरण के लिए: Run the script at scripts/cleanup.py.