Running tool functions

टूल यूज़ (Tool Use) और टूल रिजल्ट (Tool Result) के मुख्य बिंदु

• बहु-टूल अनुरोध (Multiple Tool Requests):
• Claude एक ही प्रतिक्रिया में एक से अधिक टूल का उपयोग करने का निर्णय ले सकता है।
• कोड को इस संभावना को ध्यान में रखते हुए लिखा जाना चाहिए कि प्राप्त parts सूची में एक से अधिक टूल यूज़ रिक्वेस्ट हो सकते हैं।

• टूल यूज़ पार्ट्स को निष्पादित करना (Executing Tool Use Parts):
• एक फंक्शन (run tools) बनाया जाता है जो प्राप्त parts सूची पर इटरेट करता है।
• यह केवल उन parts को निकालता है जिनमें tool use की कुंजी (key) मौजूद हो।
• प्रत्येक टूल रिक्वेस्ट से tool use ID, name, और input को निकाला जाता है।

• टूल निष्पादन (Tool Execution):
• एक सहायक फंक्शन (run tool) टूल के नाम और उसके आर्गुमेंट्स (arguments) का उपयोग करके वास्तविक टूल को चलाता है।
• आर्गुमेंट हैंडलिंग: टूल इनपुट को फंक्शन में पास करते समय **tool input (splatting) का उपयोग किया जाता है।
• त्रुटि प्रबंधन (Error Handling): यदि Claude द्वारा मांगा गया टूल मौजूद नहीं है (टाइपो के कारण), तो एक अपवाद (exception) उत्पन्न किया जाना चाहिए।

• टूल रिजल्ट पार्ट्स (Tool Result Parts) बनाना:
• टूल निष्पादन के बाद, परिणाम को Claude को वापस भेजने के लिए एक tool result part बनाया जाता है।
• आवश्यक घटक:
• tool use ID: यह सबसे महत्वपूर्ण है। यह सुनिश्चित करता है कि टूल का आउटपुट सही मूल टूल रिक्वेस्ट से मेल खाए, खासकर जब कई टूल समानांतर (parallel) में चल रहे हों।
• content: टूल द्वारा लौटाया गया आउटपुट (इसे स्ट्रिंग के रूप में सीरियलाइज़ किया जाना चाहिए)।
• status: success या error (त्रुटि की स्थिति में)।

• त्रुटि प्रबंधन (Error Handling in Results):
• try... except ब्लॉक का उपयोग करना अनिवार्य है।
• यदि कोई टूल विफल हो जाता है, तो status को error पर सेट किया जाना चाहिए और त्रुटि संदेश (error message) को content में शामिल किया जाना चाहिए। इससे Claude को समस्या को समझने और उसे ठीक करने में मदद मिलती है।

• अंतिम चरण:
• सभी जेनरेट किए गए tool result parts को एक साथ इकट्ठा किया जाता है और उन्हें अंतिम प्रतिक्रिया के रूप में Claude को वापस भेज दिया जाता है।

Takeaways

• Claude एक ही प्रतिक्रिया में कई टूल का उपयोग कर सकता है, इसलिए कोड को प्राप्त parts सूची में एक से अधिक टूल यूज़ रिक्वेस्ट को संभालने के लिए डिज़ाइन किया जाना चाहिए।
• टूल निष्पादन के लिए, एक फंक्शन को parts सूची पर इटरेट करते हुए टूल यूज़ ID, नाम और इनपुट को सफलतापूर्वक निकालना चाहिए।
• टूल रिजल्ट पार्ट्स में tool use ID सबसे महत्वपूर्ण घटक है, क्योंकि यह सुनिश्चित करता है कि टूल का आउटपुट सही मूल टूल रिक्वेस्ट से मेल खाए।
• त्रुटि प्रबंधन के लिए, यदि कोई टूल विफल होता है, तो status को error पर सेट करना और त्रुटि संदेश को content में शामिल करना अनिवार्य है।