Implementing multiple turns

📝 अध्ययन नोट्स: बातचीत और टूल कार्यान्वयन (Conversation and Tool Implementation)

यह नोट्स run_conversation फ़ंक्शन के मुख्य कार्य और टूल उपयोग की पहचान करने की प्रक्रिया पर केंद्रित हैं।

🎯 मुख्य उद्देश्य और कार्यप्रणाली

• run_conversation का लक्ष्य: Claude को तब तक लगातार कॉल करना जब तक वह टूल का उपयोग करने का अनुरोध नहीं करता।
• समाप्ति की शर्त: जब Claude टूल का उपयोग करना बंद कर देता है, तो यह संकेत है कि उसने अंतिम प्रतिक्रिया तैयार कर ली है और लूप को तोड़ दिया जाना चाहिए।
• टूल पहचान (Tool Use Detection): प्रतिक्रिया संदेश (response message) के stop_reason फ़ील्ड की जाँच की जाती है।
• यदि stop_reason का मान tool_use है → Claude को टूल चलाने की आवश्यकता है।
• यदि stop_reason tool_use के बराबर नहीं है → बातचीत समाप्त हो गई है।

⚙️ कार्यान्वयन का प्रवाह (Implementation Flow)

• run_tool हेल्पर फ़ंक्शन:
• यह एक समर्पित फ़ंक्शन है जो टूल के नाम और इनपुट को स्वीकार करता है।
• यह if स्टेटमेंट्स का उपयोग करके सही टूल फ़ंक्शन को चुनता है और उसका परिणाम लौटाता है।
• यह दृष्टिकोण नए टूल्स को सिस्टम में जोड़ना सरल बनाता है।
• run_conversation का वर्कफ़्लो:
• एक while लूप के भीतर प्रक्रिया दोहराई जाती है।
• Claude को वर्तमान इतिहास और उपलब्ध टूल्स के साथ कॉल किया जाता है।
• यदि Claude टूल का उपयोग करने का अनुरोध करता है (Tool Use Block), तो run_tool द्वारा टूल चलाया जाता है।
• टूल का परिणाम उपयोगकर्ता संदेश के रूप में इतिहास में जोड़ा जाता है।
• लूप की शुरुआत में वापस जाकर, टूल परिणामों के साथ Claude को फिर से कॉल किया जाता है।
• यह प्रक्रिया तब तक चलती है जब तक टूल उपयोग का अनुरोध नहीं रुक जाता।

💡 महत्वपूर्ण अवधारणाएँ (Key Concepts)

• मल्टी-टर्न और मल्टी-टूल हैंडलिंग: सिस्टम सफलतापूर्वक मल्टी-टर्न टूल कॉलिंग को संभालता है।
• ब्लॉक प्रोसेसिंग: एक ही संदेश में टेक्स्ट ब्लॉक और टूल यूज़ ब्लॉक दोनों होने पर उन्हें सही क्रम में प्रोसेस करना आवश्यक है।
• अगले चरण: add_duration_to_datetime और set_reminder टूल्स के लिए सपोर्ट जोड़ना शेष है।

Takeaways

• run_conversation का मुख्य कार्य टूल उपयोग के अनुरोध के रुकने तक Claude को लगातार कॉल करना है।
• टूल उपयोग की पहचान प्रतिक्रिया संदेश के stop_reason फ़ील्ड की जाँच करके की जाती है; यदि मान tool_use है, तो टूल की आवश्यकता है।
• कार्यप्रवाह में, टूल चलाने के बाद उसका परिणाम इतिहास में जोड़ा जाता है और फिर Claude को दोबारा कॉल किया जाता है।
• run_tool हेल्पर फ़ंक्शन का उपयोग नए टूल्स को सिस्टम में जोड़ना सरल बनाता है।