シラバス レッスン 250 中 230 · プロジェクト:ツールを使う調査エージェント
プロジェクト:ツールを使う調査エージェント

ツールの登録簿 + ディスパッチャー

これまでに読んだことのあるあらゆる「AI エージェント」は、突き詰めると 1 つの地味な部品に行き着きます:ツールの登録簿です。モデルが {"tool": "search", "args": {"query": "weather"}} のようなものを出し、あなたのコードが正しい Python の関数を見つけ、引数がまともであることを確かめ、それを実行し、結果を返さなければなりません。この層を間違えると、エージェント全体が、形の崩れた引数 1 つで本番のクラッシュに陥ります。このプロジェクトの最初のレッスンでは、まさにその層を作り、その考えをこのあとのすべてのレッスンで再利用します。

調査エージェントのディスパッチャーを作ります。始めにツールが 2 つ必要です:事実を調べる search(query) と、算数をする calc(op, a, b) です。登録簿はツール名を組に対応させます:関数と、引数のスキーマ(ツールが受け付ける引数名の集合)です。ディスパッチは、すべてが通り抜ける関門です。

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

ディスパッチが守らせなければならないルール(これがこの演習の要点のすべてです):

  • 未知のツール名 -> KeyError を送出する。エージェントは存在しないものを求めた。
  • args の辞書のキーは、登録したスキーマとちょうど一致しなければならない。引数が欠けているか余分なら -> ValueError を送出する。これが、幻覚で作られた {"q": ...}(間違ったキー)が黙って何もしないのを止めるものです。
  • 有効な呼び出し -> fn(**args) を実行し、それが返すものを何でも返す。

スキーマになぜ set を使うのか?そうすれば検証はただの集合の等しさになるからです:set(args) == self.tools[name]["args"]。それが偽なら、キーが欠けているのか余分なのかを調べ、どちらにしても ValueError を送出します。fn(**args) で呼べば辞書がキーワード引数に展開されるので、関数のシグネチャが最後の結び付けをしてくれます。

「ツールを使うエージェントを作った」を読んだ採用担当者が本当に尋ねているのは:うまくいかない道筋を扱ったか?ということです。出荷されるエージェントは、ディスパッチャーが実行を壊す代わりに、悪い呼び出しを大きな音を立てて拒否するものです。実行を押して 2 つのツールを登録し、良い呼び出しが成功し、悪い呼び出しがエラーになる様子を見てください。

あなたの番

Registry クラスを作ってください。register(name, fn, args) は関数とその引数名のスキーマを保存します(set を使います)。dispatch(name, args) は次のことをしなければなりません:未知のツール名では KeyError を送出する。args のキーがスキーマとちょうど一致しなければ(欠けているか余分)ValueError を送出する。そうでなければ fn(**args) を呼んで結果を返す。ディスパッチャーに本物の振り分け先があるように、search(query) と calc(op, a, b) のツールを登録してください。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。