acall() — langchain Function Reference

Architecture documentation for the acall() function in base.py from the langchain codebase.

Function python AgentOrchestration ClassicChains calls 1 called by 1

Entity Profile

AgentOrchestration→ ClassicChains→ acall() — langchain Function Reference

Dependency Diagram

graph TD
  db96fd56_b96b_a600_1f9e_fb81937f4570["acall()"]
  f3cef70e_11b0_61c9_7ec0_7308f4b45056["Chain"]
  db96fd56_b96b_a600_1f9e_fb81937f4570 -->|defined in| f3cef70e_11b0_61c9_7ec0_7308f4b45056
  828a059e_0651_7a7b_b6ed_b72325d8ef5f["arun()"]
  828a059e_0651_7a7b_b6ed_b72325d8ef5f -->|calls| db96fd56_b96b_a600_1f9e_fb81937f4570
  3d0312e3_a4c5_8ae3_1487_fac6e14b7ae4["ainvoke()"]
  db96fd56_b96b_a600_1f9e_fb81937f4570 -->|calls| 3d0312e3_a4c5_8ae3_1487_fac6e14b7ae4
  style db96fd56_b96b_a600_1f9e_fb81937f4570 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

libs/langchain/langchain_classic/chains/base.py lines 421–469

    async def acall(
        self,
        inputs: dict[str, Any] | Any,
        return_only_outputs: bool = False,  # noqa: FBT001,FBT002
        callbacks: Callbacks = None,
        *,
        tags: list[str] | None = None,
        metadata: dict[str, Any] | None = None,
        run_name: str | None = None,
        include_run_info: bool = False,
    ) -> dict[str, Any]:
        """Asynchronously execute the chain.

        Args:
            inputs: Dictionary of inputs, or single input if chain expects
                only one param. Should contain all inputs specified in
                `Chain.input_keys` except for inputs that will be set by the chain's
                memory.
            return_only_outputs: Whether to return only outputs in the
                response. If `True`, only new keys generated by this chain will be
                returned. If `False`, both input keys and new keys generated by this
                chain will be returned.
            callbacks: Callbacks to use for this chain run. These will be called in
                addition to callbacks passed to the chain during construction, but only
                these runtime callbacks will propagate to calls to other objects.
            tags: List of string tags to pass to all callbacks. These will be passed in
                addition to tags passed to the chain during construction, but only
                these runtime tags will propagate to calls to other objects.
            metadata: Optional metadata associated with the chain.
            run_name: Optional name for this run of the chain.
            include_run_info: Whether to include run info in the response. Defaults
                to False.

        Returns:
            A dict of named outputs. Should contain all outputs specified in
                `Chain.output_keys`.
        """
        config = {
            "callbacks": callbacks,
            "tags": tags,
            "metadata": metadata,
            "run_name": run_name,
        }
        return await self.ainvoke(
            inputs,
            cast("RunnableConfig", {k: v for k, v in config.items() if k is not None}),
            return_only_outputs=return_only_outputs,
            include_run_info=include_run_info,
        )