फ्री-फॉर्म प्रोसीजर्स
फ्री-फॉर्म प्रोसीजर्स
सामान्य भाषा में लिखे गए, काम-विशिष्ट निर्देश
खास जानकारी
एक फ्री-फॉर्म प्रोसीजर सामान्य, प्राकृतिक भाषा में किसी एक काम का वर्णन करती है। एजेंट निर्देशों को समझता है और स्थिति के अनुसार शब्दों और क्रम को ढालता है। फ्री-फॉर्म प्रोसीजर टूल्स को कॉल कर सकती है (जिनमें कॉल समाप्त करने जैसे सिस्टम टूल्स भी शामिल हैं), नॉलेज बेस दस्तावेज़ देख सकती है और अन्य प्रोसीजर्स को श्रृंखलाबद्ध कर सकती है।
फ्री-फॉर्म प्रोसीजर का उपयोग कब करें
जब एजेंट स्थिति के अनुसार शब्दों और क्रम को ढाल सकता हो और आप उसे सामान्य भाषा में जल्दी बनाना चाहते हों, तब फ्री-फॉर्म प्रोसीजर का उपयोग करें। स्ट्रक्चर्ड प्रोसीजर्स, वर्कफ़्लो और सिस्टम प्रॉम्प्ट से इसकी तुलना के लिए प्रोसीजर्स का उपयोग कब करें देखें।
प्रोसीजर की संरचना
एडिटर में रिफ़ंड प्रोसीजर यहां दी गई है:

प्रोसीजर के दो मुख्य हिस्से होते हैं: ट्रिगर और कॉन्टेंट। दोनों में अन्य संसाधनों के इनलाइन रेफ़रेंस हो सकते हैं, जो ऊपर दिए गए स्क्रीनशॉट में रेंच आइकन वाले टैग के रूप में दिखाए गए हैं। हर प्रोसीजर का एक नाम भी होता है, जो डैशबोर्ड में दिखता है।
नाम
एक छोटा लेबल जो डैशबोर्ड में प्रोसीजर की पहचान करता है। नाम कभी भी LLM को नहीं भेजा जाता, इसलिए इसका एजेंट के व्यवहार पर कोई असर नहीं पड़ता।
ट्रिगर
एजेंट को यह प्रोसीजर कब इस्तेमाल करनी चाहिए, इसका विवरण। उदाहरण के लिए, जब यूज़र किसी ऑर्डर का रिफ़ंड मांगता है।
ट्रिगर को खाली केवल सब-प्रोसीजर बनाते समय छोड़ें।
कॉन्टेंट
प्रोसीजर का मुख्य भाग, जो markdown में लिखा जाता है। कॉन्टेंट बताता है कि एजेंट को क्या करना चाहिए: सवाल पूछना, ऑर्डर देखना, टूल कॉल करना या कॉल समाप्त करना। यह पालन करने के लिए क्रमांकित चरणों की सूची या स्थिति के लिए सामान्य मार्गदर्शन हो सकता है। हर चरण या दिशानिर्देश एक वाक्य (यूज़र से उनका ऑर्डर ID पूछें) या एक छोटा पैराग्राफ हो सकता है, जिसमें क्या करना है और क्यों, यह बताया गया हो।
क्रम से किए जाने वाले कामों के लिए क्रमांकित चरणों और किसी चरण के अंदर आवश्यकताओं या उप-आइटम के लिए बुलेट पॉइंट्स का उपयोग करें।
इनलाइन रेफ़रेंस
प्रोसीजर्स अलग-अलग तरह के संसाधनों का इनलाइन रेफ़रेंस दे सकती हैं:
- टूल्स (जैसे ऑर्डर देखना, कार्ड चार्ज करना, कॉल समाप्त करना, किसी व्यक्ति को ट्रांसफ़र करना)
- नॉलेज बेस दस्तावेज़
- अन्य प्रोसीजर्स
जब भी किसी चरण में एजेंट को टूल, नॉलेज बेस दस्तावेज़ या दूसरी प्रोसीजर इस्तेमाल करनी हो, इनलाइन रेफ़रेंस का उपयोग करें। रेफ़रेंस संसाधन को अपने-आप प्रोसीजर से जोड़ देते हैं, ताकि एजेंट उसका उपयोग कर सके। सामान्य टेक्स्ट में उल्लेख (जैसे यहां कैलकुलेटर टूल इस्तेमाल करें) भी काम करता है, लेकिन केवल तब जब संसाधन पहले से एजेंट से जुड़ा हो।
ट्रिगर या कॉन्टेंट में / टाइप करके और स्लैश मेन्यू से संसाधन चुनकर रेफ़रेंस डालें। एडिटर में रेफ़रेंस क्लिक किए जा सकने वाले टैग के रूप में दिखते हैं। किसी टैग पर क्लिक करके उसका मूल संसाधन खोलें और उसका कॉन्फ़िगरेशन जांचें।
API के ज़रिए फ्री-फॉर्म कॉन्टेंट लिखते समय, नीचे दिया गया सिंटैक्स इस्तेमाल करके रेफ़रेंस डालें:
इनलाइन प्रोसीजर रेफ़रेंस में उसी एजेंट की प्रोसीजर इस्तेमाल होनी चाहिए। एजेंट स्कोप और डुप्लिकेशन व्यवहार के लिए सीमाएं देखें।
ट्रिगर में रेफ़रेंस से प्रोसीजर किसी संसाधन के आउटपुट के आधार पर चल सकती है, उदाहरण के लिए _जब get_user tier ‘gold’ लौटाए _। कॉन्टेंट में रेफ़रेंस एजेंट को बताता है कि उस चरण में संसाधन को इनवोक करना है या उससे जानकारी लेनी है।

