Class RunnableBranch<RunInput, RunOutput>

Class that represents a runnable branch. The RunnableBranch is initialized with an array of branches and a default branch. When invoked, it evaluates the condition of each branch in order and executes the corresponding branch if the condition is true. If none of the conditions are true, it executes the default branch.

Type Parameters

  • RunInput = any

  • RunOutput = any

Hierarchy

  • Runnable<RunInput, RunOutput>
    • RunnableBranch

Constructors

Properties

branches: Branch<RunInput, RunOutput>[]
default: Runnable<RunInput, RunOutput, BaseCallbackConfig>
lc_runnable: boolean = true

Methods

  • Create a new runnable sequence that runs each individual runnable in series, piping the output of one runnable into another runnable or runnable-like.

    Type Parameters

    • NewRunOutput

    Parameters

    • coerceable: RunnableLike<RunOutput, NewRunOutput>

      A runnable, function, or object whose values are functions or runnables.

    Returns RunnableSequence<RunInput, Exclude<NewRunOutput, Error>>

    A new runnable sequence.

  • Stream all output from a runnable, as reported to the callback system. This includes all inner runs of LLMs, Retrievers, Tools, etc. Output is streamed as Log objects, which include a list of jsonpatch ops that describe how the state of the run has changed in each step, and the final state of the run. The jsonpatch ops can be applied in order to construct state.

    Parameters

    • input: RunInput
    • Optional options: Partial<BaseCallbackConfig>
    • Optional streamOptions: Omit<LogStreamCallbackHandlerInput, "autoClose">

    Returns AsyncGenerator<RunLogPatch, any, unknown>

  • Default implementation of transform, which buffers input and then calls stream. Subclasses should override this method if they can start producing output while input is still being generated.

    Parameters

    Returns AsyncGenerator<RunOutput, any, unknown>

  • Convenience method for instantiating a RunnableBranch from RunnableLikes (objects, functions, or Runnables).

    Each item in the input except for the last one should be a tuple with two items. The first is a "condition" RunnableLike that returns "true" if the second RunnableLike in the tuple should run.

    The final item in the input should be a RunnableLike that acts as a default branch if no other branches match.

    Type Parameters

    • RunInput = any

    • RunOutput = any

    Parameters

    • branches: [...BranchLike<RunInput, RunOutput>[], RunnableLike<RunInput, RunOutput>]

      An array where the every item except the last is a tuple of [condition, runnable] pairs. The last item is a default runnable which is invoked if no other condition matches.

    Returns RunnableBranch<RunInput, RunOutput>

    A new RunnableBranch.

    Example

    import { RunnableBranch } from "langchain/schema/runnable";

    const branch = RunnableBranch.from([
    [(x: number) => x > 0, (x: number) => x + 1],
    [(x: number) => x < 0, (x: number) => x - 1],
    (x: number) => x
    ]);
  • Helper method to transform an Iterator of Input values into an Iterator of Output values, with callbacks. Use this to implement stream() or transform() in Runnable subclasses.

    Type Parameters

    • I

    • O

    Parameters

    • inputGenerator: AsyncGenerator<I, any, unknown>
    • transformer: ((generator, runManager?, options?) => AsyncGenerator<O, any, unknown>)
        • (generator, runManager?, options?): AsyncGenerator<O, any, unknown>
        • Parameters

          Returns AsyncGenerator<O, any, unknown>

    • Optional options: BaseCallbackConfig & {
          runType?: string;
      }

    Returns AsyncGenerator<O, any, unknown>

Generated using TypeDoc