输出解析器
注意
这里的信息指的是解析器，它接收模型的文本输出并尝试将其解析为更结构化的表示。越来越多的模型支持函数（或工具）调用，它可以自动处理此问题。建议使用函数/工具调用而不是输出解析。请参阅此处的文档。
输出解析器 负责接收模型的输出并将其转换为更适合下游任务的格式。当您使用 LLM 生成结构化数据，或规范化来自聊天模型和 LLM 的输出时，此功能非常有用。
LangChain 有许多不同类型的输出解析器。这是 LangChain 支持的输出解析器列表。下表包含各种信息
- 名称：输出解析器的名称
- 支持流式传输：输出解析器是否支持流式传输。
- 具有格式说明：输出解析器是否具有格式说明。通常情况下，除了 (a) 所需的模式未在提示中指定，而是在其他参数中指定（如 OpenAI 函数调用），或 (b) OutputParser 包装另一个 OutputParser 时，此项均可用。
- 调用 LLM：此输出解析器本身是否调用 LLM。通常仅由尝试纠正格式错误的输出的输出解析器执行此操作。
- 输入类型：预期的输入类型。大多数输出解析器都适用于字符串和消息，但有些（如 OpenAI 函数）需要带有特定 kwargs 的消息。
- 输出类型：解析器返回的对象的输出类型。
- 描述：我们对该输出解析器的评论以及何时使用它。
| 名称 | 支持流式传输 | 具有格式说明 | 调用 LLM | 输入类型 | 输出类型 | 描述 |
|---|---|---|---|---|---|---|
| Str | ✅ | str | Message | 字符串 | 解析来自消息对象的文本。对于处理消息内容的可变格式非常有用（例如，从内容块中提取文本）。 | ||
| JSON | ✅ | ✅ | str | Message | JSON 对象 | 按指定返回 JSON 对象。您可以指定一个 Pydantic 模型，它将返回该模型的 JSON。可能是获取不使用函数调用的结构化数据最可靠的输出解析器。 | |
| XML | ✅ | ✅ | str | Message | dict | 返回标签字典。当需要 XML 输出时使用。与擅长编写 XML 的模型（如 Anthropic 的模型）一起使用。 | |
| CSV | ✅ | ✅ | str | Message | List[str] | 返回逗号分隔值的列表。 | |
| OutputFixing | ✅ | str | Message | 包装另一个输出解析器。如果该输出解析器出错，则此解析器会将错误消息和错误输出传递给 LLM，并要求其修复输出。 | |||
| RetryWithError | ✅ | str | Message | 包装另一个输出解析器。如果该输出解析器出错，则此解析器会将原始输入、错误输出和错误消息传递给 LLM，并要求其修复输出。与 OutputFixingParser 相比，此解析器还会发送原始指令。 | |||
| Pydantic | ✅ | str | Message | pydantic.BaseModel | 采用用户定义的 Pydantic 模型，并返回该格式的数据。 | ||
| YAML | ✅ | str | Message | pydantic.BaseModel | 采用用户定义的 Pydantic 模型，并返回该格式的数据。使用 YAML 对其进行编码。 | ||
| PandasDataFrame | ✅ | str | Message | dict | 用于使用 pandas DataFrames 进行操作。 | ||
| Enum | ✅ | str | Message | Enum | 将响应解析为提供的枚举值之一。 | ||
| Datetime | ✅ | str | Message | datetime.datetime | 将响应解析为日期时间字符串。 | ||
| Structured | ✅ | str | Message | Dict[str, str] | 一个返回结构化信息的输出解析器。它不如其他输出解析器强大，因为它只允许字段为字符串。当您使用较小的 LLM 时，这会非常有用。 |
有关如何使用输出解析器的具体信息，请参阅此处的相关操作指南。