Log and progress notifications

लॉगिंग और प्रगति सूचनाएँ (Logging and Progress Notifications)

• उद्देश्य (Purpose): लंबी चलने वाली टूल कॉल (जैसे रिसर्च) के दौरान उपयोगकर्ता को फीडबैक देना और यह बताना कि प्रक्रिया बैकग्राउंड में क्या कर रही है। यह उपयोगकर्ता अनुभव (User Experience) को बेहतर बनाता है।
• सर्वर साइड कार्यान्वयन (Server Side Implementation):
• टूल फंक्शन को स्वचालित रूप से एक context तर्क (argument) प्राप्त होता है।
• यह context ऑब्जेक्ट लॉगिंग और प्रगति रिपोर्ट करने के लिए विभिन्न तरीके प्रदान करता है।
• मुख्य तरीके: info (जानकारी लॉग करने के लिए) और report_progress (प्रगति बताने के लिए)।
• क्लाइंट साइड कार्यान्वयन (Client Side Implementation):
• जब सर्वर पर ये तरीके कॉल होते हैं, तो संदेश स्वचालित रूप से क्लाइंट को भेजा जाता है।
• क्लाइंट को दो अलग-अलग कॉल बैक फ़ंक्शन (callback functions) की आवश्यकता होती है: एक लॉगिंग के लिए और दूसरा प्रगति अपडेट के लिए।
• ये कॉल बैक टूल फंक्शन को पास किए जाते हैं।
• उपयोगकर्ता अनुभव (UX):
• डेवलपर तय करता है कि लॉग और प्रगति को कैसे प्रदर्शित किया जाए (जैसे CLI के लिए टर्मिनल पर प्रिंट करना, या वेब ऐप के लिए कोई अन्य समाधान)।
• यह सुविधा वैकल्पिक है; यदि आप चाहें तो इन लॉग और प्रगति संदेशों को उपयोगकर्ता को दिखाने की आवश्यकता नहीं है।

Takeaways

• लॉगिंग और प्रगति सूचनाओं का मुख्य उद्देश्य लंबी टूल कॉल के दौरान उपयोगकर्ता को फीडबैक देना और उपयोगकर्ता अनुभव (UX) को बेहतर बनाना है।
• सर्वर साइड पर, टूल फंक्शन को स्वचालित रूप से एक context तर्क मिलता है, जिसमें info (लॉगिंग) और report_progress (प्रगति) के लिए तरीके होते हैं।
• क्लाइंट साइड पर, सर्वर से प्राप्त संदेशों को संभालने के लिए क्लाइंट को लॉगिंग और प्रगति अपडेट के लिए दो अलग-अलग कॉल बैक फ़ंक्शंस की आवश्यकता होती है।
• लॉग और प्रगति को कैसे प्रदर्शित किया जाए (जैसे CLI या वेब ऐप में), यह पूरी तरह से डेवलपर के निर्णय पर निर्भर करता है, और यह सुविधा वैकल्पिक है।