Class BaseCallbackHandlerAbstract

Abstract base class for creating callback handlers in the LangChain framework. It provides a set of optional methods that can be overridden in derived classes to handle various events during the execution of a LangChain application.

Hierarchy (view full)

  • BaseCallbackHandlerMethodsClass

Implements

Constructors

constructor

Properties

awaitHandlers ignoreAgent ignoreChain ignoreCustomEvent ignoreLLM ignoreRetriever name raiseError

Methods

copy toJSON toJSONNotImplemented handleAgentAction? handleAgentEnd? handleChainEnd? handleChainError? handleChainStart? handleChatModelStart? handleCustomEvent? handleLLMEnd? handleLLMError? handleLLMNewToken? handleLLMStart? handleRetrieverEnd? handleRetrieverError? handleRetrieverStart? handleText? handleToolEnd? handleToolError? handleToolStart? fromMethods

Constructors

constructor

Properties

awaitHandlers

awaitHandlers: boolean = ...

ignoreAgent

ignoreAgent: boolean = false

ignoreChain

ignoreChain: boolean = false

ignoreCustomEvent

ignoreCustomEvent: boolean = false

ignoreLLM

ignoreLLM: boolean = false

ignoreRetriever

ignoreRetriever: boolean = false

Abstractname

name: string

raiseError

raiseError: boolean = false

Methods

copy

toJSON

toJSONNotImplemented

OptionalhandleAgentAction

  • handleAgentAction(action, runId, parentRunId?, tags?): void | Promise<void>

  • Called when an agent is about to execute an action, with the action and the run ID.

    Parameters

    • action: AgentAction
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns void | Promise<void>

OptionalhandleAgentEnd

  • handleAgentEnd(action, runId, parentRunId?, tags?): void | Promise<void>

  • Called when an agent finishes execution, before it exits. with the final output and the run ID.

    Parameters

    • action: AgentFinish
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns void | Promise<void>

OptionalhandleChainEnd

  • handleChainEnd(outputs, runId, parentRunId?, tags?, kwargs?): any

  • Called at the end of a Chain run, with the outputs and the run ID.

    Parameters

    • outputs: ChainValues
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalkwargs: {
          inputs?: Record<string, unknown>;
      }
      • Optionalinputs?: Record<string, unknown>

    Returns any

OptionalhandleChainError

  • handleChainError(err, runId, parentRunId?, tags?, kwargs?): any

  • Called if a Chain run encounters an error

    Parameters

    • err: any
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalkwargs: {
          inputs?: Record<string, unknown>;
      }
      • Optionalinputs?: Record<string, unknown>

    Returns any

OptionalhandleChainStart

  • handleChainStart(chain, inputs, runId, parentRunId?, tags?, metadata?, runType?, runName?): any

  • Called at the start of a Chain run, with the chain name and inputs and the run ID.

    Parameters

    • chain: Serialized
    • inputs: ChainValues
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • OptionalrunType: string
    • OptionalrunName: string

    Returns any

OptionalhandleChatModelStart

  • handleChatModelStart(llm, messages, runId, parentRunId?, extraParams?, tags?, metadata?, runName?): any

  • Called at the start of a Chat Model run, with the prompt(s) and the run ID.

    Parameters

    • llm: Serialized
    • messages: BaseMessage[][]
    • runId: string
    • OptionalparentRunId: string
    • OptionalextraParams: Record<string, unknown>
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • OptionalrunName: string

    Returns any

OptionalhandleCustomEvent

  • handleCustomEvent(eventName, data, runId, tags?, metadata?): any

  • Parameters

    • eventName: string
    • data: any
    • runId: string
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, any>

    Returns any

OptionalhandleLLMEnd

  • handleLLMEnd(output, runId, parentRunId?, tags?): any

  • Called at the end of an LLM/ChatModel run, with the output and the run ID.

    Parameters

    • output: LLMResult
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleLLMError

  • handleLLMError(err, runId, parentRunId?, tags?): any

  • Called if an LLM/ChatModel run encounters an error

    Parameters

    • err: any
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleLLMNewToken

  • handleLLMNewToken(token, idx, runId, parentRunId?, tags?, fields?): any

  • Called when an LLM/ChatModel in streaming mode produces a new token

    Parameters

    • token: string
    • idx: NewTokenIndices

      idx.prompt is the index of the prompt that produced the token (if there are multiple prompts) idx.completion is the index of the completion that produced the token (if multiple completions per prompt are requested)

    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalfields: HandleLLMNewTokenCallbackFields

    Returns any

OptionalhandleLLMStart

  • handleLLMStart(llm, prompts, runId, parentRunId?, extraParams?, tags?, metadata?, runName?): any

  • Called at the start of an LLM or Chat Model run, with the prompt(s) and the run ID.

    Parameters

    • llm: Serialized
    • prompts: string[]
    • runId: string
    • OptionalparentRunId: string
    • OptionalextraParams: Record<string, unknown>
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • OptionalrunName: string

    Returns any

OptionalhandleRetrieverEnd

  • handleRetrieverEnd(documents, runId, parentRunId?, tags?): any

  • Parameters

    • documents: DocumentInterface<Record<string, any>>[]
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleRetrieverError

  • handleRetrieverError(err, runId, parentRunId?, tags?): any

  • Parameters

    • err: any
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleRetrieverStart

  • handleRetrieverStart(retriever, query, runId, parentRunId?, tags?, metadata?, name?): any

  • Parameters

    • retriever: Serialized
    • query: string
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • Optionalname: string

    Returns any

OptionalhandleText

  • handleText(text, runId, parentRunId?, tags?): void | Promise<void>

  • Parameters

    • text: string
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns void | Promise<void>

OptionalhandleToolEnd

  • handleToolEnd(output, runId, parentRunId?, tags?): any

  • Called at the end of a Tool run, with the tool output and the run ID.

    Parameters

    • output: any
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleToolError

  • handleToolError(err, runId, parentRunId?, tags?): any

  • Called if a Tool run encounters an error

    Parameters

    • err: any
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]

    Returns any

OptionalhandleToolStart

  • handleToolStart(tool, input, runId, parentRunId?, tags?, metadata?, runName?): any

  • Called at the start of a Tool run, with the tool name and input and the run ID.

    Parameters

    • tool: Serialized
    • input: string
    • runId: string
    • OptionalparentRunId: string
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • OptionalrunName: string

    Returns any

StaticfromMethods

Settings

Member Visibility

On This Page

Constructors
Properties
Methods