跳到主要内容
Open on GitHub

输出解析器

注意

此处的信息指的是从模型获取文本输出并尝试将其解析为更结构化表示形式的解析器。 越来越多的模型支持函数（或工具）调用，这可以自动处理此问题。 建议使用函数/工具调用而不是输出解析。 请参阅此处的文档。

输出解析器负责获取模型的输出并将其转换为更适合下游任务的格式。 当您使用 LLM 生成结构化数据，或标准化来自聊天模型和 LLM 的输出时，此功能很有用。

LangChain 有许多不同类型的输出解析器。 这是 LangChain 支持的输出解析器列表。 下表包含各种信息

  • 名称：输出解析器的名称
  • 支持流式传输：输出解析器是否支持流式传输。
  • 具有格式说明：输出解析器是否具有格式说明。 通常情况下，除了以下情况外，此功能都可用：(a) 所需的架构未在提示中指定，而是在其他参数（如 OpenAI 函数调用）中指定，或者 (b) 当 OutputParser 包装另一个 OutputParser 时。
  • 调用 LLM：此输出解析器本身是否调用 LLM。 这通常仅由尝试纠正格式错误的输出的输出解析器完成。
  • 输入类型：预期输入类型。 大多数输出解析器都适用于字符串和消息，但有些（如 OpenAI 函数）需要带有特定 kwargs 的消息。
  • 输出类型：解析器返回的对象的输出类型。
  • 描述：我们对此输出解析器的评论以及何时使用它。
名称支持流式传输具有格式说明调用 LLM输入类型输出类型描述
Str✅str | Message字符串从消息对象解析文本。 用于处理消息内容的可变格式（例如，从内容块中提取文本）。
JSON✅✅str | MessageJSON 对象返回指定的 JSON 对象。 您可以指定 Pydantic 模型，它将返回该模型的 JSON。 可能是获取不使用函数调用的结构化数据最可靠的输出解析器。
XML✅✅str | Messagedict返回标签字典。 当需要 XML 输出时使用。 与擅长编写 XML 的模型（如 Anthropic 的模型）一起使用。
CSV✅✅str | MessageList[str]返回逗号分隔值的列表。
OutputFixing✅str | Message包装另一个输出解析器。 如果该输出解析器出错，则此解析器会将错误消息和错误输出传递给 LLM，并要求其修复输出。
RetryWithError✅str | Message包装另一个输出解析器。 如果该输出解析器出错，则此解析器会将原始输入、错误输出和错误消息传递给 LLM，并要求其修复它。 与 OutputFixingParser 相比，此解析器还会发送原始说明。
Pydantic✅str | Messagepydantic.BaseModel接受用户定义的 Pydantic 模型，并以该格式返回数据。
YAML✅str | Messagepydantic.BaseModel接受用户定义的 Pydantic 模型，并以该格式返回数据。 使用 YAML 进行编码。
PandasDataFrame✅str | Messagedict用于使用 pandas DataFrames 执行操作。
Enum✅str | MessageEnum将响应解析为提供的枚举值之一。
Datetime✅str | Messagedatetime.datetime将响应解析为 datetime 字符串。
Structured✅str | MessageDict[str, str]返回结构化信息的输出解析器。 它不如其他输出解析器强大，因为它只允许字段为字符串。 当您使用较小的 LLM 时，这可能很有用。

有关如何使用输出解析器的具体信息，请参阅此处的相关操作指南。

此页面是否对您有帮助？