Tool functions

अध्ययन नोट्स: टूल कार्यान्वयन (Tool Implementation)

**I. टूल कार्यान्वयन का उद्देश्य**

• टूल का उपयोग क्लाउड (Claude) को अतिरिक्त जानकारी प्राप्त करने में मदद करने के लिए किया जाता है।
• हम टूल कॉल को समझने पर ध्यान केंद्रित करेंगे, न कि मौजूदा सहायक फ़ंक्शंस (helper functions) को बदलने पर।

II. टूल फ़ंक्शन (Tool Function) क्या है?

• यह एक Python फ़ंक्शन होता है जो स्वचालित रूप से निष्पादित (execute) होता है।
• यह तब चलता है जब क्लाउड को उपयोगकर्ता की सहायता के लिए बाहरी जानकारी की आवश्यकता होती है (उदाहरण: get weather टूल)।

**III. टूल फ़ंक्शन के लिए सर्वोत्तम अभ्यास (Best Practices)**

• स्पष्ट नामकरण (Descriptive Naming): फ़ंक्शन और उसके आर्गुमेंट्स (arguments) का नाम स्पष्ट और वर्णनात्मक होना चाहिए।
• इनपुट सत्यापन (Input Validation): इनपुट की जाँच करें और यदि वे गलत हैं (जैसे खाली स्ट्रिंग), तो तुरंत एक त्रुटि (error) उठाएँ।
• अर्थपूर्ण त्रुटि संदेश (Meaningful Error Message): त्रुटि संदेश ऐसा होना चाहिए कि क्लाउड उसे समझ सके और त्रुटि को सुधारने के लिए टूल को दोबारा कॉल कर सके।

**IV. विशिष्ट टूल: get current date time**

• फ़ंक्शन का नाम: get current date time
• आर्गुमेंट: date format
• यह एक स्ट्रिंग होती है जो आउटपुट की वांछित फॉर्मेट को परिभाषित करती है।
• इसमें एक डिफ़ॉल्ट मान (default value) सेट किया जाता है।
• कार्यप्रणाली: यह फ़ंक्शन datetime. now() का उपयोग करके वर्तमान समय प्राप्त करता है और उसे दिए गए date format स्ट्रिंग के अनुसार फॉर्मेट करके लौटाता है।
• सुधार/सत्यापन:
• यह सुनिश्चित करने के लिए कि date format खाली न हो, एक सत्यापन (validation) जोड़ा जा सकता है।
• यदि date format खाली है, तो एक विशिष्ट त्रुटि (error) उठाई जानी चाहिए (उदाहरण: "date format cannot be empty")।

Takeaways

• टूल का मुख्य उद्देश्य क्लाउड को उपयोगकर्ता की सहायता के लिए बाहरी और अतिरिक्त जानकारी प्राप्त करने में मदद करना है।
• टूल फ़ंक्शन एक Python फ़ंक्शन होता है जो क्लाउड की आवश्यकतानुसार स्वचालित रूप से निष्पादित (execute) होता है।
• टूल डिज़ाइन करते समय, फ़ंक्शन और उसके आर्गुमेंट्स का नाम स्पष्ट और वर्णनात्मक होना चाहिए।
• इनपुट सत्यापन (Input Validation) आवश्यक है; गलत या खाली इनपुट मिलने पर तुरंत एक विशिष्ट त्रुटि (error) उठाई जानी चाहिए।
• त्रुटि संदेश ऐसे होने चाहिए कि क्लाउड उन्हें समझकर टूल को सुधारने के लिए दोबारा कॉल कर सके।