अगर रेफ़रेंस किया गया संसाधन बाद में हटा दिया जाता है या आपके अकाउंट की उस तक पहुंच खत्म हो जाती है, तो टैग टूटा हुआ दिखता है। एडिटर के ऊपर Errors बैज में ये रेफ़रेंस सूचीबद्ध होते हैं: अगर संसाधन अब मौजूद नहीं है तो invalid, या अगर वह मौजूद है लेकिन आपके अकाउंट को पहुंच नहीं है तो unavailable। कौन सा चरण प्रभावित है यह देखने के लिए बैज खोलें और रेफ़रेंस ठीक करें या हटा दें।

सब-प्रोसीजर्स
सब-प्रोसीजर का ट्रिगर खाली होता है। एजेंट इसे केवल किसी दूसरी प्रोसीजर से चला सकता है, जो इसका रेफ़रेंस देती हो।
एक एजेंट में चरणों को साझा करने और एक समय में उपलब्ध प्रोसीजर्स की संख्या घटाने के लिए सब-प्रोसीजर्स का उपयोग करें। एंट्री प्रोसीजर को ट्रिगर दें, उसके कॉन्टेंट से संबंधित सब-प्रोसीजर्स का रेफ़रेंस दें और उनके ट्रिगर खाली रखें।
एस्केलेशन सब-प्रोसीजर में बातचीत किसी व्यक्ति को सौंपने के चरण हो सकते हैं। इसका रेफ़रेंस रिफ़ंड और कैंसलेशन प्रोसीजर्स से दें और इसका ट्रिगर खाली रखें। एजेंट किसी भी प्रोसीजर के एक चरण के रूप में एस्केलेट कर सकता है, लेकिन इनके बाहर सब-प्रोसीजर उपलब्ध नहीं रहती।
दस्तावेज़ से इंपोर्ट करना
आप किसी मौजूदा स्टैंडर्ड ऑपरेटिंग प्रोसीजर (SOP) से शुरुआत कर सकते हैं। प्रोसीजर सूची के + मेन्यू में From SOP चुनें, फिर फ़ाइल अपलोड करें।
समर्थित फ़ॉर्मैट: PDF, DOCX, TXT, MD, HTML, EPUB। फ़ाइलें 20 MB या उससे छोटी होनी चाहिए।
इंपोर्टर दस्तावेज़ का विश्लेषण करता है, अधिकतम 10 अलग-अलग प्रोसीजर्स की पहचान करता है और हर एक के लिए जनरेट किया गया नाम, ट्रिगर और कॉन्टेंट वाला ड्राफ़्ट बनाता है। उसे बेहतर बनाने के लिए हर ड्राफ़्ट खोलें। अगर आपके दस्तावेज़ में 10 से ज़्यादा SOP हैं, तो अपलोड करने से पहले उसे छोटी फ़ाइलों में बांट लें।

