on_chain_error() — langchain Function Reference

Architecture documentation for the on_chain_error() function in manager.py from the langchain codebase.

Function python Observability CallbackManager calls 2 called by 2

Entity Profile

Observability→ CallbackManager→ on_chain_error() — langchain Function Reference

Dependency Diagram

graph TD
  ddaf4521_92bb_e16f_7a60_d3b79151a068["on_chain_error()"]
  d905f7ba_84e1_978e_30ed_f25fd37354ce["AsyncCallbackManagerForChainRun"]
  ddaf4521_92bb_e16f_7a60_d3b79151a068 -->|defined in| d905f7ba_84e1_978e_30ed_f25fd37354ce
  07a4c44a_3cfb_9b0a_ffde_c1bbfeb4080a["on_chain_error()"]
  07a4c44a_3cfb_9b0a_ffde_c1bbfeb4080a -->|calls| ddaf4521_92bb_e16f_7a60_d3b79151a068
  b0b15fe0_203f_b918_96d1_c0450665429c["on_chain_error()"]
  b0b15fe0_203f_b918_96d1_c0450665429c -->|calls| ddaf4521_92bb_e16f_7a60_d3b79151a068
  3a243d21_72d1_dca9_f7be_acbb482b9f86["ahandle_event()"]
  ddaf4521_92bb_e16f_7a60_d3b79151a068 -->|calls| 3a243d21_72d1_dca9_f7be_acbb482b9f86
  07a4c44a_3cfb_9b0a_ffde_c1bbfeb4080a["on_chain_error()"]
  ddaf4521_92bb_e16f_7a60_d3b79151a068 -->|calls| 07a4c44a_3cfb_9b0a_ffde_c1bbfeb4080a
  style ddaf4521_92bb_e16f_7a60_d3b79151a068 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

libs/core/langchain_core/callbacks/manager.py lines 988–1011

    async def on_chain_error(
        self,
        error: BaseException,
        **kwargs: Any,
    ) -> None:
        """Run when chain errors.

        Args:
            error: The error.
            **kwargs: Additional keyword arguments.

        """
        if not self.handlers:
            return
        await ahandle_event(
            self.handlers,
            "on_chain_error",
            "ignore_chain",
            error,
            run_id=self.run_id,
            parent_run_id=self.parent_run_id,
            tags=self.tags,
            **kwargs,
        )