Kurrikulum Leson 230 van 250 · Projek: Tool-gebruikende Navorsingsagent
Projek: Tool-gebruikende Navorsingsagent

Gereedskapregister + Verspreider

Elke "AI agent" waaroor jy nog ooit gelees het, kom tot by een onopgepte komponent: 'n tool registry. Die model stuur iets soos {"tool": "search", "args": {"query": "weather"}}, en your code moet die regte Python function vind, kyk of die arguments sinvol is, dit uitvoer, en die resultaat teruggee. As jy hierdie laag verkeerd doen, is die hele agent een foutiewe argument weg van 'n crash in produksie. Hierdie eerste les van die projek bou presies daardie laag, en jy sal die idee in elke les daarna hergebruik.

Jy bou die dispatcher vir 'n navorsingsagent. Dit het twee gereedskap nodig om te begin: 'n search(query) wat 'n feit opsoek, en 'n calc(op, a, b) wat rekenkunde doen. Die registry koppel 'n tool name aan 'n paar: die function, en 'n argument schema (die stel argumente wat die tool aanvaar). Dispatch is die hek waarby alles verbygaan.

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
        ...

Die reëls-dispatch moet afdwing(dit is die hele doel van die oefening):

  • An unknown tool naam -> gooi KeyError. Die agent het gevra vir iets wat nie bestaan nie.
  • Die args dict's sleutels moet presies ooreenstem met die geregistreerde skema exactly. 'n ontbrekende argument of 'n ekstra een -> raise ValueError. Dit keer dat 'n gehallusineerde {"q": ...} (verkeerde sleutel) stilweg niks doen nie.
  • A geldige oproep -> run fn(**args) en gee terug wat dit teruggee.

Hoekom 'n set vir die skema? Want validering is dan net gelykheid: set(args) == self.tools[name]["args"]. As dit vals is, vind uit of sleutels kort of ekstra is en gooi ValueError in elk geval. Roep met fn(**args) versprei die dict na keyword-argumente, so die funksie-handtekening doen die finale binding.

Die

A aanstellingsbestuurder wat "built a tool-using agent" lees, vra eintlik: het jy die unhappy path hanteer? Die agent wat verskik is die een wie se dispatcher slegte oproepe hardop weier in plaas daarvan om 'n run te korrupeer. Druk Run om twee tools te registreer en kyk hoe goeie oproepe slaag terwyl slegte oproepe raise.

Jou beurt

Bou 'n Registry klas. register(name, fn, args) stoor die funksie en die argument-naam skema (gebruik 'n set). dispatch(name, args) moet: KeyError weggooi vir 'n onbekende hulpbronnaam; ValueError weggooi as args' sleutels nie presies by die skema pas nie (ontbrekend OF ekstra); anders moet dit fn(**args) aanroep en die resultaat teruggee. Registreer 'n search(query) en 'n calc(op, a, b) hulpbron sodat die dispatcher iets regts het om na te roeter.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.