関数 -> ツールのスキーマ(イントロスペクション)
ツール呼び出し(関数呼び出しとも呼びます)を使うと、モデルがあなたのプログラムに関数の実行を頼めます:ツールの組を宣伝し、モデルがツール名と引数で返答し、あなたがそれを実行するのです。でもモデルにはあなたの 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 に入れるのは既定値がないときだけにします。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。