Lehrplan Lektion 230 von 250 · Projekt: Tool-Using Research Agent
Projekt: Tool-Using Research Agent

Tool-Register + Dispatcher

Jeder "AI agent", über den du je gelesen hast, stößt an eine unglamouröse Komponente: eine tool registry. Das Modell gibt etwas wie {"tool": "search", "args": {"query": "weather"}} aus, und your code muss die richtige Python function finden, prüfen, ob die Argumente sinnvoll sind, sie ausführen und das Ergebnis zurückgeben. Wenn du diese Schicht falsch baust, ist der ganze Agent nur ein fehlerhaftes Argument von einem Absturz in der Produktion entfernt. Diese erste Lektion des Projekts baut genau diese Schicht auf, und du wirst die Idee in jeder darauffolgenden Lektion wiederverwenden.

Du baust den Dispatcher für einen Forschungsagenten. Er braucht zwei Tools zum Start: ein search(query), das einen Fakten prüft, und ein calc(op, a, b), das Arithmetik ausführt. Die Registry bildet einen tool name auf ein Paar ab: die function und ein argument schema (die Menge der Argumentnamen, die das Tool akzeptiert). Dispatch ist das Tor, durch das alles geht.

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 Regeln des Dispatch müssen erzwingen(das ist der ganze Sinn der Übung):

  • An unknown tool Name -> raise KeyError. Der Agent hat nach etwas gefragt, das nicht existiert.
  • Die Schlüssel des args dicts müssen dem registrierten Schema genau entsprechen. Ein fehlendes Argument oder ein zusätzliches Argument -> raise ValueError. Das verhindert, dass ein halluziniertes {"q": ...} (falscher Schlüssel) stillschweigend nichts tut.
  • A gültiger Aufruf -> führe fn(**args) aus und gib zurück, was es zurückgibt.

Warum ein set für das Schema? Weil die Validierung dann nur eine Gleichheitsprüfung ist: set(args) == self.tools[name]["args"]. Wenn das falsch ist, finde heraus, ob Schlüssel fehlen oder extra sind und wirf in jedem Fall ValueError. Der Aufruf mit fn(**args) verteilt das Dictionary in Keyword-Argumente, also übernimmt die Funktionssignatur die finale Bindung.

Ein

A Hiring Manager, der "built a tool-using agent" liest, fragt eigentlich: Hast du den unhappy path behandelt? Der Agent, der ausgeliefert wird, ist derjenige, dessen dispatcher schlechte Aufrufe laut ablehnt, anstatt einen Run zu korrumpieren. Drücke Run, um zwei tools zu registrieren und zu sehen, wie gute Aufrufe erfolgreich sind, während schlechte ones einen Fehler auslösen.

Du bist dran

Erstelle eine Registry Klasse. register(name, fn, args) speichert die Funktion und das Schema der Argumentnamen (nutze ein set). dispatch(name, args) muss: KeyError für einen unbekannten Toolnamen auslösen; ValueError auslösen, wenn args' Keys nicht exakt zum Schema passen (fehlend ODER extra); ansonsten fn(**args) aufrufen und das Ergebnis zurückgeben. Registriere ein search(query) und ein calc(op, a, b) Tool, damit der Dispatcher etwas Reales zum Routen hat.

Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion

Diese Übung öffnet bald

Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.