函数 -> 工具 schema(内省)
工具调用(也叫函数调用)让模型可以要求你的程序运行一个函数:你公布一组工具,模型回复一个工具名和参数,然后你执行它。但模型看不到你的 Python:它只看到一个 schema,也就是一份描述每个工具的名字和参数的 JSON。为每个函数手写这些 schema 很繁琐,而且你一改签名,它们就会对不上。解决办法是内省:直接从函数生成 schema。
Python 的 inspect 模块在运行时读取函数的签名。工具调用 API 期望的 schema 看起来是这样的:
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}你要构建 tool_schema(func),正好产生这个。两个想法完成了全部工作:
- 把 Python 类型映射到 JSON schema 类型。读取每个参数的标注并转换:
int->"integer",float->"number",str->"string",bool->"boolean"。其他任何东西默认为"string"。 - 从默认值推导出必需参数。没有默认值的参数是必需的;有默认值的参数是可选的。
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__ 作为工具名。把它构建成这样:两个标注不同的函数产生两个明显不同的 schema,int 参数显示为 "integer",str 参数显示为 "string",有默认值的参数不在 required 里,而没有默认值的参数在里面。这就是每个工具调用集成所依赖的约定。
写 tool_schema(func),用 inspect.signature 内省一个函数,并返回 {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}。映射 int->"integer"、float->"number"、str->"string"、bool->"boolean"(默认 "string"),只有当一个参数没有默认值时,才把它放进 required。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。