シラバス レッスン 250 中 140 · 構造化出力と関数/ツール呼び出し
構造化出力と関数/ツール呼び出し

関数 -> ツールのスキーマ(イントロスペクション)

ツール呼び出し(関数呼び出しとも呼びます)を使うと、モデルがあなたのプログラムに関数の実行を頼めます:ツールの組を宣伝し、モデルがツール名と引数で返答し、あなたがそれを実行するのです。でもモデルにはあなたの Python は見えません -> 見えるのはスキーマだけです:各ツールの名前と引数を JSON で記述したものです。そのスキーマをすべての関数について手で書くのは面倒で、シグネチャを変えた瞬間に食い違ってしまいます。直し方はイントロスペクションです:関数から直接スキーマを生成するのです。

Python の inspect モジュールは、実行時に関数のシグネチャを読みます。ツール呼び出しの API が期待するスキーマはこんな形です:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

まさにそれを生み出す tool_schema(func) を作ります。2 つの考えがすべての仕事をします:

  • Python の型を JSON スキーマの型に対応させる。各引数の注釈を読んで変換します:int -> "integer"、float -> "number"、str -> "string"、bool -> "boolean"。それ以外はすべて既定で "string" にします。
  • 既定値から required を導く。既定値のない引数は必須で、既定値のある引数は省略可能です。inspect.Parameter.empty が「既定値なし」の番兵です。
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
    is_required = param.default is inspect.Parameter.empty
    json_type = ...   # from param.annotation

ツール名には func.__name__ を使います。違う注釈を持つ 2 つの関数からははっきり違う 2 つのスキーマができ、int の引数は "integer"、str は "string" として現れ、既定値のある引数は required から外れ、既定値のない引数はそこに入るように作ってください。それが、あらゆるツール呼び出しの統合が頼りにする約束です。

あなたの番

inspect.signature で関数をイントロスペクトし、{"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}} を返す tool_schema(func) を書いてください。int->"integer"、float->"number"、str->"string"、bool->"boolean"(既定は "string")と対応させ、引数を required に入れるのは既定値がないときだけにします。

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

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

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