MultipleStructuredOutputsError Class — langchain Architecture

Architecture documentation for the MultipleStructuredOutputsError class in structured_output.py from the langchain codebase.

Class python

Entity Profile

Dependency Diagram

graph TD
  81c4b461_b90b_e57e_6c0f_02a237e01142["MultipleStructuredOutputsError"]
  e116611b_2ad2_e3dc_b8ed_0c4a94d5b747["StructuredOutputError"]
  81c4b461_b90b_e57e_6c0f_02a237e01142 -->|extends| e116611b_2ad2_e3dc_b8ed_0c4a94d5b747
  c2936c24_74cd_6911_037b_0f67eebfefee["structured_output.py"]
  81c4b461_b90b_e57e_6c0f_02a237e01142 -->|defined in| c2936c24_74cd_6911_037b_0f67eebfefee
  b6aaa613_5bca_34be_c082_689cacd3617e["__init__()"]
  81c4b461_b90b_e57e_6c0f_02a237e01142 -->|method| b6aaa613_5bca_34be_c082_689cacd3617e

Relationship Graph

Source Code

libs/langchain_v1/langchain/agents/structured_output.py lines 41–57

class MultipleStructuredOutputsError(StructuredOutputError):
    """Raised when model returns multiple structured output tool calls when only one is expected."""

    def __init__(self, tool_names: list[str], ai_message: AIMessage) -> None:
        """Initialize `MultipleStructuredOutputsError`.

        Args:
            tool_names: The names of the tools called for structured output.
            ai_message: The AI message that contained the invalid multiple tool calls.
        """
        self.tool_names = tool_names
        self.ai_message = ai_message

        super().__init__(
            "Model incorrectly returned multiple structured responses "
            f"({', '.join(tool_names)}) when only one is expected."
        )