课程大纲 第 140 课,共 250 课 · 结构化输出与函数/工具调用
结构化输出与函数/工具调用

函数 -> 工具 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。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。