Skip to main content
जब एजेंट को ऐप्लिकेशन डेटा पढ़ना हो, किसी आंतरिक सेवा को कॉल करना हो या कोई कार्रवाई करनी हो, तब टूल इस्तेमाल करें। Agent SDK टूल की सीमाओं की जाँच करता है और टूल कोड आपके ऐप्लिकेशन में चलाता है।

लोकल टूल परिभाषित करें

defineTool() में विवरण, वैकल्पिक JSON पैरामीटर, रनटाइम वैलिडेटर, टाइमआउट और execute() फ़ंक्शन दिए जा सकते हैं।
टाइमआउट होने पर रनटाइम context.signal रद्द करता है, रन को विफल चिह्नित करता है और टाइमआउट त्रुटि फिर से भेजता है। स्कीमा फ़ंक्शन या parse() अथवा safeParse() देने वाले ऑब्जेक्ट हो सकते हैं। मॉडल के अमान्य तर्क और टूल के अमान्य नतीजे टूल सीमा पार करने से पहले विफल हो जाते हैं।

अपने ऐप्लिकेशन में काम चलाएँ

जब SDK प्रक्रिया के बजाय आपका ऐप्लिकेशन काम करे, तो execute: false सेट करें। toolOutputs में नतीजा देकर रुके हुए रन को आगे बढ़ाएँ। इंटरैक्टिव टूल के लिए onToolCalled से null लौटाएँ। रन जारी होने के बाद onResponseReceived दी गई प्रतिक्रिया की जाँच या उसे बदल सकता है।

प्रगति प्रकाशित करें

असिंक्रोनस जनरेटर अंतिम नतीजा देने से पहले शुरुआती नतीजे दे सकता है:
प्रगति tool.preliminary_result इवेंट और स्टेप के preliminaryResults से मिलती है।

स्वतंत्र टूल एक साथ चलाएँ

अगर मॉडल का एक टर्न कई स्वतंत्र टूल सुरक्षित रूप से कॉल कर सकता है, तो समवर्ती सीमा सेट करें:
लोकल निष्पादन एक साथ होने पर भी रनटाइम टूल-नतीजा संदेशों का क्रम बनाए रखता है।

संबंधित गाइड

अंतिम संशोधन 2 अक्टूबर 2026