पाठ्यक्रम 250 में से पाठ 230 · प्रोजेक्ट: tool इस्तेमाल करने वाला research agent
प्रोजेक्ट: tool इस्तेमाल करने वाला research agent

Tool registry + dispatcher

आपने जिस भी "AI agent" के बारे में पढ़ा है वह आख़िर में एक फीके हिस्से पर टिकता है: एक tool registry। मॉडल {"tool": "search", "args": {"query": "weather"}} जैसा कुछ देता है, और आपके कोड को सही Python फ़ंक्शन ढूँढना, जाँचना कि आर्ग्युमेंट ठीक हैं, उसे चलाना, और नतीजा वापस देना होता है। इस परत को ग़लत करें और पूरा agent production में क्रैश से बस एक बिगड़े आर्ग्युमेंट दूर है। प्रोजेक्ट का यह पहला पाठ ठीक वह परत बनाता है, और आप यह विचार बाद के हर पाठ में दोबारा इस्तेमाल करेंगे।

आप एक research agent का dispatcher बना रहे हैं। शुरुआत के लिए इसे दो tools चाहिए: तथ्य ढूँढने वाला एक search(query), और गणित करने वाला एक calc(op, a, b)। registry एक tool नाम को एक जोड़े से जोड़ती है: फ़ंक्शन, और एक आर्ग्युमेंट schema (tool जो आर्ग्युमेंट नाम स्वीकार करता है उनका set)। dispatch वह द्वार है जिससे सब कुछ गुज़रता है।

class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

dispatch को जो नियम लागू करने हैं (अभ्यास का पूरा मक़सद यही है):

  • एक अनजान tool नाम -> KeyError उठाएँ। agent ने ऐसी चीज़ माँगी जो मौजूद नहीं।
  • args dict की कुंजियाँ register किए schema से ठीक मेल खानी चाहिए। एक ग़ायब आर्ग्युमेंट या एक अतिरिक्त -> ValueError उठाएँ। यही एक गढ़े {"q": ...} (ग़लत कुंजी) को चुपचाप कुछ न करने से रोकता है।
  • एक मान्य कॉल -> fn(**args) चलाएँ और जो वह लौटाए वह लौटाएँ।

schema के लिए set क्यों? क्योंकि तब जाँच बस set बराबरी है: set(args) == self.tools[name]["args"]। अगर वह false है, तो पता करें कि कुंजियाँ ग़ायब हैं या अतिरिक्त और दोनों तरह ValueError उठाएँ। fn(**args) से बुलाना dict को keyword arguments में फैला देता है, इसलिए फ़ंक्शन signature आख़िरी जोड़ करता है।

"tool इस्तेमाल करने वाला agent बनाया" पढ़ने वाला hiring manager असल में पूछ रहा है: क्या आपने नाख़ुश रास्ता सँभाला? जो agent भेजा जाता है वह है जिसका dispatcher एक दौर बिगाड़ने के बजाय ख़राब calls को ज़ोर से मना करता है। दो tools register करने और अच्छी calls को सफल होते जबकि ख़राब को error उठाते देखने के लिए Run दबाएँ।

आपकी बारी

एक Registry क्लास बनाएँ। register(name, fn, args) फ़ंक्शन और उसका आर्ग्युमेंट-नाम schema रखता है (एक set इस्तेमाल करें)। dispatch(name, args) को: अनजान tool नाम पर KeyError उठाना होगा; अगर args की कुंजियाँ schema से ठीक मेल न खाएँ (ग़ायब या अतिरिक्त) तो ValueError उठाना होगा; नहीं तो fn(**args) बुलाकर नतीजा लौटाना होगा। एक search(query) और एक calc(op, a, b) tool register करें ताकि dispatcher के पास route करने को कुछ असली हो।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।