Tool schemas

JSON स्कीमा और टूल कॉलिंग (Tool Calling) के मुख्य नोट्स

• JSON स्कीमा क्या है?
• यह एक डेटा वैलिडेशन स्पेसिफिकेशन (Data Validation Specification) है।
• यह JSON डेटा को मान्य (validate) करने के लिए नियमों का एक सेट है।
• यह विशेष रूप से भाषा मॉडल (Language Models) या टूल कॉलिंग से बंधा नहीं है, लेकिन LLM समुदाय ने इसे टूल कॉल्स को संभालने के लिए एक सुविधाजनक तरीका माना है।

• Claude को टूल जानकारी कैसे दी जाती है?
• टूल कॉन्फ़िगरेशन में मुख्य रूप से तीन भाग होते हैं:
• टूल का नाम (Name)
• टूल का विवरण (Description)
• इनपुट स्कीमा (Input Schema)
• टूल विवरण (Tool Description): यह Claude को बताता है कि टूल क्या करता है, इसे कब उपयोग करना चाहिए, और यह किस प्रकार का डेटा लौटाएगा।
• सर्वोत्तम अभ्यास (Best Practice): विवरण लगभग तीन से चार वाक्यों का होना चाहिए।
• इनपुट स्कीमा (Input Schema): यह वास्तविक JSON स्कीमा है जो फ़ंक्शन में पास किए जाने वाले विभिन्न आर्गुमेंट्स (arguments) का वर्णन करती है।
• प्रत्येक आर्गुमेंट के लिए उसका प्रकार (जैसे: string) और उद्देश्य का विस्तृत विवरण (3-4 वाक्य) देना आवश्यक है।

• JSON स्कीमा का उपयोग क्यों किया जाता है?
• यह Claude को उपलब्ध विभिन्न टूल्स और उनके लिए आवश्यक आर्गुमेंट्स को समझने में मदद करता है।

• JSON स्कीमा बनाने का आसान तरीका (Automation Trick):
• आप Claude को ही प्रॉम्प्ट देकर एक वैध JSON स्कीमा बना सकते हैं।
• Claude को टूल फ़ंक्शन और Anthropic API डॉक्यूमेंटेशन (सर्वोत्तम प्रथाओं के साथ) संलग्न करें।
• Claude एक मजबूत JSON स्कीमा उत्पन्न करेगा जिसे आप उपयोग कर सकते हैं।

• कोडिंग और टाइप सेफ्टी:
• नामकरण पैटर्न (Naming Pattern): टूल फ़ंक्शन के लिए एक नाम रखें और उसके स्कीमा के लिए [टूल का नाम]_schema का उपयोग करें (उदाहरण: get_weather और get_weather_schema)।
• tool_param का उपयोग: स्कीमा को import tool_param का उपयोग करके रैप करना (wrap करना) भविष्य में होने वाली टाइप एरर (type error) को रोकता है, भले ही यह कोड के चलने के लिए अनिवार्य न हो।

Takeaways

• JSON स्कीमा एक डेटा वैलिडेशन स्पेसिफिकेशन है जो JSON डेटा को मान्य करने के लिए नियमों का सेट प्रदान करता है।
• टूल कॉन्फ़िगरेशन में तीन मुख्य भाग होते हैं: टूल का नाम, टूल का विवरण (जो बताता है कि टूल क्या करता है), और इनपुट स्कीमा।
• इनपुट स्कीमा वह वास्तविक JSON है जो फ़ंक्शन के लिए आवश्यक सभी आर्गुमेंट्स के प्रकार और उद्देश्य का वर्णन करती है।
• Claude को टूल फ़ंक्शन और API डॉक्यूमेंटेशन देकर एक वैध JSON स्कीमा ऑटोमेट (स्वचालित) तरीके से उत्पन्न की जा सकती है।
• टाइप एरर से बचने के लिए स्कीमा को tool_param का उपयोग करके रैप करना (wrap करना) एक सर्वोत्तम अभ्यास है।