文档摘要

4.1 输入 Schema:从类型注解到 JSON Schema 本节摘要:本章的核心命题是「类型即契约」,本节先讲输入这一半——函数的参数类型注解,如何变成给模型的输入 JSON Schema。背后是 SDK 的函数元数据( )机制:它在你用 装饰的那一刻,扫描函数签名,把 Python 类型映射成 JSON Schema 的类型,把参数名映射成 Schema 的字段,把文档字符串映射成描述。我们会讲透这套映射规则——基础类型、容器类型、可选类型、Pydantic 模型各自怎么映射,以及为什么这套机制能替代手写 Schema。读完本节,你能向别人讲清楚「为什么 就够」。 一、funcmetadata:扫描函数的引擎 先认识幕后的主角:函数元数据( )。

---