Tool schemas

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

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

• टूल कॉन्फ़िगरेशन की संरचना:
• टूल के पास एक नाम (Name) और एक विवरण (Description) होता है।
• मुख्य भाग input schema होता है, जिसके तहत वास्तविक JSON Schema स्पेसिफिकेशन दिया जाता है।

• सर्वोत्तम अभ्यास (Best Practices):
• टूल विवरण (Tool Description): इसे 3 से 4 वाक्यों का होना चाहिए। यह Claude को बताता है कि टूल क्या करता है, इसे कब उपयोग करना है, और यह किस प्रकार का डेटा लौटाएगा।
• आर्गुमेंट विवरण (Argument Description): यह भी 3 से 4 वाक्यों का होना चाहिए। यह बताता है कि आर्गुमेंट किस चीज़ को नियंत्रित करता है और यह फ़ंक्शन कॉल को कैसे प्रभावित करता है।

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

• JSON Schema बनाने की स्वचालित विधि (The Trick):
• एक टूल फ़ंक्शन को Claude को प्रॉम्प्ट के रूप में दिया जा सकता है।
• Claude को एक वैध JSON Schema बनाने के लिए कहा जाता है, जिसमें Anthropic API दस्तावेज़ीकरण (documentation) को संदर्भ के रूप में संलग्न किया जाता है।
• यह विधि मैन्युअल कॉन्फ़िगरेशन की आवश्यकता को कम करती है।

• कोड में नामकरण (Naming Convention):
• टूल फ़ंक्शन का नाम दें, और उसके अनुरूप स्कीमा का नाम [टूल का नाम]_schema रखें (उदाहरण: get_current_date_time_schema)।

• टाइप सुरक्षा (Type Safety):
• भविष्य में टाइप एरर से बचने के लिए, पूरे डिक्शनरी को anthropic. types से ToolParam का उपयोग करके रैप (wrap) करना उचित है।

Takeaways

• JSON Schema एक डेटा सत्यापन विनिर्देश है जो भाषा मॉडल (LLMs) को उपलब्ध टूल्स और उनके आवश्यक आर्गुमेंट्स के बारे में सूचित करता है।
• टूल कॉन्फ़िगरेशन में टूल का नाम (Name), विवरण (Description), और वास्तविक JSON Schema स्पेसिफिकेशन शामिल होता है।
• सर्वोत्तम परिणामों के लिए, टूल और उसके आर्गुमेंट दोनों के विवरण 3 से 4 वाक्यों के होने चाहिए ताकि LLM को स्पष्ट निर्देश मिल सकें।
• मैन्युअल कॉन्फ़िगरेशन की आवश्यकता को कम करने के लिए, LLM को API दस्तावेज़ीकरण का संदर्भ देकर वैध JSON Schema बनाने के लिए कहा जा सकता है।
• भविष्य में टाइप एरर से बचने के लिए, पूरे डिक्शनरी को ToolParam का उपयोग करके रैप करना टाइप सुरक्षा के लिए उचित है।