Programma Les 230 van 250 · Project: onderzoeksagent die tools gebruikt
Project: onderzoeksagent die tools gebruikt

Toolregister + dispatcher

Elke "AI agent" waar je ooit over hebt gelezen, komt neer op één onopvallend onderdeel: een tool registry. Het model geeft iets uit als {"tool": "search", "args": {"query": "weather"}}, en your code moet de juiste Python function vinden, controleren of de argumenten logisch zijn, deze uitvoeren en het resultaat teruggeven. Als je deze laag fout aanpakt, is de hele agent met één verkeerd argument een crash in productie verwijderd. Deze eerste les van het project bouwt precies die laag, en je zult het idee in elke les daarna hergebruiken.

Je bouwt de dispatcher voor een research agent. Het heeft twee tools nodig om te starten: een search(query) die een feit opzoekt, en een calc(op, a, b) die rekenkundige bewerkingen uitvoert. De registry koppelt een tool name aan een paar: de functie, en een argument schema (de set van argumentnamen die de tool accepteert). Dispatch is de poort waar alles doorheen gaat.

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

De regels dispatch moet afdwingen (dit is het hele doel van de oefening):

  • An unknown tool naam -> raise KeyError. De agent vroeg om iets dat niet bestaat.
  • De args dict's keys moeten exact overeenkomen met het geregistreerde schema . Een ontbrekende argument of een extra one -> raise ValueError. Dit is wat voorkomt dat een gehallucineerde {"q": ...} (verkeerde key) onopgemerkt niets doet.
  • A geldige aanroep -> voer fn(**args) uit en retourneer wat het retourneert.

Waarom een set voor het schema? Omdat validatie dan gewoon gelijkheid is: set(args) == self.tools[name]["args"]. Als dat onwaar is, moet je bepalen of er keys ontbreken of extra zijn en in beide gevallen ValueError aanroepen. Het aanroepen met fn(**args) spreidt de dict naar keyword arguments, dus de functie signatuur doet de uiteindelijke binding.

Een

A hiring manager die "built a tool-using agent" leest, vraagt eigenlijk: heb je de unhappy path afgehandeld? De agent die wordt uitgebracht is degene waarvan de dispatcher slechte calls luidruchtig weigert in plaats van een run te corrumperen. Druk op Run om twee tools te registreren en kijk hoe goede calls slagen terwijl slechte calls een error geven.

Jij bent aan de beurt

Bouw een Registry klasse. register(name, fn, args) slaat de functie en het schema van de argument-namen op (gebruik een set). dispatch(name, args) moet: KeyError geven voor een onbekende toolnaam; ValueError geven als de keys van args niet exact overeenkomen met het schema (ontbrekend OF extra); anders fn(**args) aanroepen en het resultaat teruggeven. Registreer een search(query) en een calc(op, a, b) tool zodat de dispatcher iets reëls heeft om naar toe te routeren.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.