読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 道具を作る

2.1 引数の形と、道具の一覧

練習ファイルは practice/vol1 にあります。RAGの練習ファイルの完成形に、今日の残りの数の表 daily_stock を足しました。練習のため、komorebi_data.sql で今日の日付の数を入れます(カレーパンと季節のタルトは0)。

道具の引数は、Pydanticのクラスで書きます。

class FindProductsArgs(BaseModel):
    keyword: str = Field(min_length=1, max_length=20, description="商品名の一部。例:パン、タルト")
    quantity: int | None = Field(default=None, ge=1, le=50, description="買いたい個数。質問に個数があるときだけ指定する")


class SearchShopGuideArgs(BaseModel):
    query: str = Field(min_length=1, max_length=100, description="調べたいこと。例:定休日、駐車場")

道具は、名前・説明・引数のクラス・実行する関数をまとめた Tool にします。spec() は、Pydanticが作るJSON Schemaを、tools に渡す形に包みます。

@dataclass
class Tool:
    name: str
    description: str
    args_model: type[BaseModel]
    run: Callable[[ToolContext, BaseModel], dict]

    def spec(self) -> dict:
        schema = self.args_model.model_json_schema()
        schema.pop("title", None)
        return {"type": "function", "function": {"name": self.name, "description": self.description, "parameters": schema}}


TOOLS = {
    tool.name: tool
    for tool in [
        Tool("find_products", "商品名の一部で商品を探す。ID・名前・税込価格・予約できるか・今日の残りの数を返す", FindProductsArgs, find_products),
        Tool("search_shop_guide", "店の案内(営業時間、定休日、予約の決まり、支払い、駐車場など)を探す", SearchShopGuideArgs, search_shop_guide),
    ]
}

search_shop_guide は、RAGの search をそのまま道具にしています。資料の検索も、エージェントから見れば道具の一つです。

LLMが道具を選ぶ手がかりは、名前と description だけです。説明には「何を受け取り、何を返すか」を書きます。search_shop_guide の説明に、営業時間・定休日などの例を並べたのは、どんな質問でこの道具を使うかをLLMに伝えるためです。

6 / 22