読み方のヒント

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

第2節 引数を決める

2.2 決まった値の一覧と日付

モデルに渡す道具の説明(practice/agent_data/tool_specs.py)には、引数の型と、決まった値の一覧を書きます。

{
    "name": "find_unpaid_invoices",
    "description": "未払いの請求書の一覧。件数が多いときは先頭だけを返し、truncated が true になる。",
    "input_schema": {
        "type": "object",
        "properties": {
            "supplier_number": {"type": "string", "pattern": "^1\\d{5}$"},
            "status": {"type": "string", "enum": ["blocked", "exception", "not_due", "open"]},
            "limit": {"type": "integer", "minimum": 1, "maximum": 20},
        },
    },
}

status に enum を書いておくと、モデルは「保留中」のような日本語ではなく、blocked を選びます。値の一覧は、業務データモデルの状態の定義と同じにします。

日付は、問いの言葉のままでは渡せません。「11月30日の支払」の「11月30日」を、モデルが 2026-11-30 に直して渡します。直し忘れたときは、道具が次のように返します。

ToolError: run_date は YYYY-MM-DD の形で指定してください(受け取った値:'11月30日')

エラーの文は、モデルが読んで、引数を直して呼び直せるように書きます。「不正な値です」だけでは、何を直せばよいかが分かりません。

解答例

「limit は 1〜20 で指定してください。20件を超えるときは、仕入先や状態で絞って複数回呼んでください。」受け付ける範囲と、範囲を超えたいときの方法の両方を書きます。

7 / 20