फ्री-फॉर्म प्रोसीजर मैनेज करें
डैशबोर्ड से बनाएं
API से मैनेज करें
डैशबोर्ड में अपना एजेंट खोलें, फिर Procedures चुनें। फ्री-फॉर्म प्रोसीजर बनाने के लिए + का उपयोग करें। ट्रिगर जोड़ें और कॉन्टेंट एडिटर में निर्देश लिखें, फिर एजेंट के बदलाव प्रकाशित करें।
बेहतरीन तरीके
एजेंट को ट्रिगर से सही प्रोसीजर चुननी होती है और उसके कॉन्टेंट का पालन करना होता है। प्रोसीजर्स की संख्या बढ़ने पर अधिक सक्षम मॉडल यह ज़्यादा भरोसेमंद तरीके से करते हैं। विकल्पों के लिए मॉडल्स देखें।
प्रोसीजर्स को अच्छी तरह लिखने का मतलब है दो हिस्सों को अच्छी तरह लिखना: ऐसा ट्रिगर जो सही समय पर प्रोसीजर चलाए और ऐसा कॉन्टेंट जिसका एजेंट पालन कर सके।
ट्रिगर लिखना
ट्रिगर को ठोस और अलग-अलग रखें
एक-दूसरे से मिलते-जुलते या अस्पष्ट ट्रिगर गलत प्रोसीजर चला सकते हैं। जब यूज़र सब्सक्रिप्शन कैंसल करने को कहे को जब यूज़र को अपने अकाउंट के बारे में सवाल हो पर प्राथमिकता दें।
यूज़र के नज़रिए से लिखें
एजेंट को क्या करना चाहिए, इसके बजाय बताएं कि यूज़र क्या मांग रहा है। एजेंट के कामों के रूप में लिखे ट्रिगर कम भरोसेमंद होते हैं।
यूज़र वास्तव में कैसे पूछते हैं, उसे शामिल करें
अगर यूज़र अलग शब्दों में बात कहता है, तो संकीर्ण ट्रिगर असली रिक्वेस्ट को मिस कर सकता है। यूज़र जो अलग-अलग तरह से कह सकता है, उन्हें शामिल करें। जब यूज़र किसी ऑर्डर का रिफ़ंड, रिटर्न या पैसे वापस मांगता है जब यूज़र रिफ़ंड की रिक्वेस्ट करता है की तुलना में ज़्यादा भरोसेमंद तरीके से चलता है।
कॉन्टेंट लिखना
आज्ञार्थक रूप का उपयोग करें
चरणों को एजेंट के लिए निर्देशों के रूप में लिखें: कस्टमर का आखिरी ऑर्डर देखें, न कि _आपको कस्टमर का आखिरी ऑर्डर देखना चाहिए _। सीधे निर्देशों का पालन सुझावों की तुलना में आसान होता है।
बताएं कि कोई चरण क्यों ज़रूरी है
तर्क उन एज केस पर भी लागू हो जाता है जिन्हें प्रोसीजर में गिनाया नहीं गया है। छोटा सा क्योंकि रिफ़ंड जारी करने के लिए हमें ऑर्डर ID चाहिए एजेंट को उन स्थितियों को संभालने में मदद करता है जिनका चरणों में अनुमान नहीं था। जहां एक पंक्ति का स्पष्टीकरण वही काम कर दे, वहां बड़े अक्षरों वाले MUST और कठोर स्क्रिप्ट से बचें।
हर प्रोसीजर को एक काम पर केंद्रित रखें
अगर कोई प्रोसीजर असंबंधित परिणामों में बंटने लगे, तो उसे छोटी प्रोसीजर्स में बांटें और एजेंट को उनके बीच रूट करने दें।
प्रोसीजर्स को संयोजित करना
साझा चरणों को अलग प्रोसीजर में निकालें
अगर एक जैसे चरण कई प्रोसीजर्स में आते हैं (कस्टमर की पहचान वेरिफ़ाई करना, ऑर्डर देखना, किसी व्यक्ति को एस्केलेट करना), तो उन्हें एक समर्पित प्रोसीजर में निकालें और स्लैश मेन्यू के ज़रिए हर ज़रूरत वाली प्रोसीजर से उसका रेफ़रेंस दें। साझा चरणों को एक जगह मैनेज करने से उनका उपयोग करने वाली हर प्रोसीजर एक जैसी बनी रहती है।
रिएक्टिव कामों के लिए सब-प्रोसीजर्स इस्तेमाल करें
ऐसे काम के लिए सब-प्रोसीजर इस्तेमाल करें जिसे एजेंट केवल दूसरी प्रोसीजर के अनुरोध पर चलाए, जैसे पहचान सत्यापन या एस्केलेशन। ट्रिगर न होने पर यह बातचीत शुरू होने पर एंट्री प्रोसीजर्स के साथ प्रतिस्पर्धा नहीं करती। कम ट्रिगर विकल्प रूटिंग को केंद्रित रखते हैं।
ग्लोबल व्यवहार के लिए सिस्टम प्रॉम्प्ट इस्तेमाल करें
टोन, पहचान, इनकार की नीतियां और गार्डरेल्स सिस्टम प्रॉम्प्ट में होने चाहिए। काम-विशेष चरणों को प्रोसीजर्स में रखें।
प्रोसीजर्स एजेंट के साथ वर्ज़न होती हैं
प्रोसीजर्स एजेंट के कॉन्फ़िगरेशन का हिस्सा हैं, इसलिए नया एजेंट वर्ज़न प्रकाशित करने पर वे साथ में स्नैपशॉट होती हैं। प्रोसीजर्स के पुराने सेट पर वापस जाने के लिए, एजेंट का पुराना वर्ज़न रीस्टोर करें। एजेंट वर्ज़निंग देखें।
मौजूदा दस्तावेज़ों से शुरुआत करें
अगर आपकी टीम के पास पहले से SOP हैं, तो उन्हें ड्राफ़्ट में बदलने के लिए इंपोर्टर इस्तेमाल करें और वहीं से उन्हें बेहतर बनाएं।