2.2 模式2：TypedDict

2.2.1 什么是 TypedDict
TypedDict 是 Python 3.8+ 引入的一种类型提示工具，即带有类型声明的字典结构。适合需要快速定义字典结构且无需 Pydantic 重量级功能的场景。
1、普通 dict 没有类型信息：

2、 TypedDict 可以进一步说明：

• 这个字典应该有哪些字段
• 每个字段的类型是什么
• TypedDict 主要是类型声明，不是运行时强校验器。

举例：

实例化字典时给出的字段名称和TypedDict不完全一致，此时IDE的静态类型检查会标记。

但不会导致运行时异常，输出如下所示

2.2.2 基本使用
Annotated的使用
Annotated 用来在“类型”之外，再附加一些额外信息，即元数据。类似于Pydantic 的Field 。
基本形式：

Annotated[类型1 , 附加信息1, 附加信息2, ...]

举例的前提：
使用CloseAI平台的gpt模型：

使用OpenRouter平台的gpt模型：

举例1：返回简单结构

输出如下：

举例2：返回嵌套结构

输出如下：

举例3：…的使用
说明：与模型提供商有关系
使用CloseAI平台gpt模型：

输出

使用OpenRouter平台gpt模型：

说明：上述代码的… 是Python的字面量，等价于Ellipsis ，可以理解为占位符。下游框架（如LangChain）可以对… 作定制化处理，如LangChain中Annotated的… 表示当前字段是必须存在的，不可省略，用来指示模型的输出。
再比如：

输出

director 和rating 的信息都是缺失的，但是前者被标记为必填，因此输出的字典包含该字段但是值为空字符串，而rating 字段被省略了。