एजेंट के लिए ट्रेसिंग क्यों आवश्यक है
एजेंट हर अनुरोध में कई LLM कॉल और उपकरण कॉल करते हैं—ट्रेस के बिना आप अँधेरे में काम कर रहे होते हैं।
एजेंट के लिए ट्रेसिंग क्यों आवश्यक है, CoddyKit पर AI एजेंट का एक निःशुल्क पाठ है। यह 4 में से 1वाँ पाठ है। आप नीचे पूरा पाठ निःशुल्क पढ़ सकते हैं—फिर अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर के साथ ब्राउज़र में इसका व्यावहारिक अभ्यास कर सकते हैं। यह AI एजेंट सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। AI एजेंट पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
इस पाठ के कुछ हिस्सों का अभी तक अनुवाद नहीं हुआ है और वे अंग्रेज़ी में दिखाए गए हैं।
एजेंटों में त्रुटि ढूँढना कठिन है
एक उपयोगकर्ता संदेश 10 LLM कॉल, 5 उपकरण कॉल और 30 सेकंड की विलंबता शुरू कर सकता है। जब कुछ गलत होता है, तो "एजेंट ने अजीब उत्तर दिया" से आपको कुछ पता नहीं चलता।
ट्रेसिंग से आप देख सकते हैं कि वास्तव में क्या हुआ।
ट्रेस में क्या दर्ज होता है
एक उपयोगकर्ता अनुरोध के लिए:
- हर LLM कॉल: मॉडल, प्राप्त संदेश, भेजी गई प्रतिक्रिया, टोकन और विलंबता
- हर उपकरण कॉल: नाम, तर्क, परिणाम और त्रुटि
- सभी चरणों का क्रम और समय
- उपयोगकर्ता को दिखाई देने वाला अंतिम उत्तर
लॉग पर्याप्त नहीं हैं
साधारण लॉग (print कथन) ट्रेस की संरचना खो देते हैं — आप यह नहीं बता सकते कि कौन-सी LLM कॉल किस उपयोगकर्ता अनुरोध से संबंधित है या चरण एक वृक्ष में कैसे जुड़े हैं।
संरचित ट्रेसिंग उपकरण इस समस्या को ठीक करते हैं।
स्पैन बनाम ट्रेस
OpenTelemetry से लिया गया:
- ट्रेस — पूरे एजेंट का संचालन (एक उपयोगकर्ता अनुरोध)
- स्पैन — ट्रेस के भीतर एक चरण (LLM कॉल, उपकरण कॉल या पुनर्प्राप्ति)
- स्पैन के जनक होते हैं — जिससे एक वृक्ष बनता है
A Concrete Trace Tree
Trace: user asks 'What is our return policy?'
|-- Span: retrieve_docs (12 ms)
|-- Span: llm_call_planner (820 ms)
| |-- tool_call: search_kb
|-- Span: tool_call: search_kb (340 ms)
|-- Span: llm_call_synthesise (1100 ms)
Total: 2.3 s, 8400 tokens, $0.012ट्रेसिंग लॉग से बेहतर क्यों है
- वृक्ष संरचना जनक और संतति के संबंध दिखाती है
- समय-प्रवाह धीमे चरणों को उजागर करता है
- टोकन और लागत प्रत्येक ट्रेस के लिए जोड़ी जाती है
- पुनः चलाना: परिवर्तनों का परीक्षण करने के लिए नए प्रॉम्प्ट के साथ ट्रेस फिर चलाएँ
ट्रेसिंग कब जोड़ें
पहले दिन से। विकास के दौरान ट्रेसिंग उन त्रुटियों को उजागर करती है जिन पर केवल चैट के माध्यम से त्रुटि-निवारण करते समय आपका ध्यान नहीं जाता। उत्पादन संबंधी घटना के बाद इसे जोड़ना बहुत देर हो जाना है।
गोपनीयता और ट्रेसिंग
ट्रेस में उपयोगकर्ता का डेटा होता है। इनके साथ लॉग की तरह व्यवहार करें:
- निर्यात करने से पहले PII छिपाएँ
- स्थिर अवस्था में एन्क्रिप्ट करें
- प्रतिधारण नीतियों का पालन करें
ट्रेसिंग बनाम मूल्यांकन
ट्रेसिंग = "इस एक संचालन में क्या हुआ"। मूल्यांकन = "परीक्षण-समुच्चय पर एजेंट कितना अच्छा काम करता है"। आपको दोनों की आवश्यकता है, लेकिन ट्रेसिंग पहले आती है — जिसका निरीक्षण नहीं कर सकते, उसका मूल्यांकन नहीं कर सकते।
ट्रेसिंग की लागत
ट्रेसिंग से 1-2% विलंबता का अतिरिक्त भार और भंडारण में वृद्धि होती है। अधिक बातचीत करने वाले एजेंटों के लिए, सब कुछ दर्ज करने के बजाय नमूना लें (जैसे, 10% ट्रेस पूरी तरह और 100% विफलताएँ)।
मैन्युअल बनाम स्वचालित उपकरण-संयोजन
कुछ रूपरेखाएँ (LangChain, LlamaIndex) स्वचालित रूप से उपकरण-संयोजन करती हैं — आपको बिना अतिरिक्त प्रयास के ट्रेस मिल जाते हैं। अपने कस्टम कोड के लिए, अपने LLM और उपकरण कॉल को स्पैन सहायक विधियों से लपेटें।
उपयोगकर्ता को दिखने वाली त्रुटियों में ट्रेस ID
जब एजेंट विफल हो, तो उपयोगकर्ता को एक ट्रेस ID लौटाएँ:
"कुछ गलत हो गया। संदर्भ ID: trace-9c4a... इसे सहायता टीम को दिखाएँ।"
सहायता टीम ट्रेस खोलकर ठीक-ठीक देख सकती है कि क्या हुआ।
ट्रेसिंग क्यों?
एजेंटों के लिए संरचित ट्रेसिंग साधारण print लॉगिंग से बेहतर क्यों है?
पुनरावलोकन
ट्रेसिंग अनिवार्य है। इसे पहले दिन से ही बनाएँ। अगले पाठों में बताया जाएगा कि क्या दर्ज करना है और किन उपकरणों का उपयोग करना है।
एआई शिक्षक के साथ AI एजेंट सीखें — निःशुल्क
अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।
- पाठ्यक्रम
- 60
- पाठ
- 239
अक्सर पूछे जाने वाले प्रश्न
क्या “एजेंट के लिए ट्रेसिंग क्यों आवश्यक है” पाठ निःशुल्क है?
हाँ—“एजेंट के लिए ट्रेसिंग क्यों आवश्यक है” का पूरा पाठ यहाँ वेब पर निःशुल्क पढ़ा जा सकता है। इंटरैक्टिव अभ्यास (अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर) करने और AI एजेंट पाठ्यक्रम का बाकी हिस्सा अनलॉक करने के लिए CoddyKit PRO लें। AI एजेंट पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
“एजेंट के लिए ट्रेसिंग क्यों आवश्यक है” में मैं क्या सीखूँगा?
एजेंट हर अनुरोध में कई LLM कॉल और उपकरण कॉल करते हैं—ट्रेस के बिना आप अँधेरे में काम कर रहे होते हैं। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ AI एजेंट का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।
क्या AI एजेंट शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?
पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर AI एजेंट शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 1वाँ पाठ है।
“एजेंट के लिए ट्रेसिंग क्यों आवश्यक है” पाठ पूरा करने में कितना समय लगता है?
CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।
क्या मैं इस AI एजेंट पाठ में कोड लिख और चला सकता हूँ?
हाँ। हर AI एजेंट पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।
इस पाठ्यक्रम के सभी पाठ
- एजेंट के लिए ट्रेसिंग क्यों आवश्यक है
- उपकरण कॉल और इनपुट/आउटपुट की लॉगिंग
- हर चरण की विलंबता और लागत
- एजेंट रन का दृश्यांकन (Langfuse, LangSmith)